commit 636875e056950a5637ca94c3bbcdc86ab75cbf72
parent 2eb4c0599ebc0350ab4a86044bc60eb07b4dd495
Author: Florian Dold <florian@dold.me>
Date: Thu, 18 Jan 2024 11:05:21 +0100
Merge commit '9c9076cc71df8d308d4c0c9c97507b8d9cd1ce26' as 'subprojects/c-ares'
Diffstat:
459 files changed, 76095 insertions(+), 0 deletions(-)
diff --git a/subprojects/c-ares/.cirrus.yml b/subprojects/c-ares/.cirrus.yml
@@ -0,0 +1,216 @@
+# Copyright (C) The c-ares project and its contributors
+# SPDX-License-Identifier: MIT
+
+env:
+ CIRRUS_CLONE_DEPTH: 1
+ CMAKE_FLAGS: "-DCMAKE_BUILD_TYPE=DEBUG -DCARES_STATIC=ON -DCARES_STATIC_PIC=ON -G Ninja"
+ CMAKE_TEST_FLAGS: "-DCARES_BUILD_TESTS=ON"
+
+task:
+ matrix:
+ - name: "Debian amd64"
+ env:
+ DIST: "DEBIAN"
+ LC_ALL: "C"
+ SCAN_BUILD: "scan-build"
+ MAKE: "make"
+ BUILD_ASAN: "yes"
+ BUILD_UBSAN: "yes"
+ BUILD_VALGRIND: "yes"
+ BUILD_COVERAGE: "yes"
+ BUILD_ANALYZE: "yes"
+ TEST_SYMBOL_VISIBILITY: "yes"
+ container:
+ image: debian:latest
+ - name: "Alpine amd64"
+ env:
+ DIST: "ALPINE"
+ LC_ALL: "C"
+ SCAN_BUILD: "scan-build"
+ MAKE: "make"
+ BUILD_ASAN: "yes"
+ BUILD_UBSAN: "yes"
+ BUILD_VALGRIND: "yes"
+ BUILD_ANALYZE: "yes"
+ TEST_SYMBOL_VISIBILITY: "yes"
+ container:
+ image: alpine:latest
+ - name: "Ubuntu OLD amd64"
+ env:
+ DIST: "UBUNTU"
+ LC_ALL: "C"
+ MAKE: "make"
+ container:
+ image: ubuntu:20.04
+ - name: "Debian arm64"
+ env:
+ DIST: "DEBIAN-ARM"
+ LC_ALL: "C"
+ SCAN_BUILD: "scan-build"
+ MAKE: "make"
+ BUILD_ASAN: "yes"
+ BUILD_UBSAN: "yes"
+ BUILD_ANALYZE: "yes"
+ arm_container:
+ image: debian:latest
+ - name: "FreeBSD amd64"
+ env:
+ DIST: "FREEBSD"
+ SCAN_BUILD: "scan-build"
+ MAKE: "gmake"
+ BUILD_ANALYZE: "yes"
+ TEST_SYMBOL_VISIBILITY: "yes"
+ freebsd_instance:
+ image_family: freebsd-13-2
+ - name: "MacOS"
+ env:
+ DIST: "MACOS"
+ SCAN_BUILD: "/opt/homebrew/opt/llvm/bin/scan-build-py"
+ MAKE: "make"
+ BUILD_ASAN: "yes"
+ BUILD_ANALYZE: "yes"
+ TEST_SYMBOL_VISIBILITY: "yes"
+ macos_instance:
+ image: ghcr.io/cirruslabs/macos-ventura-xcode:latest
+ - name: "iOS"
+ env:
+ DIST: "iOS"
+ MAKE: "make"
+ CMAKE_FLAGS: "-DCMAKE_BUILD_TYPE=DEBUG -DCARES_STATIC=ON -DCARES_STATIC_PIC=ON -DCMAKE_OSX_DEPLOYMENT_TARGET=10.0 -DCMAKE_OSX_ARCHITECTURES=armv7;armv7s;arm64 -G Ninja"
+ CMAKE_TEST_FLAGS: "-DCARES_BUILD_TESTS=OFF"
+ CFLAGS: "-arch armv7 -arch armv7s -arch arm64 -miphoneos-version-min=10.0"
+ CONFIG_OPTS: "--host=arm-apple-darwin10 --disable-tests"
+ macos_instance:
+ image: ghcr.io/cirruslabs/macos-ventura-xcode:latest
+ matrix:
+ - name: "CMAKE"
+ env:
+ BUILD_TYPE: "cmake"
+ - name: "CMAKE HIDE SYMBOLS"
+ only_if: $TEST_SYMBOL_VISIBILITY == 'yes'
+ env:
+ BUILD_TYPE: "cmake"
+ CMAKE_FLAGS: "-DCMAKE_BUILD_TYPE=DEBUG -DCARES_STATIC=OFF -DCARES_SYMBOL_HIDING=ON -G Ninja"
+ - name: "AUTOTOOLS"
+ env:
+ BUILD_TYPE: "autotools"
+ - name: "ASAN"
+ # ASAN on Linux automatically includes Leak Sanitizer
+ # FreeBSD just hangs trying to run tests, think it may be trying to run leak sanitizer
+ only_if: $BUILD_ASAN == 'yes'
+ env:
+ BUILD_TYPE: "asan"
+ CC: "clang"
+ CONFIG_OPTS: "--enable-debug"
+ CFLAGS: "-fsanitize=address"
+ CXXFLAGS: "-fsanitize=address"
+ LDFLAGS: "-fsanitize=address"
+ - name: "UBSAN"
+ # FreeBSD just hangs trying to run tests, think it may be trying to run leak sanitizer
+ only_if: $BUILD_UBSAN == 'yes'
+ env:
+ BUILD_TYPE: "ubsan"
+ CC: "clang"
+ CONFIG_OPTS: "--enable-debug"
+ CFLAGS: "-fsanitize=undefined -fno-sanitize-recover"
+ CXXFLAGS: "-fsanitize=undefined -fno-sanitize-recover"
+ LDFLAGS: "-fsanitize=undefined"
+ - name: "ANALYZE"
+ only_if: $BUILD_ANALYZE == 'yes'
+ env:
+ BUILD_TYPE: "analyze"
+ CC: "clang"
+ SCAN_WRAP: "${SCAN_BUILD} -v --status-bugs"
+ CONFIG_OPTS: "--enable-debug --disable-tests"
+ CMAKE_TEST_FLAGS: "-DCARES_BUILD_TESTS=OFF"
+ - name: "VALGRIND"
+ # FreeBSD just hangs trying to run tests, think it may be trying to run leak sanitizer
+ only_if: $BUILD_VALGRIND == 'yes'
+ env:
+ BUILD_TYPE: "valgrind"
+ TEST_WRAP: "valgrind --leak-check=full"
+ TEST_FILTER: "--gtest_filter=-*Container*:-*LiveSearchANY*"
+ - name: "COVERAGE"
+ only_if: $BUILD_COVERAGE == 'yes'
+ env:
+ BUILD_TYPE: "coverage"
+ CI_NAME: "cirrus-ci"
+ CI_BUILD_NUMBER: "${CIRRUS_TASK_ID}"
+ CI_BUILD_URL: "https://cirrus-ci.com/task/${CIRRUS_TASK_ID}"
+ CI_BRANCH: "${CIRRUS_BRANCH}"
+ CI_PULL_REQUEST: "${CIRRUS_PR}"
+ COVERALLS_REPO_TOKEN: "ENCRYPTED[a46bc6ca908e9e74f102c686cde67cae21d3e792dff46a60e860d1179d9349e8eb5a529132d0effefebdb0dbc3f95810]"
+ CONFIG_OPTS: "--enable-debug --disable-shared --enable-code-coverage --enable-tests"
+
+ install_script:
+ - |
+ case "${DIST}" in
+ ALPINE)
+ apk add cmake samurai gtest-dev autoconf autoconf-archive automake libtool pkgconf make
+ case "${BUILD_TYPE}" in
+ asan|lsan|ubsan)
+ apk add clang17 compiler-rt
+ ;;
+ analyze)
+ apk add clang17 clang17-analyzer compiler-rt
+ ;;
+ valgrind)
+ apk add gcc g++ valgrind
+ ;;
+ *)
+ apk add gcc g++
+ ;;
+ esac
+ ;;
+ UBUNTU|DEBIAN*)
+ export DEBIAN_FRONTEND=noninteractive && \
+ apt-get update && \
+ apt-get install -y cmake ninja-build autoconf automake libtool g++ libgmock-dev pkg-config
+ case "${BUILD_TYPE}" in
+ asan|lsan|ubsan)
+ apt-get install -yq clang
+ ;;
+ analyze)
+ apt-get install -yq clang clang-tools
+ ;;
+ valgrind)
+ apt-get install -yq valgrind
+ ;;
+ coverage)
+ apt-get install -yq lcov git pip
+ pip3 install --break-system-packages --user cpp-coveralls
+ ;;
+ esac
+ ;;
+ FREEBSD)
+ # pkg upgrade -y && \
+ pkg install -y cmake ninja googletest pkgconf
+ case "${BUILD_TYPE}" in
+ asan|analyze|ubsan|lsan)
+ pkg install -y llvm autoconf automake libtool gmake
+ ;;
+ autotools)
+ pkg install -y autoconf automake libtool gmake
+ ;;
+ esac
+ ;;
+ MACOS|iOS)
+ brew update && \
+ brew install ninja cmake googletest
+ case "${BUILD_TYPE}" in
+ asan|ubsan|lsan|analyze)
+ brew install llvm autoconf automake libtool make
+ ;;
+ autotools)
+ brew install autoconf automake libtool make
+ ;;
+ esac
+ ;;
+ esac
+
+ script:
+ - ./ci/build.sh
+ - ./ci/test.sh
+ - if [ "$BUILD_TYPE" = "autotools" -a "$DIST" = "DEBIAN" ]; then ./ci/distcheck.sh ; fi
+ - if [ "$BUILD_TYPE" = "coverage" ]; then ./ci/covupload.sh ; fi
+
diff --git a/subprojects/c-ares/.clang-format b/subprojects/c-ares/.clang-format
@@ -0,0 +1,97 @@
+# Copyright (C) The c-ares project and its contributors
+# SPDX-License-Identifier: MIT
+---
+Language: Cpp
+
+# -------
+# These are the most likely ones you might want to edit
+ColumnLimit: 80
+BracedInitializerIndentWidth: 2
+ContinuationIndentWidth: 2
+ConstructorInitializerIndentWidth: 2
+PPIndentWidth: 2
+IndentWidth: 2
+MaxEmptyLinesToKeep: 2
+TabWidth: 2
+UseTab: Never
+# --------
+
+BasedOnStyle: LLVM
+AlignAfterOpenBracket: Align
+AlignArrayOfStructures: Left
+AlignConsecutiveAssignments:
+ Enabled: true
+ AcrossEmptyLines: false
+ AcrossComments: false
+ AlignCompound: true
+ PadOperators: true
+AlignConsecutiveBitFields: Consecutive
+AlignConsecutiveDeclarations: AcrossEmptyLinesAndComments
+AlignConsecutiveMacros: Consecutive
+AlignEscapedNewlines: Left
+AlignOperands: Align
+AlignTrailingComments:
+ Kind: Always
+ OverEmptyLines: 1
+AllowAllArgumentsOnNextLine: false
+AllowAllParametersOfDeclarationOnNextLine: false
+AllowShortBlocksOnASingleLine: Never
+AllowShortCaseLabelsOnASingleLine: false
+AllowShortEnumsOnASingleLine: false
+AllowShortFunctionsOnASingleLine: None
+AllowShortIfStatementsOnASingleLine: Never
+AllowShortLoopsOnASingleLine: false
+AlwaysBreakAfterReturnType: None
+AlwaysBreakBeforeMultilineStrings: false
+BinPackArguments: true
+BinPackParameters: true
+BitFieldColonSpacing: Both
+BreakBeforeBraces: Custom
+BraceWrapping:
+ AfterCaseLabel: true
+ AfterControlStatement: Never
+ AfterEnum: false
+ AfterFunction: true
+ AfterStruct: false
+ AfterUnion: false
+ AfterExternBlock: false
+ BeforeElse: false
+ BeforeWhile: false
+ SplitEmptyFunction: true
+BreakBeforeBinaryOperators: None
+BreakBeforeTernaryOperators: true
+BreakStringLiterals: true
+Cpp11BracedListStyle: false
+IncludeBlocks: Preserve
+IndentCaseBlocks: true
+IndentCaseLabels: true
+IndentGotoLabels: false
+IndentPPDirectives: AfterHash
+IndentWrappedFunctionNames: true
+InsertBraces: true
+InsertNewlineAtEOF: true
+InsertTrailingCommas: None
+KeepEmptyLinesAtEOF: false
+KeepEmptyLinesAtTheStartOfBlocks: false
+LineEnding: LF
+PackConstructorInitializers: BinPack
+PointerAlignment: Right
+QualifierAlignment: Leave
+ReferenceAlignment: Pointer
+ReflowComments: true
+RemoveBracesLLVM: false
+RemoveParentheses: Leave
+RemoveSemicolon: true
+SeparateDefinitionBlocks: Always
+SortIncludes: Never
+SpaceAfterCStyleCast: false
+SpaceAroundPointerQualifiers: Before
+SpaceBeforeAssignmentOperators: true
+SpaceBeforeCaseColon: false
+SpaceBeforeParens: ControlStatements
+SpaceBeforeSquareBrackets: false
+SpaceInEmptyBlock: false
+SpaceInEmptyParentheses: false
+SpacesBeforeTrailingComments: 2
+SpacesInParens: Never
+SpacesInSquareBrackets: false
diff --git a/subprojects/c-ares/.gitattributes b/subprojects/c-ares/.gitattributes
@@ -0,0 +1 @@
+test/** linguist-vendored
diff --git a/subprojects/c-ares/.github/scripts/codespell-ignore.txt b/subprojects/c-ares/.github/scripts/codespell-ignore.txt
@@ -0,0 +1,13 @@
+# Copyright (C) The c-ares project and its contributors
+#
+# SPDX-License-Identifier: MIT
+aci
+sais
+aas
+acter
+msdos
+statics
+firey
+bre
+ba
+fo
diff --git a/subprojects/c-ares/.github/workflows/codespell.yml b/subprojects/c-ares/.github/workflows/codespell.yml
@@ -0,0 +1,33 @@
+# Copyright (C) The c-ares project and its contributors
+#
+# SPDX-License-Identifier: MIT
+
+name: Codespell
+
+on:
+ push:
+ branches:
+ - main
+ paths:
+ - 'src/**'
+ - 'include/**'
+ pull_request:
+ branches:
+ - main
+ - 'src/**'
+ - 'include/**'
+
+jobs:
+ codespell:
+ runs-on: ubuntu-latest
+ steps:
+ - name: Checkout
+ uses: actions/checkout@v3
+
+ - name: install
+ run: |
+ sudo apt-get update
+ sudo apt-get install codespell
+
+ - name: spellcheck
+ run: codespell -I .github/scripts/codespell-ignore.txt include src
diff --git a/subprojects/c-ares/.github/workflows/coverity.yml b/subprojects/c-ares/.github/workflows/coverity.yml
@@ -0,0 +1,52 @@
+# Copyright (C) The c-ares project and its contributors
+# SPDX-License-Identifier: MIT
+name: coverity
+on:
+ schedule:
+ - cron: "0 10 * * 1" # Mondays at 00:10 UTC
+ push:
+ branches: [ coverity_scan ]
+ workflow_dispatch:
+jobs:
+ build:
+ runs-on: ubuntu-latest
+ steps:
+ - name: Checkout Source
+ uses: actions/checkout@v3
+ with:
+ fetch-depth: 0
+ - name: apt dependencies
+ run: sudo apt-get install cmake ninja-build
+ - name: Download Coverity Build Tool
+ run: |
+ wget -q https://scan.coverity.com/download/cxx/linux64 --post-data "token=$TOKEN&project=c-ares" -O cov-analysis-linux64.tar.gz
+ mkdir cov-analysis-linux64
+ tar xzf cov-analysis-linux64.tar.gz --strip 1 -C cov-analysis-linux64
+ env:
+ TOKEN: ${{ secrets.COVERITY_SCAN_TOKEN }}
+ - name: CMake
+ run: |
+ mkdir build
+ cd build
+ cmake -DCARES_BUILD_TESTS=OFF -G Ninja ..
+ - name: Build with cov-build
+ run: |
+ export PATH=`pwd`/cov-analysis-linux64/bin:$PATH
+ cd build
+ cov-build --dir cov-int ninja
+ - name: Submit the result to Coverity Scan
+ run: |
+ cd build
+ tar czvf c-ares.tgz cov-int
+ curl \
+ --form project=c-ares \
+ --form token=$TOKEN \
+ --form email=$EMAIL \
+ --form file=@c-ares.tgz \
+ --form version=main \
+ --form description="c-ares" \
+ https://scan.coverity.com/builds?project=c-ares
+ env:
+ TOKEN: ${{ secrets.COVERITY_SCAN_TOKEN }}
+ EMAIL: ${{ secrets.COVERITY_SCAN_EMAIL }}
+
diff --git a/subprojects/c-ares/.github/workflows/reuse.yml b/subprojects/c-ares/.github/workflows/reuse.yml
@@ -0,0 +1,28 @@
+# SPDX-FileCopyrightText: 2022 Free Software Foundation Europe e.V. <https://fsfe.org>
+#
+# SPDX-License-Identifier: MIT
+
+name: REUSE compliance
+
+on:
+ push:
+ branches:
+ - main
+ - '*/ci'
+ pull_request:
+ branches:
+ - main
+
+concurrency:
+ group: ${{ github.workflow }}-${{ github.event.pull_request.number || github.sha }}
+ cancel-in-progress: true
+
+permissions: {}
+
+jobs:
+ check:
+ runs-on: ubuntu-latest
+ steps:
+ - uses: actions/checkout@v3
+ - name: REUSE Compliance Check
+ uses: fsfe/reuse-action@v1
diff --git a/subprojects/c-ares/.github/workflows/sonarcloud.yml b/subprojects/c-ares/.github/workflows/sonarcloud.yml
@@ -0,0 +1,37 @@
+# Copyright (C) The c-ares project and its contributors
+# SPDX-License-Identifier: MIT
+name: SonarCloud
+on:
+ push:
+ branches:
+ - main
+# pull_request:
+# types: [opened, synchronize, reopened]
+jobs:
+ build:
+ name: Build and analyze
+ runs-on: ubuntu-latest
+ env:
+ BUILD_WRAPPER_OUT_DIR: build_wrapper_output_directory # Directory where build-wrapper output will be placed
+ steps:
+ - uses: actions/checkout@v3
+ with:
+ fetch-depth: 0 # Shallow clones should be disabled for a better relevancy of analysis
+ - name: Install sonar-scanner and build-wrapper
+ uses: SonarSource/sonarcloud-github-c-cpp@v2
+ - uses: awalsh128/cache-apt-pkgs-action@latest
+ with:
+ packages: libgmock-dev
+ version: 1.0
+ - name: Run build-wrapper
+ run: |
+ mkdir build
+ cmake -DCARES_BUILD_TESTS=ON -S . -B build
+ build-wrapper-linux-x86-64 --out-dir ${{ env.BUILD_WRAPPER_OUT_DIR }} cmake --build build/ --config Release
+ - name: Run sonar-scanner
+ env:
+ GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+ SONAR_TOKEN: ${{ secrets.SONAR_TOKEN }}
+ run: |
+ sonar-scanner --define sonar.cfamily.build-wrapper-output="${{ env.BUILD_WRAPPER_OUT_DIR }}"
+
diff --git a/subprojects/c-ares/.github/workflows/watcom.yml b/subprojects/c-ares/.github/workflows/watcom.yml
@@ -0,0 +1,29 @@
+# Copyright (C) The c-ares project and its contributors
+# SPDX-License-Identifier: MIT
+name: OpenWatcom
+on:
+ push:
+ branches:
+ - main
+ pull_request:
+ branches:
+ - main
+jobs:
+ build:
+ runs-on: windows-latest
+ steps:
+ - uses: open-watcom/setup-watcom@v0
+ - name: Checkout Source
+ uses: actions/checkout@v3
+ with:
+ fetch-depth: 0
+ - name: configure
+ run: buildconf.bat
+ shell: cmd
+ - name: Build c-ares
+ run: |
+ wmake -u -f Makefile.Watcom
+ - name: distclean
+ run: |
+ wmake -u -f Makefile.Watcom clean
+
diff --git a/subprojects/c-ares/.gitignore b/subprojects/c-ares/.gitignore
@@ -0,0 +1,69 @@
+.deps
+.libs
+*.lib
+*.pdb
+*.dll
+*.exe
+*.obj
+*.map
+.*.swp
+Debug
+Release
+*.exp
+Makefile
+Makefile.in
+aclocal.m4
+autom4te.cache
+config.guess
+config.log
+config.status
+config.sub
+configure
+depcomp
+libtool
+ltmain.sh
+compile
+libcares.pc
+missing
+test-driver
+c-ares-*.tar.gz
+INSTALL
+install-sh
+*.a
+*.o
+*.lo
+*.la
+*.gcno
+*.gcda
+*.gcov
+c-ares---coverage.info
+c-ares---coverage
+mkinstalldirs
+tags
+TAGS
+*~
+aclocal.m4.bak
+acountry
+adig
+ahost
+ares_build.h
+ares_config.h
+ares_config.h.in
+stamp-h1
+stamp-h2
+ares_*pdf
+CHANGES.dist
+c-ares-*.tar.gz.asc
+ares_parse_mx_reply.pdf
+/[0-9]*.patch
+build
+bin/
+CMakeFiles/
+CMakeCache.txt
+CPackConfig.cmake
+CPackSourceConfig.cmake
+c-ares-config.cmake
+c-ares-config-version.cmake
+Makefile.inc.cmake
+cmake_install.cmake
+aminclude_static.am
diff --git a/subprojects/c-ares/.reuse/dep5 b/subprojects/c-ares/.reuse/dep5
@@ -0,0 +1,32 @@
+Format: https://www.debian.org/doc/packaging-manuals/copyright-format/1.0/
+Upstream-Name: c-ares
+Upstream-Contact: The c-ares team <c-ares@lists.haxx.se>
+Source: https://c-ares.org/
+
+# Fuzzer data
+Files: test/fuzzinput/* test/fuzznames/*
+Copyright: The c-ares project and its contributors.
+License: MIT
+
+# Docs
+Files: AUTHORS CHANGES CHANGES.0 CONTRIBUTING.md GIT-INFO NEWS README.cares README.md README.msvc RELEASE-NOTES RELEASE-PROCEDURE.md SECURITY.md TODO INSTALL.md test/README.md test/gmock-1.11.0/README.md
+Copyright: The c-ares project and its contributors.
+License: MIT
+
+# dotfiles
+Files: .gitignore .gitattributes m4/.gitignore test/.gitignore
+Copyright: The c-ares project and its contributors.
+License: MIT
+
+# Imported m4 files
+Files: m4/ax_pthread.m4 m4/ax_compiler_vendor.m4
+Copyright: see file
+License: GPL-3.0-or-later WITH Autoconf-exception-3.0
+
+Files: m4/ax_cxx_compile_stdcxx.m4 m4/ax_cxx_compile_stdcxx_14.m4 me/ax_require_defined.m4 m4/ax_check_gnu_make.m4 m4/ax_file_escapes.m4 m4/ax_require_defined.m4 m4/ax_ac_append_to_file.m4 m4/ax_ac_print_to_file.m4 m4/ax_add_am_macro_static.m4 m4/ax_file_escapes.m4 m4/ax_am_macros_static.m4 m4/ax_append_flag.m4 m4/ax_append_compile_flags.m4 m4/ax_check_compile_flag.m4 m4/ax_append_link_flags.m4 m4/ax_check_link_flag.m4
+Copyright: see files
+License: FSFAP
+
+Files: m4/ax_code_coverage.m4 m4/pkg.m4
+Copyright: see file
+License: LGPL-2.1-or-later
diff --git a/subprojects/c-ares/.travis.yml b/subprojects/c-ares/.travis.yml
@@ -0,0 +1,130 @@
+# Copyright (C) The c-ares project and its contributors
+# SPDX-License-Identifier: MIT
+
+language: c++
+dist: bionic
+sudo: false
+addons:
+ apt:
+ packages:
+ - cmake
+ - lcov
+ - clang-tools-7
+ - valgrind
+
+matrix:
+ include:
+ - os: linux
+ compiler: gcc
+ env: BUILD_TYPE=normal
+ - os: linux
+ compiler: clang
+ env: BUILD_TYPE=normal
+ - os: linux
+ compiler: gcc
+ env: BUILD_TYPE=cmake
+ - os: linux
+ compiler: clang
+ env: BUILD_TYPE=cmake
+ - os: linux
+ compiler: gcc
+ env: BUILD_TYPE=coverage
+ - os: linux
+ compiler: clang
+ env: BUILD_TYPE=ubsan
+ - os: linux
+ compiler: clang
+ env: BUILD_TYPE=asan
+ - os: linux
+ compiler: clang
+ env: BUILD_TYPE=lsan
+ - os: linux
+ compiler: clang
+ env: BUILD_TYPE=analyze
+ - os: linux
+ compiler: gcc
+ env: BUILD_TYPE=valgrind
+ - os: osx
+ osx_image: xcode11.4
+ compiler: gcc
+ env: BUILD_TYPE=normal
+ - os: osx
+ osx_image: xcode11.4
+ compiler: clang
+ env: BUILD_TYPE=normal
+ - os: osx
+ osx_image: xcode11.4
+ compiler: clang
+ env: BUILD_TYPE=cmake
+ - os: osx
+ osx_image: xcode11.4
+ compiler: clang
+ language: objective-c
+ env: BUILD_TYPE=ios
+ - os: osx
+ osx_image: xcode11.4
+ compiler: clang
+ language: objective-c
+ env: BUILD_TYPE=ios-cmake
+install:
+ - if [ "$TRAVIS_OS_NAME" != "osx" ]; then pip install --user cpp-coveralls > /dev/null; fi
+ - if [ "$TRAVIS_OS_NAME" == "osx" ]; then brew reinstall libtool > /dev/null; fi
+before_script:
+ - |
+ if [ "$BUILD_TYPE" = "coverage" ]; then
+ export CONFIG_OPTS="--enable-debug --disable-shared --enable-code-coverage --enable-tests"
+ fi
+ - |
+ if [ "$BUILD_TYPE" = "asan" ]; then
+ export CONFIG_OPTS=--enable-debug
+ export CFLAGS=-fsanitize=address
+ export CXXFLAGS=-fsanitize=address
+ export LDFLAGS=-fsanitize=address
+ fi
+ - |
+ if [ "$BUILD_TYPE" = "lsan" ]; then
+ export CONFIG_OPTS=--enable-debug
+ export CFLAGS=-fsanitize=leak
+ export CXXFLAGS=-fsanitize=leak
+ export LDFLAGS=-fsanitize=leak
+ fi
+ - |
+ if [ "$BUILD_TYPE" = "ubsan" ]; then
+ export CFLAGS="-fsanitize=undefined -fno-sanitize-recover"
+ export LDFLAGS="-fsanitize=undefined"
+ fi
+ - |
+ if [ "$BUILD_TYPE" = "analyze" ]; then
+ export SCAN_WRAP="scan-build-7 --status-bugs"
+ export CONFIG_OPTS="--enable-debug --disable-tests"
+ export CXX="clang++-7"
+ export CC="clang-7"
+ fi
+ - |
+ if [ "$BUILD_TYPE" = "valgrind" ]; then
+ export TEST_WRAP='valgrind --leak-check=full'
+ # Skip container tests as valgrind doesn't cope with clone()
+ export TEST_FILTER="--gtest_filter=-*Container*:-*LiveSearchANY*"
+ fi
+ - |
+ if [ "$BUILD_TYPE" = "ios" ]; then
+ export CONFIG_OPTS="--host=arm-apple-darwin10 --disable-tests"
+ export DEVPATH=`xcode-select -print-path`/Platforms/iPhoneOS.platform/Developer
+ export IOSFLAGS="-isysroot $DEVPATH/SDKs/iPhoneOS.sdk -arch armv7 -miphoneos-version-min=8.0.0"
+ export CFLAGS=$IOSFLAGS
+ export CXXFLAGS=$IOSFLAGS
+ export LDFLAGS=$IOSFLAGS
+ fi
+ - |
+ if [ "$BUILD_TYPE" = "ios-cmake" ]; then
+ export SYSROOT="$(xcode-select -print-path)/Platforms/iPhoneOS.platform/Developer/SDKs/iPhoneOS.sdk/"
+ export IOSFLAGS="-miphoneos-version-min=10.0"
+ export ARCHITECTURES="armv7;armv7s;arm64"
+ export CFLAGS=$IOSFLAGS
+ export CXXFLAGS=$IOSFLAGS
+ export LDFLAGS=$IOSFLAGS
+ fi
+script:
+ - ./ci/build.sh && ./ci/test.sh
+ - if [ "$BUILD_TYPE" = "normal" ]; then ./ci/distcheck.sh ; fi
+ - if [ "$BUILD_TYPE" = "coverage" ]; then ./ci/covupload.sh ; fi
diff --git a/subprojects/c-ares/AUTHORS b/subprojects/c-ares/AUTHORS
@@ -0,0 +1,84 @@
+c-ares is based on ares, and these are the people that have worked on it since
+the fork was made:
+
+Albert Chin
+Alex Loukissas
+Alexander Klauer
+Alexander Lazic
+Alexey Simak
+Andreas Rieke
+Andrew Andkjar
+Andrew Ayer
+Andrew C. Morrow
+Ashish Sharma
+Ben Greear
+Ben Noordhuis
+BogDan Vatra
+Brad House
+Brad Spencer
+Bram Matthys
+Chris Araman
+Dan Fandrich
+Daniel Johnson
+Daniel Stenberg
+David Drysdale
+David Stuart
+Denis Bilenko
+Dima Tisnek
+Dirk Manske
+Dominick Meglio
+Doug Goldstein
+Doug Kwan
+Duncan Wilcox
+Eino Tuominen
+Erik Kline
+Fedor Indutny
+Frederic Germain
+Geert Uytterhoeven
+George Neill
+Gisle Vanem
+Google LLC
+Gregor Jasny
+Guenter Knauf
+Guilherme Balena Versiani
+Gunter Knauf
+Henrik Stoerner
+Jakub Hrozek
+James Bursa
+Jérémy Lal
+John Schember
+Keith Shaw
+Lei Shi
+Marko Kreen
+Michael Wallner
+Mike Crowe
+Nick Alcock
+Nick Mathewson
+Nicolas "Pixel" Noble
+Ning Dong
+Oleg Pudeyev
+Patrick Valsecchi
+Patrik Thunstrom
+Paul Saab
+Peter Pentchev
+Phil Blundell
+Poul Thomas Lomholt
+Ravi Pratap
+Robin Cornelius
+Saúl Ibarra Corretgé
+Sebastian at basti79.de
+Shmulik Regev
+Stefan Bühler
+Steinar H. Gunderson
+Svante Karlsson
+Tofu Linden
+Tom Hughes
+Tor Arntsen
+Viktor Szakats
+Vlad Dinulescu
+William Ahern
+Yang Tse
+hpopescu at ixiacom.com
+liren at vivisimo.com
+nordsturm
+saghul
diff --git a/subprojects/c-ares/CHANGES b/subprojects/c-ares/CHANGES
@@ -0,0 +1,7 @@
+This file no longer holds the changelog. Now you can generate it yourself
+like this:
+
+ $ git log --pretty=fuller --no-color --date=short --decorate=full -1000 |
+ ./git2changes.pl
+
+The older, manually edited, changelog is found in git named CHANGES.0
diff --git a/subprojects/c-ares/CHANGES.0 b/subprojects/c-ares/CHANGES.0
@@ -0,0 +1,1218 @@
+ Changelog for the c-ares project
+
+Version 1.7.5 (August 16, 2011)
+
+Fixed:
+
+ o detection of semicolon comments in resolv.conf
+ o avoid using system's inet_net_pton affected by the WLB-2008080064 advisory
+ o replacement ares_inet_net_pton affected by the WLB-2008080064 advisory
+ o replacement ares_inet_ntop affected by potential out of bounds write
+ o added install target to Makefile.msvc
+ o only fall back to AF_INET searches when looking for AF_UNSPEC addresses
+ o fixed ares_parse_*_reply memory leaks
+ o Use correct sizeof in ares_getnameinfo()
+ o IPv6-on-windows: find DNS servers correctly
+ o man pages: docs for the c-ares utility programs
+ o getservbyport replacement for Win CE
+ o config_sortlist: (win32) missing else
+ o advance_tcp_send_queue: avoid NULL ptr dereference
+ o configure: fix a bashism
+ o ares_expand_name: Fix encoded length for indirect root
+
+Version 1.7.4 (December 9, 2010)
+
+Changed:
+
+ o local-bind: Support binding to local interface/IPs, see
+ ares_set_local_ip4, ares_set_local_ip6, ares_set_local_dev
+
+Fixed:
+
+ o memory leak in ares_getnameinfo
+ o add missing break that caused get_ares_servers to fail
+ o ares_parse_a_reply: fix CNAME response parsing
+ o init_by_options: don't copy an empty sortlist
+ o Replaced uint32_t with unsigned int to fix broken builds
+ on a couple of platforms
+ o Fix lookup with HOSTALIASES set
+ o adig: fix NAPTR parsing
+ o compiler warning cleanups
+
+Version 1.7.3 (June 11, 2010)
+
+Fixed:
+
+ o builds on Android
+ o now includes all files necessary to build it (1.7.2 lacked a file)
+
+Version 1.7.2 (June 10, 2010)
+
+Changed:
+
+ o Added ares_parse_mx_reply()
+
+Fixed:
+
+ o ares_init: Last, not first instance of domain or search should win
+ o improve alternative definition of bool
+ o fix VS2010 compiler warnings
+
+
+Version 1.7.1 (Mar 23, 2010)
+
+* May 31, 2010 (Jakub Hrozek)
+- Use the last instance of domain/search, not the first one
+
+* March 23, 2010 (Daniel Stenberg)
+- We switched from CVS to git. See http://github.com/bagder/c-ares
+
+* March 5, 2010 (Daniel Stenberg)
+- Daniel Johnson provided fixes for building with the clang compiler.
+
+* March 5, 2010 (Yang Tse)
+- Added IPv6 name servers support. Implementation has been based on code,
+ comments and feedback provided November and December of 2008 by Daniel
+ Stenberg, Gregor Jasny, Phil Blundell and myself, December 2009 by Cedric
+ Bail, and February 2010 by Jakub Hrozek on the c-ares mailing list. On
+ March I reviewed all that, selected the best of each, and adjusted or
+ extended parts of it to make the best fit.
+
+ The external and visible result of all this is that two new functions are
+ added to the external API, ares_get_servers() and ares_set_servers(), which
+ becomes now the preferred way of getting and setting name servers for any
+ ares channel as these support both IPv4 and IPv6 name servers.
+
+ In order to not break ABI compatibility, ares_init_options() with option
+ mask ARES_OPT_SERVERS and ares_save_options() may still be used in code
+ which is intended to run on IPv4-only stacks. But remember that these
+ functions do not support IPv6 name servers. This implies that if the user
+ is capable of defining or providing an IPv6 name server, and the app is
+ using ares_init_options() or ares_save_options() at some point to handle
+ the name servers, the app will likely lose IPv6 name servers.
+
+* January 28, 2010 (Daniel Stenberg)
+- Tommie Gannert pointed out a silly bug in ares_process_fd() since it didn't
+ check for broken connections like ares_process() did. Based on that, I
+ merged the two functions into a single generic one with two front-ends.
+
+* December 29, 2009 (Yang Tse)
+- Laszlo Tamas Szabo adjusted Makefile.msvc compiler options so that where
+ run-time error checks enabling compiler option /GZ was used it is replaced
+ with equivalent /RTCsu for Visual Studio 2003 and newer versions. Option
+ /GX is replaced with equivalent /EHsc for all versions. Also fixed socket
+ data type for internal configure_socket function.
+
+* December 21, 2009 (Yang Tse)
+- Ingmar Runge noticed that Windows config-win32.h configuration file
+ did not include a definition for HAVE_CLOSESOCKET which resulted in
+ function close() being inappropriately used to close sockets.
+
+Version 1.7.0 (Nov 30, 2009)
+
+* November 26, 2009 (Yang Tse)
+- Larry Lansing fixed ares_parse_srv_reply to properly parse replies
+ which might contain non-SRV answers, skipping over potential non-SRV
+ ones such as CNAMEs.
+
+* November 23, 2009 (Yang Tse)
+- Changed naming convention for c-ares libraries built with MSVC, details
+ and build instructions provided in README.msvc file.
+
+* November 22, 2009 (Yang Tse)
+- Jakub Hrozek fixed more function prototypes in man pages to sync them
+ with the ones declared in ares.h
+
+- Jakub Hrozek renamed addrttl and addr6ttl structs to ares_addrttl and
+ ares_addr6ttl in order to prevent name space pollution, along with
+ necessary changes to code base and man pages.This change does not break
+ ABI, there is no need to recompile existing applications. But existing
+ applications using these structs with the old name will need source code
+ adjustments when recompiled using c-ares 1.7.0.
+
+* November 21, 2009 (Yang Tse)
+- Added manifest stuff to Makefile.msvc.
+
+* November 20, 2009 (Yang Tse)
+- Fixed several function prototypes in man pages that were out of sync
+ with the ones declared in ares.h. Added ares_free_data() along with
+ man page. Updated ares_parse_srv_reply() and ares_parse_txt_reply()
+ with changes from Jakub Hrozek making these now return linked lists
+ instead of arrays, and merging the ares_free_data() adjustments.
+
+* November 10, 2009 (Yang Tse)
+- Updated MSVC 6.0 project files to match settings from Makefile.msvc.
+
+* November 9, 2009 (Yang Tse)
+- Makefile.msvc is now the reference method to build c-ares and sample
+ programs with any MSVC compiler or MS Visual Studio version. If no
+ option or target are specified it builds dynamic and static c-ares
+ libraries in debug and release flavours and also builds all sample
+ programs using each of the different c-ares libraries.
+
+* November 2, 2009 (Yang Tse)
+- Renamed c-ares setup.h to ares_setup.h
+
+* October 31, 2009 (Yang Tse)
+- Symbol hiding configure options are named now --enable-symbol-hiding
+ and --disable-symbol-hiding in an attempt to make them less ambiguous.
+
+* October 30, 2009 (Yang Tse)
+- Many fixes for ares_parse_txt_reply()
+
+* October 29, 2009 (Daniel Stenberg)
+- Jakub Hrozek added ares_parse_txt_reply() for TXT parsing
+
+* October 29, 2009 (Yang Tse)
+- Updated MSVC 6.0 workspace and project files that allows building
+ dynamic and static c-ares libraries in debug and release flavours.
+ Additionally each of the three sample programs is built against
+ each of the four possible c-ares libraries, generating all this
+ a total number of 12 executables and 4 libraries.
+
+* October 28, 2009 (Yang Tse)
+- Initial step towards the ability to reduce c-ares exported symbols
+ when built as a shared library based on the 'visibility' attribute
+ for GNUC and Intel compilers and based on __global for Sun compilers,
+ taking also in account __declspec function decoration for Win32 and
+ Symbian DLL's.
+
+* October 27, 2009 (Yang Tse)
+- Fixed Pelles C Win32 target compilation issues.
+
+* October 23, 2009 (Yang Tse)
+- John Engelhart noticed an unreleased problem relative to a duplicate
+ ARES_ECANCELLED error code value and missing error code description.
+
+* October 7, 2009 (Yang Tse)
+- Overhauled ares__get_hostent() Fixing out of bounds memory overwrite
+ triggered with malformed /etc/hosts file. Improving parsing of /etc/hosts
+ file. Validating requested address family. Ensuring that failures always
+ return a NULL pointer. Adjusting header inclusions.
+
+* October 6, 2009 (Yang Tse)
+- Fix ssize_t redefinition errors on WIN64 reported by Alexey Simak.
+
+* September 29, 2009 (Yang Tse)
+- Make configure script also check if _REENTRANT definition is required to
+ make errno available as a preprocessor macro.
+
+* September 7, 2009 (Yang Tse)
+- Add T_SRV portability check to ares_parse_srv_reply.c
+
+* 4 Sep 2009 (Daniel Stenberg)
+- Jakub Hrozek added ares_parse_srv_reply() for SRV parsing
+
+* 3 Aug 2009 (Daniel Stenberg)
+- Joshua Kwan fixed the init routine to fill in the defaults for stuff that
+ fails to get inited by other means. This fixes a case of when the c-ares
+ init fails when internet access is fone.
+
+- Timo Teras changed the reason code used in the resolve callback done when
+ ares_cancel() is used, to be ARES_ECANCELLED instead of ARES_ETIMEOUT to
+ better allow the callback to know what's happening.
+
+* 14 Jul 2009 (Guenter Knauf)
+- renamed generated config.h to ares_config.h to avoid any future clashes
+ with config.h from other projects.
+
+* June 20 2009 (Yang Tse)
+- Refactor how libraries are checked for connect() function in configure
+ script and check for connect() as it is done for other functions.
+
+* June 19 2009 (Yang Tse)
+- Make sclose() function-like macro definition used to close a socket,
+ now solely based on HAVE_CLOSESOCKET and HAVE_CLOSESOCKET_CAMEL
+ config file preprocessor definitions
+
+* June 18 2009 (Yang Tse)
+- Add CloseSocket camel case function check for configure script.
+
+* June 17 2009 (Yang Tse)
+- Check for socket() and closesocket() as it is done for other functions
+ in configure script.
+
+* June 11 2009 (Yang Tse)
+- Modified buildconf so that when automake runs it copies missing files
+ instead of symlinking them.
+
+* June 8 2009 (Yang Tse)
+- Removed buildconf.bat from release and daily snapshot archives. This
+ file is only for CVS tree checkout builds.
+
+* May 26 2009 (Yang Tse)
+- Added --enable-curldebug configure option to enable and disable building
+ with the low-level curl debug memory tracking 'feature' to allow decoupled
+ setting from --enable-debug, allowing again to build c-ares independently
+ out of the CVS tree.
+
+ For the c-ares library option --enable-debug enables debug build features
+ which are _not_ related with memory tracking. For the c-ares library when
+ --enable-debug is given it does not enable the memory tracking feature. If
+ you wish to enable the curl debug memory tracking you must use configure
+ option --enable-curldebug explicitly to do so.
+
+ Internally, definition of preprocessor symbol DEBUGBUILD restricts code
+ which is only compiled for debug enabled builds. And symbol CURLDEBUG is
+ used to differentiate code which is _only_ used for memory tracking.
+
+ Make ares_init(), ares_dup() and ares_init_options() fail returning
+ ARES_ENOTINITIALIZED if library initialization has not been performed
+ calling ares_library_init().
+
+* May 20 2009 (Yang Tse)
+- Added ares_library_init() and ares_library_cleanup() man pages.
+
+* May 19 2009 (Yang Tse)
+- Introduced ares_library_init() and ares_library_cleanup() functions.
+
+ This is an API and ABI break for Win32/64 systems. Non-Win32/64 build targets
+ using c-ares 1.7.0 can still survive without calling these functions. Read all
+ the details on ares_library_init(3) and ares_library_cleanup(3) man pages that
+ are included.
+
+ curl/libcurl 7.19.5 is fully compatible with c-ares 1.7.0 on all systems.
+
+ In order to use c-ares 1.7.0 with curl/libcurl on Win32/64 systems it is
+ required that curl/libcurl is 7.19.5 or newer. In other words, it is not
+ possible on Win32/64 to use c-ares 1.7.0 with a curl/libcurl version less
+ than 7.19.5
+
+* May 11 2009 (Daniel Stenberg)
+- Gregor Jasny made c-ares link with libtool 's -export-symbols-regex option to
+ only expose functions starting with ares_.
+
+* May 7 2009 (Yang Tse)
+- Fix an m4 overquoting triggering a spurious 'AS_TR_CPP' symbol definition
+ attempt in generated config.h
+
+* May 2 2009 (Yang Tse)
+- Use a build-time configured ares_socklen_t data type instead of socklen_t.
+
+* April 21 2009 (Yang Tse)
+- Moved potential inclusion of system's malloc.h and memory.h header files to
+ setup_once.h. Inclusion of each header file is based on the definition of
+ NEED_MALLOC_H and NEED_MEMORY_H respectively.
+
+* March 11 2009 (Yang Tse)
+- Japheth Cleaver fixed acountry.c replacing u_long with unsigned long.
+
+* February 20 2009 (Yang Tse)
+- Do not halt compilation when using VS2008 to build a Windows 2000 target.
+
+* February 3 2009 (Phil Blundell)
+- If the server returns garbage or nothing at all in response to an AAAA query,
+ go on and ask for A records anyway.
+
+* January 31 2009 (Daniel Stenberg)
+- ares_gethostbyname() now accepts 'AF_UNSPEC' as a family for resolving
+ either AF_INET6 or AF_INET. It works by accepting any of the looksups in the
+ hosts file, and it resolves the AAAA field with a fallback to A.
+
+* January 14 2009 (Daniel Stenberg)
+- ares.h no longer uses the HAVE_STRUCT_IN6_ADDR define check, but instead it
+ now declares the private struct ares_in6_addr for all systems instead of
+ relying on one possibly not present in the system.
+
+* January 13 2009 (Phil Blundell)
+- ares__send_query() now varies the retry timeout pseudo-randomly to avoid
+ packet storms when several queries were started at the same time.
+
+* January 11 2009 (Daniel Stenberg)
+- Phil Blundell added the internal function ares__expand_name_for_response()
+ that is now used by the ares_parse_*_reply() functions instead of the
+ ares_expand_name() simply to easier return ARES_EBADRESP for the cases where
+ the name expansion fails as in responses that really isn't expected.
+
+Version 1.6.0 (Dec 9, 2008)
+
+* December 9 2008 (Gisle Vanem)
+
+ Fixes for Win32 targets using the Watt-32 tcp/ip stack.
+
+* Dec 4 2008 (Daniel Stenberg)
+
+ Gregor Jasny provided the patch that introduces ares_set_socket_callback(),
+ and I edited it to also get duped by ares_dup().
+
+* Dec 3 2008 (Daniel Stenberg)
+
+ API changes:
+
+ I made sure the public ares_config struct looks like before and yet it
+ supports the ROTATE option thanks to c-ares now storing the "optmask"
+ internally. Thus we should be ABI compatible with the past release(s)
+ now. My efforts mentioned below should not break backwards ABI compliance.
+
+ Here's how I suggest we proceed with the API:
+
+ ares_init() will be primary "channel creator" function.
+
+ ares_init_options() will continue to work exactly like now and before. For
+ starters, it will be the (only) way to set the existing options.
+
+ ares_save_options() will continue to work like today, but will ONLY save
+ options that you can set today (including ARES_OPT_ROTATE actually) but new
+ options that we add may not be saved with this.
+
+ Instead we introduce:
+
+ ares_dup() that instead can make a new channel and clone the config used
+ from an existing channel. It will then clone all config options, including
+ future new things we add.
+
+ ares_set_*() style functions that set (new) config options. As a start we
+ simply add these for new functionality, but over time we can also introduce
+ them for existing "struct ares_options" so that we can eventually deprecate
+ the two ares_*_options() functions.
+
+ ares_get_*() style functions for extracting info from a channel handle that
+ should be used instead of ares_save_options().
+
+* Nov 26 2008 (Yang Tse)
+- Brad Spencer provided changes to allow buildconf to work on OS X.
+
+- Gerald Combs fixed a bug in ares_parse_ptr_reply() which would cause a
+ buffer to shrink instead of expand if a reply contained 8 or more records.
+
+* Nov 25 2008 (Yang Tse)
+- In preparation for the upcoming IPv6 nameservers patch, the internal
+ ares_addr union is now changed into an internal struct which also holds
+ the address family.
+
+* Nov 19 2008 (Daniel Stenberg)
+- Brad Spencer brought the new function ares_gethostbyname_file() which simply
+ resolves a host name from the given file, using the regular hosts syntax.
+
+* Nov 1 2008 (Daniel Stenberg)
+- Carlo Contavalli added support for the glibc "rotate" option, as documented
+ in man resolv.conf:
+
+ causes round robin selection of nameservers from among those listed. This
+ has the effect of spreading the query load among all listed servers, rather
+ than having all clients try the first listed server first every time.
+
+ You can enable it with ARES_OPT_ROTATE
+
+* Oct 21 2008 (Yang Tse)
+ Charles Hardin added handling of EINPROGRESS for UDP connects.
+
+* Oct 18 2008 (Daniel Stenberg)
+ Charles Hardin made adig support a regular numerical dotted IP address for the
+ -s option as well.
+
+* Oct 7 2008 (Yang Tse)
+- Added --enable-optimize configure option to enable and disable compiler
+ optimizations to allow decoupled setting from --enable-debug.
+
+* Oct 2 2008 (Yang Tse)
+- Added --enable-warnings configure option to enable and disable strict
+ compiler warnings to allow decoupled setting from --enable-debug.
+
+* Sep 17 2008 (Yang Tse)
+- Code reorganization to allow internal/private use of "nameser.h" to any
+ system that lacks arpa/nameser.h or arpa/nameser_compat.h header files.
+
+* Sep 16 2008 (Yang Tse)
+- Code reorganization to allow internal/private use of ares_writev to any
+ system that lacks the writev function.
+
+* Sep 15 2008 (Yang Tse)
+- Code reorganization to allow internal/private use of ares_strcasecmp to any
+ system that lacks the strcasecmp function.
+
+- Improve configure detection of some string functions.
+
+* Sep 11 2008 (Yang Tse)
+- Code reorganization to allow internal/private use of ares_strdup to any
+ system that lacks the strdup function.
+
+Version 1.5.3 (Aug 29, 2008)
+
+* Aug 25 2008 (Yang Tse)
+- Improvement by Brad House:
+
+ This patch addresses an issue in which a response could be sent back to the
+ source port of a client from a different address than the request was made to.
+ This is one form of a DNS cache poisoning attack.
+
+ The patch simply uses recvfrom() rather than recv() and validates that the
+ address returned from recvfrom() matches the address of the server we have
+ connected to. Only necessary on UDP sockets as they are connection-less, TCP
+ is unaffected.
+
+- Fix by George Neill:
+ Fixed compilation of acountry sample application failure on some systems.
+
+* Aug 4 2008 (Daniel Stenberg)
+- Fix by Tofu Linden:
+
+ The symptom:
+ * Users (usually, but not always) on 2-Wire routers and the Comcast service
+ and a wired connection to their router would find that the second and
+ subsequent DNS lookups from fresh processes using c-ares to resolve the same
+ address would cause the process to never see a reply (it keeps polling for
+ around 1m15s before giving up).
+
+ The repro:
+ * On such a machine (and yeah, it took us a lot of QA to find the systems
+ that reproduce such a specific problem!), do 'ahost www.secondlife.com',
+ then do it again. The first process's lookup will work, subsequent lookups
+ will time-out and fail.
+
+ The cause:
+ * init_id_key() was calling randomize_key() *before* it initialized
+ key->state, meaning that the randomness generated by randomize_key() is
+ immediately overwritten with deterministic values. (/dev/urandom was also
+ being read incorrectly in the c-ares version we were using, but this was
+ fixed in a later version.)
+ * This makes the stream of generated query-IDs from any new c-ares process
+ be an identical and predictable sequence of IDs.
+ * This makes the 2-Wire's default built-in DNS server detect these queries
+ as probable-duplicates and (erroneously) not respond at all.
+
+
+* Aug 4 2008 (Yang Tse)
+- Autoconf 2.62 has changed the behaviour of the AC_AIX macro which we use.
+ Prior versions of autoconf defined _ALL_SOURCE if _AIX was defined. 2.62
+ version of AC_AIX defines _ALL_SOURCE and other four preprocessor symbols
+ no matter if the system is AIX or not. To keep the traditional behaviour,
+ and an uniform one across autoconf versions AC_AIX is replaced with our
+ own internal macro CARES_CHECK_AIX_ALL_SOURCE.
+
+* Aug 1 2008 (Yang Tse)
+- Configure process now checks if the preprocessor _REENTRANT symbol is already
+ defined. If it isn't currently defined a set of checks are performed to test
+ if its definition is required to make visible to the compiler a set of *_r
+ functions. Finally, if _REENTRANT is already defined or needed it takes care
+ of making adjustments necessary to ensure that it is defined equally for the
+ configure process tests and generated config file.
+
+* Jul 20 2008 (Yang Tse)
+- When recvfrom prototype uses a void pointer for arguments 2, 5 or 6 this will
+ now cause the definition, as appropriate, of RECVFROM_TYPE_ARG2_IS_VOID,
+ RECVFROM_TYPE_ARG5_IS_VOID or RECVFROM_TYPE_ARG6_IS_VOID.
+
+* Jul 17 2008 (Yang Tse)
+- RECVFROM_TYPE_ARG2, RECVFROM_TYPE_ARG5 and RECVFROM_TYPE_ARG6 are now defined
+ to the data type pointed by its respective argument and not the pointer type.
+
+* Jul 16 2008 (Yang Tse)
+- Improved configure detection of number of arguments for getservbyport_r.
+ Detection is now based on compilation checks instead of linker ones.
+
+- Configure process now checks availability of recvfrom() socket function and
+ finds out its return type and the types of its arguments. Added definitions
+ for non-configure systems config files, and introduced macro sreadfrom which
+ will be used on udp sockets as a recvfrom() wrapper in the future.
+
+* Jul 15 2008 (Yang Tse)
+- Introduce definition of _REENTRANT symbol in setup.h to improve library
+ usability. Previously the configure process only used the AC_SYS_LARGEFILE
+ macro for debug builds, now it is also used for non-debug ones enabling the
+ use of configure options --enable-largefile and --disable-largefile which
+ might be needed for library compatibility. Remove checking the size of
+ curl_off_t, it is no longer needed.
+
+* Jul 3 2008 (Daniel Stenberg)
+- Phil Blundell: If you ask ares_gethostbyname() to do an AF_INET6 lookup and
+ the target host has only A records, it automatically falls back to an
+ AF_INET lookup and gives you the A results. However, if the target host has
+ a CNAME record, this behaviour is defeated since the original query does
+ return some data even though ares_parse_aaa_reply() doesn't consider it
+ relevant. Here's a small patch to make it behave the same with and without
+ the CNAME.
+
+* Jul 2 2008 (Yang Tse)
+- Fallback to gettimeofday when monotonic clock is unavailable at run-time.
+
+* Jun 30 2008 (Daniel Stenberg)
+
+- As was pointed out to me by Andreas Schuldei, the MAXHOSTNAMELEN define is
+ not posix or anything and thus c-ares failed to build on hurd (and possibly
+ elsewhere). The define was also somewhat artificially used in the windows
+ port. Now, I instead rewrote the use of gethostbyname to enlarge the host
+ name buffer in case of need and totally avoid the use of the MAXHOSTNAMELEN
+ define. I thus also removed the define from the namser.h file where it was
+ once added for the windows build.
+
+ I also fixed init_by_defaults() function to not leak memory in case if
+ error.
+
+* Jun 9 2008 (Yang Tse)
+
+- Make libcares.pc generated file for pkg-config include information relative
+ to the libraries needed for the static linking of c-ares.
+
+* May 30 2008 (Yang Tse)
+
+- Brad House fixed a missing header file inclusion in adig sample program.
+
+Version 1.5.2 (May 29, 2008)
+
+* May 13 2008 (Daniel Stenberg)
+
+- Introducing millisecond resolution support for the timeout option. See
+ ares_init_options()'s ARES_OPT_TIMEOUTMS.
+
+* May 9 2008 (Yang Tse)
+
+- Use monotonic time source if available, for private function ares__tvnow()
+
+* May 7 2008 (Daniel Stenberg)
+
+- Sebastian made c-ares able to return all PTR-records when doing reverse
+ lookups. It is not common practice to have multiple PTR-Records for a single
+ IP, but its perfectly legal and some sites have those.
+
+- Doug Goldstein provided a configure patch: updates autoconf 2.13 usage to
+ autoconf 2.57 usage (which is the version you have specified as the minimum
+ version). It's a minor change but it does clean up some warnings with newer
+ autoconf (specifically 2.62).
+
+* May 5 2008 (Yang Tse)
+
+- Improved parsing of resolver configuration files.
+
+* April 4 2008 (Daniel Stenberg)
+
+- Eino Tuominen improved the code when a file is used to seed the randomizer.
+
+- Alexey Simak made adig support NAPTR records
+
+- Alexey Simak fixed the VC dsp file by adding the missing source file
+ ares_expand_string.c
+
+* December 11 2007 (Gisle Vanem)
+
+- Added another sample application; acountry.c which converts an
+ IPv4-address(es) and/or host-name(s) to country-name and country-code.
+ This uses the service of the DNSBL at countries.nerd.dk.
+
+* December 3 2007 (Daniel Stenberg)
+
+- Brad Spencer fixed the configure script to assume that there's no
+ /dev/urandom when built cross-compiled as then the script cannot check for
+ it.
+
+- Erik Kline cleaned up ares_gethostbyaddr.c:next_lookup() somewhat
+
+Version 1.5.1 (Nov 21, 2007)
+
+* November 21 2007 (Daniel Stenberg)
+
+- Robin Cornelius pointed out that ares_llist.h was missing in the release
+ archive for 1.5.0
+
+Version 1.5.0 (Nov 21, 2007)
+
+* October 2 2007 (Daniel Stenberg)
+
+- ares_strerror() segfaulted if the input error number was out of the currently
+ supported range.
+
+- Yang Tse: Avoid a segfault when generating a DNS "Transaction ID" in
+ internal function init_id_key() under low memory conditions.
+
+* September 28 2007 (Daniel Stenberg)
+
+- Bumped version to 1.5.0 for next release and soname bumped to 2 due to ABI
+ and API changes in the progress callback (and possibly more coming up from
+ Steinar)
+
+* September 28 2007 (Steinar H. Gunderson)
+
+- Don't skip a server if it's the only one. (Bugfix from the Google tree.)
+
+- Made the query callbacks receive the number of timeouts that happened during
+ the execution of a query, and updated documentation accordingly. (Patch from
+ the Google tree.)
+
+- Support a few more socket options: ARES_OPT_SOCK_SNDBUF and
+ ARES_OPT_SOCK_RCVBUF
+
+- Always register for TCP events even if there are no outstanding queries, as
+ the other side could always close the connection, which is a valid event
+ which should be responded to.
+
+* September 22 2007 (Daniel Stenberg)
+
+- Steinar H. Gunderson fixed: Correctly clear sockets from the fd_set on in
+ several functions (write_tcp_data, read_tcp_data, read_udp_packets) so that
+ if it fails and the socket is closed the following code doesn't try to use
+ the file descriptor.
+
+- Steinar H. Gunderson modified c-ares to now also do to DNS retries even when
+ TCP is used since there are several edge cases where it still makes sense.
+
+- Brad House provided a fix for ares_save_options():
+
+ Apparently I overlooked something with the ares_save_options() where it
+ would try to do a malloc(0) when no options of that type needed to be saved.
+ On most platforms, this was fine because malloc(0) doesn't actually return
+ NULL, but on AIX it does, so ares_save_options would return ARES_ENOMEM.
+
+* July 14 2007 (Daniel Stenberg)
+
+- Vlad Dinulescu fixed two outstanding valgrind reports:
+
+ 1. In ares_query.c , in find_query_by_id we compare q->qid (which is a short
+ int variable) with qid, which is declared as an int variable. Moreover,
+ DNS_HEADER_SET_QID is used to set the value of qid, but DNS_HEADER_SET_QID
+ sets only the first two bytes of qid. I think that qid should be declared as
+ "unsigned short" in this function.
+
+ 2. The same problem occurs in ares_process.c, process_answer() . query->qid
+ (an unsigned short integer variable) is compared with id, which is an
+ integer variable. Moreover, id is initialized from DNS_HEADER_QID which sets
+ only the first two bytes of id. I think that the id variable should be
+ declared as "unsigned short" in this function.
+
+ Even after declaring these variables as "unsigned short", the valgrind
+ errors are still there. Which brings us to the third problem.
+
+ 3. The third problem is that Valgrind assumes that query->qid is not
+ initialised correctly. And it does that because query->qid is set from
+ DNS_HEADER_QID(qbuf); Valgrind says that qbuf has uninitialised bytes. And
+ qbuf has uninitialised bytes because of channel->next_id . And next_id is
+ set by ares_init.c:ares__generate_new_id() . I found that putting short r=0
+ in this function (instead of short r) makes all Valgrind warnings go away.
+ I have studied ares__rc4() too, and this is the offending line:
+
+ buffer_ptr[counter] ^= state[xorIndex]; (ares_query.c:62)
+
+ This is what triggers Valgrind.. buffer_ptr is uninitialised in this function,
+ and by applying ^= on it, it remains uninitialised.
+
+Version 1.4.0 (June 8, 2007)
+
+* June 4 2007 (Daniel Stenberg)
+
+- James Bursa reported a major memory problem when resolving multi-IP names
+ and I found and fixed the problem. It was added by Ashish Sharma's patch
+ two days ago.
+
+ When I then tried to verify multiple entries in /etc/hosts after my fix, I
+ got another segfault and decided this code was not ripe for inclusion and I
+ reverted the patch.
+
+* June 2 2007
+
+- Brad Spencer found and fixed three flaws in the code, found with the new
+ gcc 4.2.0 warning: -Waddress
+
+- Brad House fixed VS2005 compiler warnings due to time_t being 64bit.
+ He also made recent Microsoft compilers use _strdup() instead of strdup().
+
+- Brad House's man pages for ares_save_options() and ares_destroy_options()
+ were added.
+
+- Ashish Sharma provided a patch for supporting multiple entries in the
+ /etc/hosts file. Patch edited for coding style and functionality by me
+ (Daniel).
+
+* May 30 2007
+
+- Shmulik Regev brought cryptographically secure transaction IDs:
+
+ The c-ares library implementation uses a DNS "Transaction ID" field that is
+ seeded with a pseudo random number (based on gettimeofday) which is
+ incremented (++) between consecutive calls and is therefore rather
+ predictable. In general, predictability of DNS Transaction ID is a well
+ known security problem (e.g.
+ http://bak.spc.org/dms/archive/dns_id_attack.txt) and makes a c-ares based
+ implementation vulnerable to DNS poisoning. Credit goes to Amit Klein
+ (Trusteer) for identifying this problem.
+
+ The patch I wrote changes the implementation to use a more secure way of
+ generating unique IDs. It starts by obtaining a key with reasonable entropy
+ which is used with an RC4 stream to generate the cryptographically secure
+ transaction IDs.
+
+ Note that the key generation code (in ares_init:randomize_key) has two
+ versions, the Windows specific one uses a cryptographically safe function
+ provided (but undocumented :) by the operating system (described at
+ http://blogs.msdn.com/michael_howard/archive/2005/01/14/353379.aspx). The
+ default implementation is a bit naive and uses the standard 'rand'
+ function. Surely a better way to generate random keys exists for other
+ platforms.
+
+ The patch can be tested by using the adig utility and using the '-s' option.
+
+- Brad House added ares_save_options() and ares_destroy_options() that can be
+ used to keep options for later re-usal when ares_init_options() is used.
+
+ Problem: Calling ares_init() for each lookup can be unnecessarily resource
+ intensive. On windows, it must LoadLibrary() or search the registry
+ on each call to ares_init(). On unix, it must read and parse
+ multiple files to obtain the necessary configuration information. In
+ a single-threaded environment, it would make sense to only
+ ares_init() once, but in a heavily multi-threaded environment, it is
+ undesirable to ares_init() and ares_destroy() for each thread created
+ and track that.
+
+ Solution: Create ares_save_options() and ares_destroy_options() functions to
+ retrieve and free options obtained from an initialized channel. The
+ options populated can be used to pass back into ares_init_options(),
+ it should populate all needed fields and not retrieve any information
+ from the system. Probably wise to destroy the cache every minute or
+ so to prevent the data from becoming stale.
+
+- Daniel S added ares_process_fd() to allow applications to ask for processing
+ on specific sockets and thus avoiding select() and associated
+ functions/macros. This function will be used by upcoming libcurl releases
+ for this very reason. It also made me export the ares_socket_t type in the
+ public ares.h header file, since ares_process_fd() uses that type for two of
+ the arguments.
+
+* May 25 2007
+
+- Ravi Pratap fixed a flaw in the init_by_resolv_conf() function for windows
+ that could cause it to return a bad return code.
+
+* April 16 2007
+
+- Yang Tse: Provide ares_getopt() command-line parser function as a source
+ code helper function, not belonging to the actual c-ares library.
+
+* February 19 2007
+
+- Vlad Dinulescu added ares_parse_ns_reply().
+
+* February 13 2007
+
+- Yang Tse: Fix failure to get the search sequence of /etc/hosts and
+ DNS from /etc/nsswitch.conf, /etc/host.conf or /etc/svc.conf when
+ /etc/resolv.conf did not exist or was unable to read it.
+
+* November 22 2006
+
+- Install ares_dns.h too
+
+- Michael Wallner fixed this problem: When I set domains in the options
+ struct, and there are domain/search entries in /etc/resolv.conf, the domains
+ of the options struct will be overridden.
+
+* November 6 2006
+
+- Yang Tse removed a couple of potential zero size memory allocations.
+
+- Andreas Rieke fixed the line endings in the areslib.dsp file that I (Daniel)
+ broke in the 1.3.2 release. We should switch to a system where that file is
+ auto-generated. We could rip some code for that from curl...
+
+Version 1.3.2 (November 3, 2006)
+
+* October 12 2006
+
+- Prevent ares_getsock() to overflow if more than 16 sockets are used.
+
+* September 11 2006
+
+- Guilherme Balena Versiani: I noted a strange BUG in Win32 port
+ (ares_init.c/get_iphlpapi_dns_info() function): when I disable the network
+ by hand or disconnect the network cable in Windows 2000 or Windows XP, my
+ application gets 127.0.0.1 as the only name server. The problem comes from
+ 'GetNetworkParams' function, that returns the empty string "" as the only
+ name server in that case. Moreover, the Windows implementation of
+ inet_addr() returns INADDR_LOOPBACK instead of INADDR_NONE.
+
+* August 29 2006
+
+- Brad Spencer did
+
+ o made ares_version.h use extern "C" for c++ compilers
+ o fixed compiler warnings in ares_getnameinfo.c
+ o fixed a buffer position init for TCP reads
+
+* August 3 2006
+
+- Ravi Pratap fixed ares_getsock() to actually return the proper bitmap and
+ not always zero!
+
+Version 1.3.1 (June 24, 2006)
+
+* July 23, 2006
+
+- Gisle Vanem added getopt() to the ahost program. Currently accepts
+ only [-t {a|aaaa}] to specify address family in ares_gethostbyname().
+
+* June 19, 2006
+
+- (wahern) Removed "big endian" DNS section and RR data integer parser
+ macros from ares_dns.h, which break c-ares on my Sparc64. Bit-wise
+ operations in C operate on logical values. And in any event the octets are
+ already in big-endian (aka network) byte order so they're being reversed
+ (thus the source of the breakage).
+
+* June 18, 2006
+
+- William Ahern handles EAGAIN/EWOULDBLOCK errors in most of the I/O calls
+ from area_process.c.
+
+ TODO: Handle one last EAGAIN for a UDP socket send(2) in
+ ares__send_query().
+
+* May 10, 2006
+
+- Bram Matthys brought my attention to a libtool peculiarity where detecting
+ things such as C++ compiler actually is a bad thing and since we don't need
+ that detection I added a work-around, much inspired by a previous patch by
+ Paolo Bonzini. This also shortens the configure script quite a lot.
+
+* May 3, 2006
+
+- Nick Mathewson added the ARES_OPT_SOCK_STATE_CB option that when set makes
+ c-ares call a callback on socket state changes. A better way than the
+ ares_getsock() to get full control over the socket state.
+
+* January 9, 2006
+
+- Alexander Lazic improved the getservbyport_r() configure check.
+
+* January 6, 2006
+
+- Alexander Lazic pointed out that the buildconf should use the ACLOCAL_FLAGS
+ variable for easier controlling what it does and how it runs.
+
+* January 5, 2006
+
+- James Bursa fixed c-ares to find the hosts file on RISC OS, and made it
+ build with newer gcc versions that no longer defines "riscos".
+
+* December 22
+
+- Daniel Stenberg added ares_getsock() that extracts the set of sockets to
+ wait for action on. Similar to ares_fds() but not restricted to using
+ select() for the waiting.
+
+* November 25
+
+- Yang Tse fixed some send() / recv() compiler warnings
+
+* September 18
+
+- Added constants that will be used by ares_getaddrinfo
+
+- Made ares_getnameinfo use the reentrant getservbyport (getservbyport_r) if it
+ is available to ensure it works properly in a threaded environment.
+
+* September 10
+
+- configure fix for detecting a member in the sockaddr_in6 struct which failed
+ on ipv6-enabled HP-UX 11.00
+
+Version 1.3.0 (August 29, 2005)
+
+* August 21
+
+- Alfredo Tupone provided a fix for the Windows code in get_iphlpapi_dns_info()
+ when getting the DNS server etc.
+
+* June 19
+
+- Added some checks for the addrinfo structure.
+
+* June 2
+
+- William Ahern:
+
+ Make UDP sockets non-blocking. I've confirmed that at least on Linux 2.4 a
+ read event can come back from poll() on a valid SOCK_DGRAM socket but
+ recv(2) will still block. This patch doesn't ignore EAGAIN in
+ read_udp_packets(), though maybe it should. (This patch was edited by Daniel
+ Stenberg and a new configure test was added (imported from curl's configure)
+ to properly detect what non-blocking socket approach to use.)
+
+ I'm not quite sure how this was happening, but I've been seeing PTR queries
+ which seem to return empty responses. At least, they were empty when calling
+ ares_expand_name() on the record. Here's a patch which guarantees to
+ NUL-terminate the expanded name. The old behavior failed to NUL-terminate if
+ len was 0, and this was causing strlen() to run past the end of the buffer
+ after calling ares_expand_name() and getting ARES_SUCCESS as the return
+ value. If q is not greater than *s then it's equal and *s is always
+ allocated with at least one byte.
+
+* May 16
+
+- Added ares_getnameinfo which mimics the getnameinfo API (another feature
+ that could use testing).
+
+* May 14
+
+- Added an inet_ntop function from BIND for systems that do not have it.
+
+* April 9
+
+- Made sortlist support IPv6 (this can probably use some testing).
+
+- Made sortlist support CIDR matching for IPv4.
+
+* April 8
+
+- Added preliminary IPv6 support to ares_gethostbyname. Currently, sortlist
+ does not work with IPv6. Also provided an implementation of bitncmp from
+ BIND for systems that do not supply this function. This will be used to add
+ IPv6 support to sortlist.
+
+- Made ares_gethostbyaddr support IPv6 by specifying AF_INET6 as the family.
+ The function can lookup IPv6 addresses both from files (/etc/hosts) and
+ DNS lookups.
+
+* April 7
+
+- Tupone Alfredo fixed includes of arpa/nameser_compat.h to build fine on Mac
+ OS X.
+
+* April 5
+
+- Dominick Meglio: Provided implementations of inet_net_pton and inet_pton
+ from BIND for systems that do not include these functions.
+
+* March 11, 2005
+
+- Dominick Meglio added ares_parse_aaaa_reply.c and did various
+ adjustments. The first little steps towards IPv6 support!
+
+* November 7
+
+- Fixed the VC project and makefile to use ares_cancel and ares_version
+
+* October 24
+
+- The released ares_version.h from 1.2.1 says 1.2.0 due to a maketgz flaw.
+ This is now fixed.
+
+Version 1.2.1 (October 20, 2004)
+
+* September 29
+
+- Henrik Stoerner fix: got a report that Tru64 Unix (the unix from Digital
+ when they made Alpha's) uses /etc/svc.conf for the purpose fixed below for
+ other OSes. He made c-ares check for and understand it if present.
+
+- Now c-ares will use local host name lookup _before_ DNS resolving by default
+ if nothing else is told.
+
+* September 26
+
+- Henrik Stoerner: found out that c-ares does not look at the /etc/host.conf
+ file to determine the sequence in which to search /etc/hosts and DNS. So on
+ systems where this order is defined by /etc/host.conf instead of a "lookup"
+ entry in /etc/resolv.conf, c-ares will always default to looking in DNS
+ first, and /etc/hosts second.
+
+ c-ares now looks at
+
+ 1) resolv.conf (for the "lookup" line);
+ 2) nsswitch.fon (for the "hosts:" line);
+ 3) host.conf (for the "order" line).
+
+ First match wins.
+
+- Dominick Meglio patched: C-ares on Windows assumed that the HOSTS file is
+ located in a static location. It assumed
+ C:\Windows\System32\Drivers\Etc. This is a poor assumption to make. In fact,
+ the location of the HOSTS file can be changed via a registry setting.
+
+ There is a key called DatabasePath which specifies the path to the HOSTS
+ file:
+ http://www.microsoft.com/technet/itsolutions/network/deploy/depovg/tcpip2k.mspx
+
+ The patch will make c-ares correctly consult the registry for the location
+ of this file.
+
+* August 29
+
+- Gisle Vanem fixed the MSVC build files.
+
+* August 20
+
+- Gisle Vanem made c-ares build and work with his Watt-32 TCP/IP stack.
+
+* August 13
+
+- Harshal Pradhan made a minor syntax change in ares_init.c to make it build
+ fine with MSVC 7.1
+
+* July 24
+
+- Made the lib get built static only if --enable-debug is used.
+
+- Gisle Vanem fixed:
+
+ Basically in loops like handle_errors(), 'query->next' was assigned a local
+ variable and then query was referenced after the memory was freed by
+ next_server(). I've changed that so next_server() and end_query() returns
+ the next query. So callers should use this ret-value.
+
+ The next problem was that 'server->tcp_buffer_pos' had a random value at
+ entry to 1st recv() (luckily causing Winsock to return ENOBUFS).
+
+ I've also added a ares_writev() for Windows to streamline the code a bit
+ more.
+
+* July 20
+- Fixed a few variable return types for some system calls. Made configure
+ check for ssize_t to make it possible to use that when receiving the send()
+ error code. This is necessary to prevent compiler warnings on some systems.
+
+- Made configure create config.h, and all source files now include setup.h that
+ might include the proper config.h (or a handicrafted alternative).
+
+- Switched to 'ares_socket_t' type for sockets in ares, since Windows don't
+ use 'int' for that.
+
+- automake-ified and libool-ified c-ares. Now it builds libcares as a shared
+ lib on most platforms if wanted. (This bloated the size of the release
+ archive with another 200K!)
+
+- Makefile.am now uses Makefile.inc for the c sources, h headers and man
+ pages, to make it easier for other makefiles to use the exact same set of
+ files.
+
+- Adjusted 'maketgz' to use the new automake magic when building distribution
+ archives.
+
+- Anyone desires HTML and/or PDF versions of the man pages in the release
+ archives?
+
+* July 3
+- Gnter Knauf made c-ares build and run on Novell Netware.
+
+* July 1
+- Gisle Vanem provided Makefile.dj to build with djgpp, added a few more djgpp
+ fixes and made ares not use 'errno' to provide further info on Windows.
+
+* June 30
+- Gisle Vanem made it build with djgpp and run fine with the Watt-32 stack.
+
+* June 10
+- Gisle Vanem's init patch for Windows:
+
+ The init_by_resolv_conf() function fetches the DNS-server(s)
+ from a series of registry branches.
+
+ This can be wrong in the case where DHCP has assigned nameservers, but the
+ user has overridden these servers with other preferred settings. Then it's
+ wrong to use the DHCPNAMESERVER setting in registry.
+
+ In the case of no global DHCP-assigned or fixed servers, but DNS server(s)
+ per adapter, one has to query the adapter branches. But how can c-ares know
+ which adapter is valid for use? AFAICS it can't. There could be one adapter
+ that is down (e.g. a VPN adapter).
+
+ So it's better to leave this to the IP Helper API (iphlapi) available in
+ Win-98/2000 and later. My patch falls-back to the old way if not available.
+
+* June 8
+- James Bursa fixed an init issue for RISC OS.
+
+* May 11
+- Nico Stappenbelt reported that when processing domain and search lines in
+ the resolv.conf file, the first entry encountered is processed and used as
+ the search list. According to the manual pages for both Linux, Solaris and
+ Tru64, the last entry of either a domain or a search field is used.
+
+ This is now adjusted in the code
+
+Version 1.2.0 (April 13, 2004)
+
+* April 2, 2004
+- Updated various man pages to look nicer when converted to HTML on the web
+ site.
+
+* April 1, 2004
+- Dirk Manske provided a new function that is now named ares_cancel(). It is
+ used to cancel/cleanup a resolve/request made using ares functions on the
+ given ares channel. It does not destroy/kill the ares channel itself.
+
+- Dominick Meglio cleaned up the formatting in several man pages.
+
+* March 30, 2004
+- Dominick Meglio's new ares_expand_string. A helper function when decoding
+ incoming DNS packages.
+
+- Daniel Stenberg modified the Makefile.in to use a for loop for the man page
+ installation to improve overview and make it easier to add man pages.
+
+Version 1.1.0 (March 11, 2004)
+
+* March 9, 2004
+- Gisle Vanem improved build on Windows.
+
+* February 25, 2004
+- Dan Fandrich found a flaw in the Feb 22 fix.
+
+- Added better configure --enable-debug logic (taken from the curl configure
+ script). Added acinclude.m4 to the tarball.
+
+* February 23, 2004
+- Removed ares_free_errmem(), the function, the file and the man page. It was
+ not used and it did nothing.
+
+- Fixed a lot of code that wasn't "64bit clean" and thus caused a lot of
+ compiler warnings on picky compilers.
+
+* February 22, 2004
+- Dominick Meglio made ares init support multiple name servers in the
+ NameServer key on Windows.
+
+* February 16, 2004
+- Modified ares_private.h to include libcurl's memory debug header if
+ CURLDEBUG is set. This makes all the ares-functions supervised properly by
+ the curl test suite. This also forced me to add inclusion of the
+ ares_private.h header in a few more files that are using some kind of
+ memory-related resources.
+
+- Made the makefile only build ahost and adig if 'make demos' is used.
+
+* February 10, 2004
+- Dirk Manske made ares_version.h installed with 'make install'
+
+* February 4, 2004
+- ares_free_errmem() is subject for removal, it is simply present for future
+ purposes, and since we removed the extra parameter in strerror() it won't
+ be used by c-ares!
+- configure --enable-debug now enables picky compiler options if gcc is used
+- fixed several compiler warnings --enable-debug showed and Joerg Mueller-Tolk
+ reported
+
+Version 1.0.0 (February 3, 2004)
+
+* February 3, 2004
+- now we produce the libcares.a library instead of the previous libares.a
+ since we are no longer compatible
+
+* February 2, 2004
+
+- ares_strerror() has one argument less. This is the first official
+ modification of the existing provided ares API.
+
+* January 29, 2004
+
+- Dirk Manske fixed how the socket is set non-blocking.
+
+* January 4, 2004
+
+- Dominick Meglio made the private gettimeofday() become ares_gettimeofday()
+ instead in order to not pollute the name space and risk colliding with
+ other libraries' versions of this function.
+
+* October 24, 2003. Daniel Stenberg
+
+ Added ares_version().
+
+Version 1.0-pre1 (8 October 2003)
+
+- James Bursa made it run on RISC OS
+
+- Dominick Meglio made it run fine on NT4
+
+- Duncan Wilcox made it work fine on Mac OS X
+
+- Daniel Stenberg adjusted the windows port
+
+- liren at vivisimo.com made the initial windows port
+
+* Imported the sources from ares 1.1.1
diff --git a/subprojects/c-ares/CMakeLists.txt b/subprojects/c-ares/CMakeLists.txt
@@ -0,0 +1,850 @@
+# Copyright (C) The c-ares project and its contributors
+# SPDX-License-Identifier: MIT
+CMAKE_MINIMUM_REQUIRED (VERSION 3.5.0)
+
+list(APPEND CMAKE_MODULE_PATH "${CMAKE_CURRENT_SOURCE_DIR}/cmake/")
+
+INCLUDE (CheckIncludeFiles)
+INCLUDE (CheckTypeSize)
+INCLUDE (CheckFunctionExists)
+INCLUDE (CheckSymbolExists)
+INCLUDE (CheckCSourceCompiles)
+INCLUDE (CheckStructHasMember)
+INCLUDE (CheckLibraryExists)
+
+PROJECT (c-ares LANGUAGES C VERSION "1.25.0" )
+
+# Set this version before release
+SET (CARES_VERSION "${PROJECT_VERSION}")
+
+INCLUDE (GNUInstallDirs) # include this *AFTER* PROJECT(), otherwise paths are wrong.
+
+# This is for libtool compatibility, and specified in a form that is easily
+# translatable from libtool (even if the actual form doesn't make sense).
+# For instance, in an autotools project, in Makefile.am there is a line that
+# contains something like:
+# -version-info 4:0:2
+# This breaks down into sections of current:revision:age
+# This then generates a version of "(current-age).age.revision" with an
+# interface version of "(current-age)"
+# For example, a version of 4:0:2 would generate output such as:
+# libname.so -> libname.so.2
+# libname.so.2 -> libname.so.2.2.0
+SET (CARES_LIB_VERSIONINFO "12:1:10")
+
+
+OPTION (CARES_STATIC "Build as a static library" OFF)
+OPTION (CARES_SHARED "Build as a shared library" ON)
+OPTION (CARES_INSTALL "Create installation targets (chain builders may want to disable this)" ON)
+OPTION (CARES_STATIC_PIC "Build the static library as PIC (position independent)" OFF)
+OPTION (CARES_BUILD_TESTS "Build and run tests" OFF)
+OPTION (CARES_BUILD_CONTAINER_TESTS "Build and run container tests (implies CARES_BUILD_TESTS, Linux only)" OFF)
+OPTION (CARES_BUILD_TOOLS "Build tools" ON)
+OPTION (CARES_SYMBOL_HIDING "Hide private symbols in shared libraries" OFF)
+OPTION (CARES_THREADS "Build with thread-safety support" ON)
+SET (CARES_RANDOM_FILE "/dev/urandom" CACHE STRING "Suitable File / Device Path for entropy, such as /dev/urandom")
+
+
+# Tests require a C++14 compiler
+IF (CARES_BUILD_TESTS OR CARES_BUILD_CONTAINER_TESTS)
+ set(CMAKE_CXX_STANDARD 14)
+ set(CMAKE_CXX_STANDARD_REQUIRED TRUE)
+ set(CMAKE_CXX_EXTENSIONS FALSE)
+ enable_language(CXX)
+ENDIF ()
+
+# Tests require static to be enabled on Windows to be able to access otherwise hidden symbols
+IF ((CARES_BUILD_TESTS OR CARES_BUILD_CONTAINER_TESTS) AND (NOT CARES_STATIC) AND WIN32)
+ SET (CARES_STATIC ON)
+ SET (CARES_STATIC_PIC ON)
+ MESSAGE (WARNING "Static building was requested be disabled, but re-enabled to support tests")
+ENDIF ()
+
+INCLUDE (EnableWarnings)
+
+# allow linking against the static runtime library in msvc
+IF (MSVC)
+ OPTION (CARES_MSVC_STATIC_RUNTIME "Link against the static runtime library" OFF)
+ IF (CARES_MSVC_STATIC_RUNTIME)
+ # CMAKE_CONFIGURATION_TYPES is empty on non-IDE generators (Ninja, NMake)
+ # and that's why we also use CMAKE_BUILD_TYPE to cover for those generators.
+ # For IDE generators, CMAKE_BUILD_TYPE is usually empty
+ FOREACH (config_type ${CMAKE_CONFIGURATION_TYPES} ${CMAKE_BUILD_TYPE})
+ STRING (TOUPPER ${config_type} upper_config_type)
+ SET (flag_var "CMAKE_C_FLAGS_${upper_config_type}")
+ IF (${flag_var} MATCHES "/MD")
+ STRING (REGEX REPLACE "/MD" "/MT" ${flag_var} "${${flag_var}}")
+ ENDIF ()
+ ENDFOREACH ()
+
+ # clean up
+ SET (upper_config_type)
+ SET (config_type)
+ SET (flag_var)
+ ENDIF ()
+ENDIF ()
+
+IF (CARES_SYMBOL_HIDING)
+ IF (CMAKE_VERSION VERSION_LESS 3.12)
+ MESSAGE (FATAL_ERROR "Hiding symbols requires CMake 3.12")
+ ENDIF ()
+ CMAKE_POLICY (SET CMP0063 NEW)
+ENDIF ()
+
+# Keep build organized.
+SET (CMAKE_RUNTIME_OUTPUT_DIRECTORY "${PROJECT_BINARY_DIR}/${CMAKE_INSTALL_BINDIR}")
+SET (CMAKE_LIBRARY_OUTPUT_DIRECTORY "${PROJECT_BINARY_DIR}/${CMAKE_INSTALL_LIBDIR}")
+SET (CMAKE_ARCHIVE_OUTPUT_DIRECTORY "${PROJECT_BINARY_DIR}/${CMAKE_INSTALL_LIBDIR}")
+SET (PACKAGE_DIRECTORY ${PROJECT_BINARY_DIR}/package)
+
+# Destinations for installing different kinds of targets (pass to install command).
+SET (TARGETS_INST_DEST
+ RUNTIME DESTINATION ${CMAKE_INSTALL_BINDIR}
+ BUNDLE DESTINATION ${CMAKE_INSTALL_BINDIR}
+ LIBRARY DESTINATION ${CMAKE_INSTALL_LIBDIR}
+ ARCHIVE DESTINATION ${CMAKE_INSTALL_LIBDIR}
+)
+
+# Function in Library
+# CHECK_LIBRARY_EXISTS can't be used as it will return true if the function
+# is found in a different required/dependent library.
+MACRO (CARES_FUNCTION_IN_LIBRARY func lib var)
+
+ SET (_ORIG_CMAKE_REQUIRED_LIBRARIES "${CMAKE_REQUIRED_LIBRARIES}")
+ SET (CMAKE_REQUIRED_LIBRARIES )
+ CHECK_FUNCTION_EXISTS ("${func}" "_CARES_FUNC_IN_LIB_GLOBAL_${func}")
+ SET (CMAKE_REQUIRED_LIBRARIES "${_ORIG_CMAKE_REQUIRED_LIBRARIES}")
+
+ IF ("${_CARES_FUNC_IN_LIB_GLOBAL_${func}}")
+ SET (${var} FALSE)
+ ELSE ()
+ CHECK_LIBRARY_EXISTS ("${lib}" "${func}" "" ${var})
+ ENDIF ()
+ENDMACRO ()
+
+# Look for dependent/required libraries
+CARES_FUNCTION_IN_LIBRARY (res_servicename resolv HAVE_RES_SERVICENAME_IN_LIBRESOLV)
+IF (HAVE_RES_SERVICENAME_IN_LIBRESOLV)
+ SET (HAVE_LIBRESOLV 1)
+ENDIF ()
+
+IF (APPLE)
+ CHECK_C_SOURCE_COMPILES ("
+ #include <stdio.h>
+ #include <TargetConditionals.h>
+ int main() {
+#if TARGET_OS_IPHONE == 0
+#error Not an iPhone target
+#endif
+return 0;
+ }
+ "
+ IOS)
+
+ CHECK_C_SOURCE_COMPILES ("
+#include <stdio.h>
+#include <TargetConditionals.h>
+ int main() {
+#if TARGET_OS_IPHONE == 0 || __IPHONE_OS_VERSION_MIN_REQUIRED < 100000
+# error Not iOS v10
+#endif
+return 0;
+ }
+ "
+ IOS_V10)
+
+ CHECK_C_SOURCE_COMPILES ("
+#include <stdio.h>
+#include <AvailabilityMacros.h>
+#ifndef MAC_OS_X_VERSION_10_12
+# define MAC_OS_X_VERSION_10_12 101200
+#endif
+ int main() {
+#if MAC_OS_X_VERSION_MIN_REQUIRED < MAC_OS_X_VERSION_10_12
+# error Not MacOSX 10.12 or higher
+#endif
+return 0;
+ }
+ "
+ MACOS_V1012)
+ENDIF ()
+
+IF ((IOS OR APPLE OR ZOS) AND HAVE_LIBRESOLV)
+ SET (CARES_USE_LIBRESOLV 1)
+ENDIF()
+
+
+CARES_FUNCTION_IN_LIBRARY (gethostbyname nsl HAVE_LIBNSL)
+CARES_FUNCTION_IN_LIBRARY (gethostbyname socket HAVE_GHBN_LIBSOCKET)
+CARES_FUNCTION_IN_LIBRARY (gethostbyname network HAVE_LIBNETWORK)
+CARES_FUNCTION_IN_LIBRARY (socket socket HAVE_SOCKET_LIBSOCKET)
+IF (HAVE_GHBN_LIBSOCKET OR HAVE_SOCKET_LIBSOCKET)
+ SET(HAVE_LIBSOCKET TRUE)
+ENDIF ()
+CARES_FUNCTION_IN_LIBRARY (socket network HAVE_LIBNETWORK)
+CARES_FUNCTION_IN_LIBRARY (clock_gettime rt HAVE_LIBRT)
+
+
+# Look for necessary includes
+CHECK_INCLUDE_FILES (sys/types.h HAVE_SYS_TYPES_H)
+CHECK_INCLUDE_FILES (sys/random.h HAVE_SYS_RANDOM_H)
+CHECK_INCLUDE_FILES (sys/socket.h HAVE_SYS_SOCKET_H)
+CHECK_INCLUDE_FILES (sys/sockio.h HAVE_SYS_SOCKIO_H)
+CHECK_INCLUDE_FILES (arpa/inet.h HAVE_ARPA_INET_H)
+CHECK_INCLUDE_FILES (arpa/nameser_compat.h HAVE_ARPA_NAMESER_COMPAT_H)
+CHECK_INCLUDE_FILES (arpa/nameser.h HAVE_ARPA_NAMESER_H)
+CHECK_INCLUDE_FILES (assert.h HAVE_ASSERT_H)
+CHECK_INCLUDE_FILES (errno.h HAVE_ERRNO_H)
+CHECK_INCLUDE_FILES (fcntl.h HAVE_FCNTL_H)
+CHECK_INCLUDE_FILES (inttypes.h HAVE_INTTYPES_H)
+CHECK_INCLUDE_FILES (limits.h HAVE_LIMITS_H)
+CHECK_INCLUDE_FILES (malloc.h HAVE_MALLOC_H)
+CHECK_INCLUDE_FILES (memory.h HAVE_MEMORY_H)
+CHECK_INCLUDE_FILES (netdb.h HAVE_NETDB_H)
+CHECK_INCLUDE_FILES (netinet/in.h HAVE_NETINET_IN_H)
+# On old MacOS SDK versions, you must include sys/socket.h before net/if.h
+IF (HAVE_SYS_SOCKET_H)
+ CHECK_INCLUDE_FILES ("sys/socket.h;net/if.h" HAVE_NET_IF_H)
+ELSE ()
+ CHECK_INCLUDE_FILES (net/if.h HAVE_NET_IF_H)
+ENDIF ()
+CHECK_INCLUDE_FILES (signal.h HAVE_SIGNAL_H)
+CHECK_INCLUDE_FILES (socket.h HAVE_SOCKET_H)
+CHECK_INCLUDE_FILES (stdbool.h HAVE_STDBOOL_H)
+CHECK_INCLUDE_FILES (stdint.h HAVE_STDINT_H)
+CHECK_INCLUDE_FILES (stdlib.h HAVE_STDLIB_H)
+CHECK_INCLUDE_FILES (strings.h HAVE_STRINGS_H)
+CHECK_INCLUDE_FILES (string.h HAVE_STRING_H)
+CHECK_INCLUDE_FILES (stropts.h HAVE_STROPTS_H)
+CHECK_INCLUDE_FILES (sys/ioctl.h HAVE_SYS_IOCTL_H)
+CHECK_INCLUDE_FILES (sys/param.h HAVE_SYS_PARAM_H)
+CHECK_INCLUDE_FILES (sys/select.h HAVE_SYS_SELECT_H)
+CHECK_INCLUDE_FILES (sys/stat.h HAVE_SYS_STAT_H)
+CHECK_INCLUDE_FILES (sys/time.h HAVE_SYS_TIME_H)
+CHECK_INCLUDE_FILES (sys/uio.h HAVE_SYS_UIO_H)
+CHECK_INCLUDE_FILES (sys/random.h HAVE_SYS_RANDOM_H)
+CHECK_INCLUDE_FILES (ifaddrs.h HAVE_IFADDRS_H)
+CHECK_INCLUDE_FILES (time.h HAVE_TIME_H)
+CHECK_INCLUDE_FILES (dlfcn.h HAVE_DLFCN_H)
+CHECK_INCLUDE_FILES (unistd.h HAVE_UNISTD_H)
+# On OpenBSD, you must include sys/types.h before netinet/tcp.h
+IF (HAVE_SYS_TYPES_H)
+ CHECK_INCLUDE_FILES ("sys/types.h;netinet/tcp.h" HAVE_NETINET_TCP_H)
+ELSE ()
+ CHECK_INCLUDE_FILES (netinet/tcp.h HAVE_NETINET_TCP_H)
+ENDIF ()
+
+# Include order matters for these windows files.
+# As cygwin environment has both socket.h and winsock2.h
+# headers check WIN32 not to include the later one here
+IF (WIN32)
+CHECK_INCLUDE_FILES ("winsock2.h;windows.h" HAVE_WINSOCK2_H)
+CHECK_INCLUDE_FILES ("winsock2.h;ws2tcpip.h;windows.h" HAVE_WS2TCPIP_H)
+CHECK_INCLUDE_FILES ("winsock2.h;iphlpapi.h;windows.h" HAVE_IPHLPAPI_H)
+CHECK_INCLUDE_FILES ("winsock2.h;netioapi.h;windows.h" HAVE_NETIOAPI_H)
+CHECK_INCLUDE_FILES ("winsock.h;windows.h" HAVE_WINSOCK_H)
+CHECK_INCLUDE_FILES (windows.h HAVE_WINDOWS_H)
+ENDIF ()
+
+# Set system-specific compiler flags
+IF (CMAKE_SYSTEM_NAME STREQUAL "Darwin")
+ LIST (APPEND SYSFLAGS -D_DARWIN_C_SOURCE)
+ELSEIF (CMAKE_SYSTEM_NAME STREQUAL "Linux")
+ LIST (APPEND SYSFLAGS -D_GNU_SOURCE -D_POSIX_C_SOURCE=200809L -D_XOPEN_SOURCE=700)
+ELSEIF (CMAKE_SYSTEM_NAME STREQUAL "SunOS")
+ LIST (APPEND SYSFLAGS -D__EXTENSIONS__ -D_REENTRANT -D_XOPEN_SOURCE=700)
+ELSEIF (CMAKE_SYSTEM_NAME STREQUAL "AIX")
+ LIST (APPEND SYSFLAGS -D_ALL_SOURCE -D_XOPEN_SOURCE=700 -D_USE_IRS)
+ELSEIF (CMAKE_SYSTEM_NAME STREQUAL "FreeBSD")
+ # Don't define _XOPEN_SOURCE on FreeBSD, it actually reduces visibility instead of increasing it
+ELSEIF (WIN32)
+ LIST (APPEND SYSFLAGS -DWIN32_LEAN_AND_MEAN -D_CRT_SECURE_NO_DEPRECATE -D_CRT_NONSTDC_NO_DEPRECATE -D_WIN32_WINNT=0x0602)
+ENDIF ()
+ADD_DEFINITIONS(${SYSFLAGS})
+
+
+
+# Tell C-Ares about libraries to depend on
+IF (HAVE_LIBRESOLV)
+ LIST (APPEND CARES_DEPENDENT_LIBS resolv)
+ENDIF ()
+IF (HAVE_LIBNSL)
+ LIST (APPEND CARES_DEPENDENT_LIBS nsl)
+ENDIF ()
+IF (HAVE_LIBSOCKET)
+ LIST (APPEND CARES_DEPENDENT_LIBS socket)
+ENDIF ()
+IF (HAVE_LIBNETWORK)
+ LIST (APPEND CARES_DEPENDENT_LIBS network)
+ENDIF ()
+IF (HAVE_LIBRT)
+ LIST (APPEND CARES_DEPENDENT_LIBS rt)
+ENDIF ()
+IF (WIN32)
+ LIST (APPEND CARES_DEPENDENT_LIBS ws2_32 advapi32 iphlpapi)
+ENDIF ()
+
+
+# When checking for symbols, we need to make sure we set the proper
+# headers, libraries, and definitions for the detection to work properly
+# CMAKE_REQUIRED_DEFINITIONS, CMAKE_REQUIRED_LIBRARIES, and
+# CMAKE_EXTRA_INCLUDE_FILES. When we're done with the detection, we'll
+# unset them.
+
+SET (CMAKE_REQUIRED_DEFINITIONS ${SYSFLAGS})
+LIST (APPEND CMAKE_REQUIRED_LIBRARIES ${CARES_DEPENDENT_LIBS})
+
+MACRO (CARES_EXTRAINCLUDE_IFSET var include)
+ IF (${var})
+ LIST (APPEND CMAKE_EXTRA_INCLUDE_FILES ${include})
+ ENDIF ()
+ENDMACRO ()
+
+CARES_EXTRAINCLUDE_IFSET (HAVE_STDBOOL_H stdbool.h)
+CARES_EXTRAINCLUDE_IFSET (HAVE_SYS_TYPES_H sys/types.h)
+CARES_EXTRAINCLUDE_IFSET (HAVE_ARPA_INET_H arpa/inet.h)
+CARES_EXTRAINCLUDE_IFSET (HAVE_ARPA_NAMESER_H arpa/nameser.h)
+CARES_EXTRAINCLUDE_IFSET (HAVE_NETDB_H netdb.h)
+CARES_EXTRAINCLUDE_IFSET (HAVE_NET_IF_H net/if.h)
+CARES_EXTRAINCLUDE_IFSET (HAVE_IFADDRS_H ifaddrs.h)
+CARES_EXTRAINCLUDE_IFSET (HAVE_NETINET_IN_H netinet/in.h)
+CARES_EXTRAINCLUDE_IFSET (HAVE_NETINET_TCP_H netinet/tcp.h)
+CARES_EXTRAINCLUDE_IFSET (HAVE_SIGNAL_H signal.h)
+CARES_EXTRAINCLUDE_IFSET (HAVE_STDLIB_H stdlib.h)
+CARES_EXTRAINCLUDE_IFSET (HAVE_STRING_H string.h)
+CARES_EXTRAINCLUDE_IFSET (HAVE_STRINGS_H strings.h)
+CARES_EXTRAINCLUDE_IFSET (HAVE_SYS_IOCTL_H sys/ioctl.h)
+CARES_EXTRAINCLUDE_IFSET (HAVE_SYS_RANDOM_H sys/random.h)
+CARES_EXTRAINCLUDE_IFSET (HAVE_SYS_SELECT_H sys/select.h)
+CARES_EXTRAINCLUDE_IFSET (HAVE_SYS_SOCKET_H sys/socket.h)
+CARES_EXTRAINCLUDE_IFSET (HAVE_SYS_SOCKIO_H sys/sockio.h)
+CARES_EXTRAINCLUDE_IFSET (HAVE_SYS_TIME_H sys/time.h)
+CARES_EXTRAINCLUDE_IFSET (HAVE_SYS_STAT_H sys/stat.h)
+CARES_EXTRAINCLUDE_IFSET (HAVE_SYS_UIO_H sys/uio.h)
+CARES_EXTRAINCLUDE_IFSET (HAVE_SYS_RANDOM_H sys/random.h)
+CARES_EXTRAINCLUDE_IFSET (HAVE_TIME_H time.h)
+CARES_EXTRAINCLUDE_IFSET (HAVE_FCNTL_H fcntl.h)
+CARES_EXTRAINCLUDE_IFSET (HAVE_UNISTD_H unistd.h)
+CARES_EXTRAINCLUDE_IFSET (HAVE_WINSOCK2_H winsock2.h)
+CARES_EXTRAINCLUDE_IFSET (HAVE_WS2TCPIP_H ws2tcpip.h)
+CARES_EXTRAINCLUDE_IFSET (HAVE_IPHLPAPI_H iphlpapi.h)
+CARES_EXTRAINCLUDE_IFSET (HAVE_WINDOWS_H windows.h)
+
+# Check Types
+# CHECK_TYPE_SIZE can't be used to see if a type exists because on Apple when
+# building multi-arch, it will throw an error. So we need to wrap
+# CHECK_C_SOURCE_COMPILES for our tests.
+MACRO (CARES_TYPE_EXISTS type var)
+ SET(_CARES_C_SOURCE "
+ #include <stdio.h>
+ #include <stdlib.h>
+ ")
+ FOREACH(_C_HEADER ${CMAKE_EXTRA_INCLUDE_FILES})
+ SET(_CARES_C_SOURCE "${_CARES_C_SOURCE}
+ #include <${_C_HEADER}>")
+ ENDFOREACH(_C_HEADER)
+
+ SET(_CARES_C_SOURCE "${_CARES_C_SOURCE}
+ int main() {
+ ${type} var_exists;
+ (void)var_exists;
+ return 0;
+ }
+ ")
+ CHECK_C_SOURCE_COMPILES ("${_CARES_C_SOURCE}" ${var})
+ENDMACRO ()
+
+CARES_TYPE_EXISTS (socklen_t HAVE_SOCKLEN_T)
+CARES_TYPE_EXISTS (SOCKET HAVE_TYPE_SOCKET)
+CARES_TYPE_EXISTS (ssize_t HAVE_SSIZE_T)
+CARES_TYPE_EXISTS ("long long" HAVE_LONGLONG)
+CARES_TYPE_EXISTS ("struct addrinfo" HAVE_STRUCT_ADDRINFO)
+CARES_TYPE_EXISTS ("struct in6_addr" HAVE_STRUCT_IN6_ADDR)
+CARES_TYPE_EXISTS ("struct sockaddr_in6" HAVE_STRUCT_SOCKADDR_IN6)
+CARES_TYPE_EXISTS ("struct sockaddr_storage" HAVE_STRUCT_SOCKADDR_STORAGE)
+CARES_TYPE_EXISTS ("struct timeval" HAVE_STRUCT_TIMEVAL)
+
+
+# Check for preprocessor defines
+CHECK_SYMBOL_EXISTS (AF_INET6 "${CMAKE_EXTRA_INCLUDE_FILES}" HAVE_AF_INET6)
+CHECK_SYMBOL_EXISTS (O_NONBLOCK "${CMAKE_EXTRA_INCLUDE_FILES}" HAVE_O_NONBLOCK)
+CHECK_SYMBOL_EXISTS (FIONBIO "${CMAKE_EXTRA_INCLUDE_FILES}" HAVE_FIONBIO)
+CHECK_SYMBOL_EXISTS (SIOCGIFADDR "${CMAKE_EXTRA_INCLUDE_FILES}" HAVE_IOCTL_SIOCGIFADDR)
+CHECK_SYMBOL_EXISTS (MSG_NOSIGNAL "${CMAKE_EXTRA_INCLUDE_FILES}" HAVE_MSG_NOSIGNAL)
+CHECK_SYMBOL_EXISTS (PF_INET6 "${CMAKE_EXTRA_INCLUDE_FILES}" HAVE_PF_INET6)
+CHECK_SYMBOL_EXISTS (SO_NONBLOCK "${CMAKE_EXTRA_INCLUDE_FILES}" HAVE_SO_NONBLOCK)
+
+# XCode v8 bug: iOS when targeting less than v10, or MacOS when targeting less than v10.12 will
+# say clock_gettime exists, it is a weak symbol that only exists in iOS10/MacOS10.12 and will
+# cause a crash at runtime when running on older versions. Skip finding CLOCK_MONOTONIC on older
+# OS's.
+IF ((NOT APPLE) OR IOS_V10 OR MACOS_V1012)
+ CHECK_SYMBOL_EXISTS (CLOCK_MONOTONIC "${CMAKE_EXTRA_INCLUDE_FILES}" HAVE_CLOCK_GETTIME_MONOTONIC)
+ENDIF ()
+
+CHECK_STRUCT_HAS_MEMBER("struct sockaddr_in6" sin6_scope_id "${CMAKE_EXTRA_INCLUDE_FILES}" HAVE_STRUCT_SOCKADDR_IN6_SIN6_SCOPE_ID LANGUAGE C)
+
+
+CHECK_SYMBOL_EXISTS (closesocket "${CMAKE_EXTRA_INCLUDE_FILES}" HAVE_CLOSESOCKET)
+CHECK_SYMBOL_EXISTS (CloseSocket "${CMAKE_EXTRA_INCLUDE_FILES}" HAVE_CLOSESOCKET_CAMEL)
+CHECK_SYMBOL_EXISTS (connect "${CMAKE_EXTRA_INCLUDE_FILES}" HAVE_CONNECT)
+CHECK_SYMBOL_EXISTS (fcntl "${CMAKE_EXTRA_INCLUDE_FILES}" HAVE_FCNTL)
+CHECK_SYMBOL_EXISTS (freeaddrinfo "${CMAKE_EXTRA_INCLUDE_FILES}" HAVE_FREEADDRINFO)
+CHECK_SYMBOL_EXISTS (getaddrinfo "${CMAKE_EXTRA_INCLUDE_FILES}" HAVE_GETADDRINFO)
+CHECK_SYMBOL_EXISTS (getenv "${CMAKE_EXTRA_INCLUDE_FILES}" HAVE_GETENV)
+CHECK_SYMBOL_EXISTS (gethostname "${CMAKE_EXTRA_INCLUDE_FILES}" HAVE_GETHOSTNAME)
+CHECK_SYMBOL_EXISTS (getnameinfo "${CMAKE_EXTRA_INCLUDE_FILES}" HAVE_GETNAMEINFO)
+CHECK_SYMBOL_EXISTS (getrandom "${CMAKE_EXTRA_INCLUDE_FILES}" HAVE_GETRANDOM)
+CHECK_SYMBOL_EXISTS (getservbyport_r "${CMAKE_EXTRA_INCLUDE_FILES}" HAVE_GETSERVBYPORT_R)
+CHECK_SYMBOL_EXISTS (getservbyname_r "${CMAKE_EXTRA_INCLUDE_FILES}" HAVE_GETSERVBYNAME_R)
+CHECK_SYMBOL_EXISTS (gettimeofday "${CMAKE_EXTRA_INCLUDE_FILES}" HAVE_GETTIMEOFDAY)
+CHECK_SYMBOL_EXISTS (if_indextoname "${CMAKE_EXTRA_INCLUDE_FILES}" HAVE_IF_INDEXTONAME)
+CHECK_SYMBOL_EXISTS (if_nametoindex "${CMAKE_EXTRA_INCLUDE_FILES}" HAVE_IF_NAMETOINDEX)
+CHECK_SYMBOL_EXISTS (ConvertInterfaceIndexToLuid "${CMAKE_EXTRA_INCLUDE_FILES}" HAVE_CONVERTINTERFACEINDEXTOLUID)
+CHECK_SYMBOL_EXISTS (ConvertInterfaceLuidToNameA "${CMAKE_EXTRA_INCLUDE_FILES}" HAVE_CONVERTINTERFACELUIDTONAMEA)
+CHECK_SYMBOL_EXISTS (inet_net_pton "${CMAKE_EXTRA_INCLUDE_FILES}" HAVE_INET_NET_PTON)
+IF (NOT WIN32)
+ # Disabled on Windows, because these functions are only really supported on Windows
+ # Vista or newer (_WIN32_WINNT >= 0x0600). Older versions of Windows may provide
+ # them as experimental non-working features, so we have to disable them manually.
+ CHECK_SYMBOL_EXISTS (inet_ntop "${CMAKE_EXTRA_INCLUDE_FILES}" HAVE_INET_NTOP)
+ CHECK_SYMBOL_EXISTS (inet_pton "${CMAKE_EXTRA_INCLUDE_FILES}" HAVE_INET_PTON)
+ENDIF ()
+CHECK_SYMBOL_EXISTS (ioctl "${CMAKE_EXTRA_INCLUDE_FILES}" HAVE_IOCTL)
+CHECK_SYMBOL_EXISTS (ioctlsocket "${CMAKE_EXTRA_INCLUDE_FILES}" HAVE_IOCTLSOCKET)
+CHECK_SYMBOL_EXISTS (IoctlSocket "${CMAKE_EXTRA_INCLUDE_FILES}" HAVE_IOCTLSOCKET_CAMEL)
+CHECK_SYMBOL_EXISTS (recv "${CMAKE_EXTRA_INCLUDE_FILES}" HAVE_RECV)
+CHECK_SYMBOL_EXISTS (recvfrom "${CMAKE_EXTRA_INCLUDE_FILES}" HAVE_RECVFROM)
+CHECK_SYMBOL_EXISTS (send "${CMAKE_EXTRA_INCLUDE_FILES}" HAVE_SEND)
+CHECK_SYMBOL_EXISTS (setsockopt "${CMAKE_EXTRA_INCLUDE_FILES}" HAVE_SETSOCKOPT)
+CHECK_SYMBOL_EXISTS (socket "${CMAKE_EXTRA_INCLUDE_FILES}" HAVE_SOCKET)
+CHECK_SYMBOL_EXISTS (strcasecmp "${CMAKE_EXTRA_INCLUDE_FILES}" HAVE_STRCASECMP)
+CHECK_SYMBOL_EXISTS (strcmpi "${CMAKE_EXTRA_INCLUDE_FILES}" HAVE_STRCMPI)
+CHECK_SYMBOL_EXISTS (strdup "${CMAKE_EXTRA_INCLUDE_FILES}" HAVE_STRDUP)
+CHECK_SYMBOL_EXISTS (stricmp "${CMAKE_EXTRA_INCLUDE_FILES}" HAVE_STRICMP)
+CHECK_SYMBOL_EXISTS (strncasecmp "${CMAKE_EXTRA_INCLUDE_FILES}" HAVE_STRNCASECMP)
+CHECK_SYMBOL_EXISTS (strncmpi "${CMAKE_EXTRA_INCLUDE_FILES}" HAVE_STRNCMPI)
+CHECK_SYMBOL_EXISTS (strnicmp "${CMAKE_EXTRA_INCLUDE_FILES}" HAVE_STRNICMP)
+CHECK_SYMBOL_EXISTS (writev "${CMAKE_EXTRA_INCLUDE_FILES}" HAVE_WRITEV)
+CHECK_SYMBOL_EXISTS (arc4random_buf "${CMAKE_EXTRA_INCLUDE_FILES}" HAVE_ARC4RANDOM_BUF)
+CHECK_SYMBOL_EXISTS (stat "${CMAKE_EXTRA_INCLUDE_FILES}" HAVE_STAT)
+CHECK_SYMBOL_EXISTS (getifaddrs "${CMAKE_EXTRA_INCLUDE_FILES}" HAVE_GETIFADDRS)
+
+# On Android, the system headers may define __system_property_get(), but excluded
+# from libc. We need to perform a link test instead of a header/symbol test.
+CHECK_FUNCTION_EXISTS (__system_property_get HAVE___SYSTEM_PROPERTY_GET)
+
+# Unset temporary data
+SET (CMAKE_EXTRA_INCLUDE_FILES)
+SET (CMAKE_REQUIRED_DEFINITIONS)
+SET (CMAKE_REQUIRED_LIBRARIES)
+
+
+################################################################################
+# Threading Support
+#
+IF (CARES_THREADS)
+ IF (WIN32)
+ # Do nothing, always has threads
+ ELSE ()
+ # Need to prefer pthreads on platforms that may have more threading choices
+ # (e.g. Solaris)
+ SET (CMAKE_THREAD_PREFER_PTHREAD TRUE)
+ FIND_PACKAGE (Threads)
+
+ IF (Threads_FOUND)
+ # Fix solaris9 bug due to libc having pthread_create() stubs that always fail. CMake
+ # doesn't realize that the real pthread functions aren't in libc, so sets the pthread
+ # library CAKE_THREAD_LIBS_INIT variable to blank instead of to the correct "-lpthread".
+ IF (CMAKE_SYSTEM_NAME STREQUAL "SunOS" AND NOT CMAKE_THREAD_LIBS_INIT)
+ SET (CMAKE_THREAD_LIBS_INIT "-lpthread")
+ ENDIF ()
+
+ # PThread functions.
+ CHECK_INCLUDE_FILES (pthread.h HAVE_PTHREAD_H)
+ CHECK_INCLUDE_FILES (pthread_np.h HAVE_PTHREAD_NP_H)
+ CARES_EXTRAINCLUDE_IFSET (HAVE_PTHREAD_H pthread.h)
+ CARES_EXTRAINCLUDE_IFSET (HAVE_PTHREAD_NP_H pthread_np.h)
+ CHECK_SYMBOL_EXISTS (pthread_init "${CMAKE_EXTRA_INCLUDE_FILES}" HAVE_PTHREAD_INIT)
+ # Make sure libcares.pc.cmake knows about thread libraries on static builds
+ LIST (APPEND CARES_DEPENDENT_LIBS ${CMAKE_THREAD_LIBS_INIT})
+ ELSE ()
+ MESSAGE (WARNING "Threading support not found, disabling...")
+ SET (CARES_THREADS OFF)
+ ENDIF ()
+ ENDIF ()
+ENDIF ()
+
+
+
+################################################################################
+# recv, recvfrom, send, getnameinfo, gethostname
+# ARGUMENTS AND RETURN VALUES
+#
+# The AutoTools build tries to be really thorough here. So much so that it
+# takes forever. We really don't want to do that. Lets make some educated
+# guesses based on datatypes we have available, and for others, use some 'sane'
+# defaults. This should be much quicker and nearly as accurate ... and even
+# if not, it probably won't matter in the least.
+
+IF (HAVE_SSIZE_T AND HAVE_SOCKLEN_T AND NOT WIN32)
+ # If we have ssize_t and socklen_t, the API is usually sane and uses ssize_t and size_t for lengths
+ SET (RECVFROM_TYPE_RETV ssize_t)
+ SET (RECVFROM_TYPE_ARG3 size_t)
+ELSE ()
+ SET (RECVFROM_TYPE_RETV int)
+ SET (RECVFROM_TYPE_ARG3 int)
+ENDIF ()
+
+IF (HAVE_TYPE_SOCKET)
+ # If the SOCKET type is defined, it uses socket ... should be windows only
+ SET (RECVFROM_TYPE_ARG1 SOCKET)
+ELSE ()
+ SET (RECVFROM_TYPE_ARG1 int)
+ENDIF()
+
+IF (HAVE_SOCKLEN_T)
+ # If we have socklen_t the APIs pretty much always actually use it
+ SET (RECVFROM_TYPE_ARG6 "socklen_t *")
+ SET (GETNAMEINFO_TYPE_ARG2 socklen_t)
+ SET (GETNAMEINFO_TYPE_ARG46 socklen_t)
+ELSE ()
+ SET (RECVFROM_TYPE_ARG6 "int *")
+ SET (GETNAMEINFO_TYPE_ARG2 int)
+ SET (GETNAMEINFO_TYPE_ARG46 int)
+ENDIF ()
+
+IF (WIN32)
+ SET (RECV_TYPE_ARG2 "char *")
+ELSE ()
+ SET (RECV_TYPE_ARG2 "void *")
+ENDIF ()
+
+# Functions are typically consistent so the equivalent fields map ... equivalently
+SET (RECV_TYPE_RETV ${RECVFROM_TYPE_RETV})
+SET (SEND_TYPE_RETV ${RECVFROM_TYPE_RETV})
+SET (RECV_TYPE_ARG1 ${RECVFROM_TYPE_ARG1})
+SET (RECVFROM_TYPE_ARG2 ${RECV_TYPE_ARG2})
+SET (SEND_TYPE_ARG1 ${RECVFROM_TYPE_ARG1})
+SET (RECV_TYPE_ARG3 ${RECVFROM_TYPE_ARG3})
+SET (SEND_TYPE_ARG3 ${RECVFROM_TYPE_ARG3})
+SET (GETHOSTNAME_TYPE_ARG2 ${RECVFROM_TYPE_ARG3})
+
+# These should always be "sane" values to use always
+SET (RECVFROM_QUAL_ARG5 )
+SET (RECVFROM_TYPE_ARG4 int)
+SET (RECVFROM_TYPE_ARG5 "struct sockaddr *")
+SET (RECV_TYPE_ARG4 int)
+SET (GETNAMEINFO_TYPE_ARG1 "struct sockaddr *")
+SET (GETNAMEINFO_TYPE_ARG7 int)
+SET (SEND_TYPE_ARG2 "void *")
+SET (SEND_TYPE_ARG4 int)
+################################################################################
+
+
+# HAVE_CXX11 ??
+# HAVE_SIG_ATOMIC_T_VOLATILE ??
+
+
+# Set a few variables by hand that C-Ares wants, logically, based on detection
+# data.
+
+IF (HAVE_SOCKLEN_T)
+ Set (CARES_TYPEOF_ARES_SOCKLEN_T "socklen_t")
+ELSE ()
+ Set (CARES_TYPEOF_ARES_SOCKLEN_T "int")
+ENDIF ()
+
+IF (HAVE_SSIZE_T)
+ Set (CARES_TYPEOF_ARES_SSIZE_T "ssize_t")
+ELSE ()
+ IF (WIN32)
+ IF ("${CMAKE_SIZEOF_VOID_P}" EQUAL "8")
+ Set (CARES_TYPEOF_ARES_SSIZE_T "__int64")
+ ELSE ()
+ Set (CARES_TYPEOF_ARES_SSIZE_T "int")
+ ENDIF ()
+ ELSE ()
+ Set (CARES_TYPEOF_ARES_SSIZE_T "long")
+ ENDIF ()
+ENDIF ()
+
+IF (HAVE_FCNTL AND HAVE_O_NONBLOCK)
+ SET (HAVE_FCNTL_O_NONBLOCK 1)
+ENDIF ()
+
+IF (HAVE_IOCTL AND HAVE_FIONBIO)
+ SET (HAVE_IOCTL_FIONBIO 1)
+ENDIF ()
+
+IF (HAVE_IOCTLSOCKET AND HAVE_FIONBIO)
+ SET (HAVE_IOCTLSOCKET_FIONBIO 1)
+ENDIF ()
+
+IF (HAVE_IOCTLSOCKET_CAMEL AND HAVE_FIONBIO)
+ SET (HAVE_IOCTLSOCKET_CAMEL_FIONBIO 1)
+ENDIF ()
+
+IF (HAVE_GETADDRINFO)
+ IF (CMAKE_SYSTEM_NAME STREQUAL "Darwin" OR
+ CMAKE_SYSTEM_NAME STREQUAL "HPUX" OR
+ CMAKE_SYSTEM_NAME STREQUAL "NetBSD" OR
+ CMAKE_SYSTEM_NAME STREQUAL "SunOS" OR
+ CMAKE_SYSTEM_NAME STREQUAL "FreeBSD" OR
+ CMAKE_SYSTEM_NAME STREQUAL "AIX" OR
+ WIN32)
+ SET (HAVE_GETADDRINFO_THREADSAFE 1)
+ ENDIF ()
+ENDIF ()
+
+IF (HAVE_TIME_H AND HAVE_SYS_TIME_H)
+ SET (TIME_WITH_SYS_TIME 1)
+ENDIF ()
+
+IF (HAVE_GETSERVBYPORT_R)
+ # TODO : Should probably autodetect
+ IF (CMAKE_SYSTEM_NAME STREQUAL "SunOS")
+ SET (GETSERVBYPORT_R_ARGS 5)
+ ELSEIF (CMAKE_SYSTEM_NAME STREQUAL "AIX" OR
+ CMAKE_SYSTEM_NAME STREQUAL "OpenBSD" OR
+ HAIKU)
+ SET (GETSERVBYPORT_R_ARGS 4)
+ ELSE ()
+ # Probably linux
+ SET (GETSERVBYPORT_R_ARGS 6)
+ ENDIF ()
+ENDIF ()
+
+IF (HAVE_GETSERVBYNAME_R)
+ # TODO : Should probably autodetect
+ IF (CMAKE_SYSTEM_NAME STREQUAL "SunOS")
+ SET (GETSERVBYNAME_R_ARGS 5)
+ ELSEIF (CMAKE_SYSTEM_NAME STREQUAL "AIX" OR
+ CMAKE_SYSTEM_NAME STREQUAL "OpenBSD" OR
+ HAIKU)
+ SET (GETSERVBYNAME_R_ARGS 4)
+ ELSE ()
+ # Probably linux
+ SET (GETSERVBYNAME_R_ARGS 6)
+ ENDIF ()
+ENDIF ()
+
+# Set some aliases used for ares_build.h
+IF (HAVE_SYS_TYPES_H)
+ SET (CARES_HAVE_SYS_TYPES_H 1)
+ENDIF ()
+IF (HAVE_SYS_RANDOM_H)
+ SET (CARES_HAVE_SYS_RANDOM_H 1)
+ENDIF()
+IF (HAVE_SYS_SOCKET_H)
+ SET (CARES_HAVE_SYS_SOCKET_H 1)
+ENDIF()
+IF (HAVE_WS2TCPIP_H)
+ SET (CARES_HAVE_WS2TCPIP_H 1)
+ENDIF()
+IF (HAVE_WINSOCK2_H)
+ SET (CARES_HAVE_WINSOCK2_H 1)
+ENDIF()
+IF (HAVE_WINDOWS_H)
+ SET (CARES_HAVE_WINDOWS_H 1)
+ENDIF()
+IF (HAVE_ARPA_NAMESER_H)
+ SET (CARES_HAVE_ARPA_NAMESER_H 1)
+ENDIF()
+IF (HAVE_ARPA_NAMESER_COMPAT_H)
+ SET (CARES_HAVE_ARPA_NAMESER_COMPAT_H 1)
+ENDIF()
+
+# Record toplevel CMakeLists.txt path
+set(CARES_TOPLEVEL_DIR "${CMAKE_CURRENT_SOURCE_DIR}")
+
+
+# TRANSFORM_MAKEFILE_INC
+#
+# This function consumes the "Makefile.inc" autotools file, and converts it into
+# "Makefile.inc.cmake", a cmake include file; transforming this:
+#
+# CSOURCES = ares__close_sockets.c \
+# ares__get_hostent.c \
+# ares__read_line.c \
+# ...
+#
+# into this:
+#
+# SET (CSOURCES
+# ares__close_sockets.c
+# ares__get_hostent.c
+# ares__read_line.c
+# ...
+function(TRANSFORM_MAKEFILE_INC INPUT_FILE OUTPUT_FILE)
+ file(READ ${INPUT_FILE} MAKEFILE_INC_TEXT)
+ string(REPLACE "$(top_srcdir)" "\${PROJECT_SOURCE_DIR}" MAKEFILE_INC_TEXT ${MAKEFILE_INC_TEXT})
+ string(REPLACE "$(top_builddir)" "\${PROJECT_BINARY_DIR}" MAKEFILE_INC_TEXT ${MAKEFILE_INC_TEXT})
+
+ string(REGEX REPLACE "\\\\\n" "ß!ß" MAKEFILE_INC_TEXT ${MAKEFILE_INC_TEXT})
+ string(REGEX REPLACE "([a-zA-Z_][a-zA-Z0-9_]*)[\t ]*=[\t ]*([^\n]*)" "SET(\\1 \\2)" MAKEFILE_INC_TEXT ${MAKEFILE_INC_TEXT})
+ string(REPLACE "ß!ß" "\n" MAKEFILE_INC_TEXT ${MAKEFILE_INC_TEXT})
+
+ string(REGEX REPLACE "\\$\\(([a-zA-Z_][a-zA-Z0-9_]*)\\)" "\${\\1}" MAKEFILE_INC_TEXT ${MAKEFILE_INC_TEXT}) # Replace $() with ${}
+ string(REGEX REPLACE "@([a-zA-Z_][a-zA-Z0-9_]*)@" "\${\\1}" MAKEFILE_INC_TEXT ${MAKEFILE_INC_TEXT}) # Replace @@ with ${}, even if that may not be read by CMake scripts.
+ file(WRITE ${OUTPUT_FILE} ${MAKEFILE_INC_TEXT})
+endfunction()
+
+# Directory for includes
+ADD_SUBDIRECTORY (include)
+
+# Directory for lib and tools
+ADD_SUBDIRECTORY (src)
+
+# Docs
+ADD_SUBDIRECTORY (docs)
+
+# Tests
+IF (CARES_BUILD_TESTS OR CARES_BUILD_CONTAINER_TESTS)
+ ENABLE_TESTING ()
+ ADD_SUBDIRECTORY (test)
+ENDIF ()
+
+
+# Export targets
+IF (CARES_INSTALL)
+ SET (CMAKECONFIG_INSTALL_DIR "${CMAKE_INSTALL_LIBDIR}/cmake/${PROJECT_NAME}")
+ INCLUDE (CMakePackageConfigHelpers)
+ CONFIGURE_PACKAGE_CONFIG_FILE (${PROJECT_NAME}-config.cmake.in ${PROJECT_NAME}-config.cmake
+ INSTALL_DESTINATION ${CMAKECONFIG_INSTALL_DIR}
+ PATH_VARS CMAKE_INSTALL_INCLUDEDIR
+ NO_CHECK_REQUIRED_COMPONENTS_MACRO
+ )
+
+ WRITE_BASIC_PACKAGE_VERSION_FILE(${PROJECT_NAME}-config-version.cmake VERSION "${CARES_VERSION}" COMPATIBILITY SameMajorVersion)
+ INSTALL (EXPORT ${PROJECT_NAME}-targets COMPONENT Devel DESTINATION ${CMAKECONFIG_INSTALL_DIR} NAMESPACE ${PROJECT_NAME}::)
+ INSTALL (FILES "${CMAKE_CURRENT_BINARY_DIR}/${PROJECT_NAME}-config.cmake" "${CMAKE_CURRENT_BINARY_DIR}/${PROJECT_NAME}-config-version.cmake" COMPONENT Devel DESTINATION ${CMAKECONFIG_INSTALL_DIR})
+
+ # pkgconfig support
+ IF (NOT CARES_SHARED)
+ FOREACH (LIB ${CARES_DEPENDENT_LIBS})
+ SET (CARES_PRIVATE_LIBS "${CARES_PRIVATE_LIBS} -l${LIB}")
+ ENDFOREACH ()
+ ENDIF ()
+ CONFIGURE_FILE("libcares.pc.cmake" "libcares.pc" @ONLY)
+ INSTALL (FILES "${CMAKE_CURRENT_BINARY_DIR}/libcares.pc" COMPONENT Devel DESTINATION "${CMAKE_INSTALL_LIBDIR}/pkgconfig")
+ENDIF ()
+
+
+# Legacy chain-building variables (provided for compatibility with old code).
+# Don't use these, external code should be updated to refer to the aliases directly (e.g., Cares::cares).
+SET (CARES_FOUND 1 CACHE INTERNAL "CARES LIBRARY FOUND")
+SET (CARES_LIBRARIES ${PROJECT_NAME}::cares CACHE INTERNAL "CARES LIBRARIES")
+
+
+IF (CARES_INSTALL)
+ # Package creation
+ set( CPACK_PACKAGE_NAME ${PROJECT_NAME} )
+ set( CPACK_PACKAGE_VENDOR "Daniel Stenberg" ) # Github project owner
+ set( CPACK_PACKAGE_DESCRIPTION_SUMMARY "A C library for asynchronous DNS requests" )
+ set( CPACK_PACKAGE_HOMEPAGE_URL "https://c-ares.org/" )
+ set( CPACK_PACKAGE_CONTACT "https://c-ares.org/" )
+ set( CPACK_PACKAGE_VERSION_MAJOR ${PROJECT_VERSION_MAJOR} )
+ set( CPACK_PACKAGE_VERSION_MINOR ${PROJECT_VERSION_MINOR} )
+ set( CPACK_PACKAGE_VERSION_PATCH ${PROJECT_VERSION_PATCH} )
+ set( CPACK_PACKAGE_VERSION ${CPACK_PACKAGE_VERSION_MAJOR}.${CPACK_PACKAGE_VERSION_MINOR}.${CPACK_PACKAGE_VERSION_PATCH} )
+ set( CPACK_PACKAGE_INSTALL_DIRECTORY ${PROJECT_NAME} )
+ set( CPACK_RESOURCE_FILE_LICENSE "${CMAKE_CURRENT_SOURCE_DIR}/LICENSE.md" )
+ set( CPACK_RESOURCE_FILE_README "${CMAKE_CURRENT_SOURCE_DIR}/README.md" )
+
+ set( CPACK_COMPONENT_Library_DISPLAY_NAME "c-ares Library" )
+ set( CPACK_COMPONENT_Library_DESCRIPTION "The c-ares binary library." )
+ set( CPACK_COMPONENT_Library_REQUIRED 1 )
+ set( CPACK_COMPONENT_Devel_DISPLAY_NAME "c-ares Development Files" )
+ set( CPACK_COMPONENT_Devel_DESCRIPTION "Development files for compiling against c-ares." )
+ set( CPACK_COMPONENT_Devel_REQUIRED 0 )
+ IF (CARES_BUILD_TOOLS)
+ set( CPACK_COMPONENT_Tools_DISPLAY_NAME "c-ares Tools" )
+ set( CPACK_COMPONENT_Tools_DESCRIPTION "Tools for using c-ares." )
+ set( CPACK_COMPONENT_Tools_REQUIRED 0 )
+ ENDIF ()
+
+ if( ${CMAKE_SYSTEM_NAME} STREQUAL "Linux" )
+
+ if ( "${CPACK_PACKAGE_ARCHITECTURE}" STREQUAL "" )
+ set( CPACK_PACKAGE_ARCHITECTURE "${CMAKE_SYSTEM_PROCESSOR}" )
+ endif()
+ if ( "${CPACK_PACKAGE_ARCHITECTURE}" STREQUAL "" )
+ if ( "${CMAKE_HOST_SYSTEM_NAME}" STREQUAL "Windows" )
+ message( FATAL_ERROR "Failed to determine CPACK_PACKAGE_ARCHITECTURE. Is CMAKE_SYSTEM_PROCESSOR set?" )
+ endif()
+ # Note: the architecture should default to the local architecture, but it
+ # in fact comes up empty. We call `uname -m` to ask the kernel instead.
+ EXECUTE_PROCESS( COMMAND uname -m COMMAND tr -d '\n' OUTPUT_VARIABLE CPACK_PACKAGE_ARCHITECTURE )
+ endif()
+
+ set( CPACK_INCLUDE_TOPLEVEL_DIRECTORY 1 )
+ set( CPACK_PACKAGE_RELEASE 1 )
+
+
+ # RPM - https://cmake.org/cmake/help/latest/cpack_gen/rpm.html
+ set( CPACK_RPM_PACKAGE_RELEASE ${CPACK_PACKAGE_RELEASE} )
+ set( CPACK_RPM_PACKAGE_ARCHITECTURE ${CPACK_PACKAGE_ARCHITECTURE} )
+ set( CPACK_RPM_PACKAGE_DESCRIPTION ${CPACK_PACKAGE_DESCRIPTION_SUMMARY} )
+ set( CPACK_RPM_PACKAGE_URL ${CPACK_PACKAGE_HOMEPAGE_URL} )
+ set( CPACK_RPM_PACKAGE_LICENSE "MIT" )
+ set( CPACK_RPM_COMPONENT_INSTALL 1 )
+ set( CPACK_RPM_COMPRESSION_TYPE "xz" )
+ set( CPACK_RPM_PACKAGE_AUTOPROV 1 )
+
+ set( CPACK_RPM_Library_PACKAGE_SUMMARY ${CPACK_COMPONENT_Library_DESCRIPTION} )
+ set( CPACK_RPM_Library_PACKAGE_ARCHITECTURE ${CPACK_RPM_PACKAGE_ARCHITECTURE} )
+ set( CPACK_RPM_Library_PACKAGE_NAME "libcares${CARES_LIB_VERSION_MAJOR}" )
+ set( CPACK_RPM_Library_FILE_NAME "RPM-DEFAULT" )
+
+ set( CPACK_RPM_Devel_PACKAGE_REQUIRES "cmake >= ${CMAKE_MINIMUM_REQUIRED_VERSION}, ${CPACK_RPM_Library_PACKAGE_NAME} >= ${CPACK_PACKAGE_VERSION}" )
+ set( CPACK_RPM_Devel_PACKAGE_SUMMARY ${CPACK_COMPONENT_Devel_DESCRIPTION} )
+ set( CPACK_RPM_Devel_PACKAGE_ARCHITECTURE ${CPACK_RPM_PACKAGE_ARCHITECTURE} )
+ set( CPACK_RPM_Devel_PACKAGE_NAME "${CPACK_PACKAGE_NAME}-devel" )
+ set( CPACK_RPM_Devel_FILE_NAME "RPM-DEFAULT" )
+
+ IF (CARES_BUILD_TOOLS)
+ set( CPACK_RPM_Tools_PACKAGE_REQUIRES "${CPACK_RPM_Library_PACKAGE_NAME} >= ${CPACK_PACKAGE_VERSION}" )
+ set( CPACK_RPM_Tools_PACKAGE_SUMMARY ${CPACK_COMPONENT_Tools_DESCRIPTION} )
+ set( CPACK_RPM_Tools_PACKAGE_ARCHITECTURE ${CPACK_RPM_PACKAGE_ARCHITECTURE} )
+ set( CPACK_RPM_Tools_PACKAGE_NAME "${CPACK_PACKAGE_NAME}-tools" )
+ set( CPACK_RPM_Tools_FILE_NAME "RPM-DEFAULT" )
+ ENDIF ()
+
+
+ # DEB - https://cmake.org/cmake/help/latest/cpack_gen/deb.html
+ set( CPACK_DEBIAN_PACKAGE_RELEASE ${CPACK_PACKAGE_RELEASE} )
+ set( CPACK_DEBIAN_PACKAGE_HOMEPAGE ${CPACK_PACKAGE_HOMEPAGE_URL} )
+ set( CPACK_DEB_COMPONENT_INSTALL 1 )
+ set( CPACK_DEBIAN_COMPRESSION_TYPE "xz")
+ set( CPACK_DEBIAN_PACKAGE_SHLIBDEPS 1 )
+
+ if ( ${CPACK_PACKAGE_ARCHITECTURE} STREQUAL "x86_64" )
+ set( CPACK_DEBIAN_PACKAGE_ARCHITECTURE "amd64" ) # DEB doesn't always use the kernel's arch name
+ else()
+ set( CPACK_DEBIAN_PACKAGE_ARCHITECTURE ${CPACK_PACKAGE_ARCHITECTURE} )
+ endif()
+
+ set( CPACK_DEBIAN_FILE_NAME "DEB-DEFAULT" ) # Use default naming scheme
+
+ set( CPACK_DEBIAN_LIBRARY_PACKAGE_NAME ${CPACK_RPM_Library_PACKAGE_NAME} )
+
+ set( CPACK_DEBIAN_DEVEL_PACKAGE_DEPENDS "cmake (>= ${CMAKE_MINIMUM_REQUIRED_VERSION}), ${CPACK_DEBIAN_LIBRARY_PACKAGE_NAME} (>= ${CPACK_PACKAGE_VERSION})" )
+ set( CPACK_DEBIAN_DEVEL_PACKAGE_NAME "${CPACK_PACKAGE_NAME}-dev" )
+
+ IF (CARES_BUILD_TOOLS)
+ set( CPACK_DEBIAN_TOOLS_PACKAGE_NAME "${CPACK_PACKAGE_NAME}-tools" )
+ set( CPACK_DEBIAN_TOOLS_PACKAGE_SHLIBDEPS OFF ) # dpkg-shlibdeps can't find the libs we built
+ set( CPACK_DEBIAN_TOOLS_PACKAGE_DEPENDS "${CPACK_DEBIAN_LIBRARY_PACKAGE_NAME} (>= ${CPACK_PACKAGE_VERSION})" )
+ ENDIF ()
+
+ elseif( ${CMAKE_HOST_WIN32} )
+ set( CPACK_NSIS_ENABLE_UNINSTALL_BEFORE_INSTALL ON )
+ set( CPACK_NSIS_DISPLAY_NAME ${PROJECT_NAME} )
+ set( CPACK_NSIS_PACKAGE_NAME ${PROJECT_NAME} )
+ set( CPACK_NSIS_URL_INFO_ABOUT ${CPACK_PACKAGE_HOMEPAGE_URL} )
+ endif()
+
+ # This must always be last!
+ include( CPack )
+ENDIF ()
diff --git a/subprojects/c-ares/CONTRIBUTING.md b/subprojects/c-ares/CONTRIBUTING.md
@@ -0,0 +1,15 @@
+Contributing to c-ares
+======================
+
+To contribute patches to c-ares, please generate a GitHub pull request
+and follow these guidelines:
+
+ - Check that the Travis builds are green for your pull request.
+ - Please update the test suite to add a test case for any new functionality.
+ - Build the library with `./configure --enable-debug --enable-maintainer-mode` and
+ ensure there are no new warnings.
+
+To improve the chances of the c-ares maintainers responding to your request:
+
+ - Also send an email to the mailing list at `c-ares@lists.haxx.se` describing your change.
+ - To follow any associated discussion, please subscribe to the [mailing list](http://lists.haxx.se/listinfo/c-ares).
diff --git a/subprojects/c-ares/GIT-INFO b/subprojects/c-ares/GIT-INFO
@@ -0,0 +1,9 @@
+
+GIT-INFO
+
+This file is only present in git - never in release archives. It is used as a
+sentinel file in buildconf.bat in order to differentiate a git checkout from
+release and daily snapshot archives.
+
+On *nix-like systems, run the ./buildconf script first to generate a fresh
+configure script. This requires autotools to be installed locally.
diff --git a/subprojects/c-ares/INSTALL.md b/subprojects/c-ares/INSTALL.md
@@ -0,0 +1,439 @@
+** This file is adapted from libcurl and not yet fully rewritten for c-ares! **
+
+```
+ ___ __ _ _ __ ___ ___
+ / __| ___ / _` | '__/ _ \/ __|
+ | (_ |___| (_| | | | __/\__ \
+ \___| \__,_|_| \___||___/
+
+ How To Compile
+```
+
+Installing Binary Packages
+==========================
+
+Lots of people download binary distributions of c-ares. This document
+does not describe how to install c-ares using such a binary package.
+This document describes how to compile, build and install c-ares from
+source code.
+
+Building from Git
+=================
+
+If you get your code off a Git repository rather than an official
+release tarball, see the [GIT-INFO](GIT-INFO) file in the root directory
+for specific instructions on how to proceed.
+
+In particular, if not using CMake you will need to run `./buildconf` (Unix) or
+`buildconf.bat` (Windows) to generate build files, and for the former
+you will need a local installation of Autotools. If using CMake the steps are
+the same for both Git and official release tarballs.
+
+AutoTools Build
+===============
+
+### General Information, works on most Unix Platforms (Linux, FreeBSD, etc.)
+
+A normal Unix installation is made in three or four steps (after you've
+unpacked the source archive):
+
+ ./configure
+ make
+ make install
+
+You probably need to be root when doing the last command.
+
+If you have checked out the sources from the git repository, read the
+[GIT-INFO](GIT_INFO) on how to proceed.
+
+Get a full listing of all available configure options by invoking it like:
+
+ ./configure --help
+
+If you want to install c-ares in a different file hierarchy than /usr/local,
+you need to specify that already when running configure:
+
+ ./configure --prefix=/path/to/c-ares/tree
+
+If you happen to have write permission in that directory, you can do `make
+install` without being root. An example of this would be to make a local
+installation in your own home directory:
+
+ ./configure --prefix=$HOME
+ make
+ make install
+
+### More Options
+
+To force configure to use the standard cc compiler if both cc and gcc are
+present, run configure like
+
+ CC=cc ./configure
+ # or
+ env CC=cc ./configure
+
+To force a static library compile, disable the shared library creation
+by running configure like:
+
+ ./configure --disable-shared
+
+If you're a c-ares developer and use gcc, you might want to enable more
+debug options with the `--enable-debug` option.
+
+### Special Cases
+
+Some versions of uClibc require configuring with `CPPFLAGS=-D_GNU_SOURCE=1`
+to get correct large file support.
+
+The Open Watcom C compiler on Linux requires configuring with the variables:
+
+ ./configure CC=owcc AR="$WATCOM/binl/wlib" AR_FLAGS=-q \
+ RANLIB=/bin/true STRIP="$WATCOM/binl/wstrip" CFLAGS=-Wextra
+
+
+### CROSS COMPILE
+
+(This section was graciously brought to us by Jim Duey, with additions by
+Dan Fandrich)
+
+Download and unpack the c-ares package.
+
+`cd` to the new directory. (e.g. `cd c-ares-1.7.6`)
+
+Set environment variables to point to the cross-compile toolchain and call
+configure with any options you need. Be sure and specify the `--host` and
+`--build` parameters at configuration time. The following script is an
+example of cross-compiling for the IBM 405GP PowerPC processor using the
+toolchain from MonteVista for Hardhat Linux.
+
+```sh
+#! /bin/sh
+
+export PATH=$PATH:/opt/hardhat/devkit/ppc/405/bin
+export CPPFLAGS="-I/opt/hardhat/devkit/ppc/405/target/usr/include"
+export AR=ppc_405-ar
+export AS=ppc_405-as
+export LD=ppc_405-ld
+export RANLIB=ppc_405-ranlib
+export CC=ppc_405-gcc
+export NM=ppc_405-nm
+
+./configure --target=powerpc-hardhat-linux \
+ --host=powerpc-hardhat-linux \
+ --build=i586-pc-linux-gnu \
+ --prefix=/opt/hardhat/devkit/ppc/405/target/usr/local \
+ --exec-prefix=/usr/local
+```
+
+You may also need to provide a parameter like `--with-random=/dev/urandom`
+to configure as it cannot detect the presence of a random number
+generating device for a target system. The `--prefix` parameter
+specifies where c-ares will be installed. If `configure` completes
+successfully, do `make` and `make install` as usual.
+
+In some cases, you may be able to simplify the above commands to as
+little as:
+
+ ./configure --host=ARCH-OS
+
+
+### Cygwin (Windows)
+
+Almost identical to the unix installation. Run the configure script in the
+c-ares root with `sh configure`. Make sure you have the sh executable in
+`/bin/` or you'll see the configure fail toward the end.
+
+Run `make`
+
+
+### QNX
+
+(This section was graciously brought to us by David Bentham)
+
+As QNX is targeted for resource constrained environments, the QNX headers
+set conservative limits. This includes the `FD_SETSIZE` macro, set by default
+to 32. Socket descriptors returned within the c-ares library may exceed this,
+resulting in memory faults/SIGSEGV crashes when passed into `select(..)`
+calls using `fd_set` macros.
+
+A good all-round solution to this is to override the default when building
+c-ares, by overriding `CFLAGS` during configure, example:
+
+ # configure CFLAGS='-DFD_SETSIZE=64 -g -O2'
+
+
+### RISC OS
+
+The library can be cross-compiled using gccsdk as follows:
+
+ CC=riscos-gcc AR=riscos-ar RANLIB='riscos-ar -s' ./configure \
+ --host=arm-riscos-aof --without-random --disable-shared
+ make
+
+where `riscos-gcc` and `riscos-ar` are links to the gccsdk tools.
+You can then link your program with `c-ares/lib/.libs/libcares.a`.
+
+
+### Android
+
+Method using a configure cross-compile (tested with Android NDK r7b):
+
+ - prepare the toolchain of the Android NDK for standalone use; this can
+ be done by invoking the script:
+
+ ./tools/make-standalone-toolchain.sh
+
+ which creates a usual cross-compile toolchain. Let's assume that you put
+ this toolchain below `/opt` then invoke configure with something
+ like:
+
+ ```
+ export PATH=/opt/arm-linux-androideabi-4.4.3/bin:$PATH
+ ./configure --host=arm-linux-androideabi [more configure options]
+ make
+ ```
+ - if you want to compile directly from our GIT repo you might run into
+ this issue with older automake stuff:
+
+ ```
+ checking host system type...
+ Invalid configuration `arm-linux-androideabi':
+ system `androideabi' not recognized
+ configure: error: /bin/sh ./config.sub arm-linux-androideabi failed
+ ```
+ this issue can be fixed with using more recent versions of `config.sub`
+ and `config.guess` which can be obtained here:
+ http://git.savannah.gnu.org/gitweb/?p=config.git;a=tree
+ you need to replace your system-own versions which usually can be
+ found in your automake folder:
+ `find /usr -name config.sub`
+
+
+CMake builds
+============
+
+Current releases of c-ares introduce a CMake v3+ build system that has been
+tested on most platforms including Windows, Linux, FreeBSD, macOS, AIX and
+Solaris.
+
+In the most basic form, building with CMake might look like:
+
+```sh
+cd /path/to/cmake/source
+mkdir build
+cd build
+cmake -DCMAKE_BUILD_TYPE=Release -DCMAKE_INSTALL_PREFIX=/usr/local/cares ..
+make
+sudo make install
+```
+
+Options
+-------
+
+Options to CMake are passed on the command line using "-D${OPTION}=${VALUE}".
+The values defined are all boolean and take values like On, Off, True, False.
+
+| Option Name | Description | Default Value |
+|-----------------------------|-----------------------------------------------------------------------|----------------|
+| CARES_STATIC | Build the static library | Off |
+| CARES_SHARED | Build the shared library | On |
+| CARES_INSTALL | Hook in installation, useful to disable if chain building | On |
+| CARES_STATIC_PIC | Build the static library as position-independent | Off |
+| CARES_BUILD_TESTS | Build and run tests | Off |
+| CARES_BUILD_CONTAINER_TESTS | Build and run container tests (implies CARES_BUILD_TESTS, Linux only) | Off |
+| CARES_BUILD_TOOLS | Build tools | On |
+| CARES_SYMBOL_HIDING | Hide private symbols in shared libraries | Off |
+| CARES_THREADS | Build with thread-safety support | On |
+
+Ninja
+-----
+
+Ninja is the next-generation build system meant for generators like CMake that
+heavily parallelize builds. Its use is very similar to the normal build:
+
+```sh
+cd /path/to/cmake/source
+mkdir build
+cd build
+cmake -DCMAKE_BUILD_TYPE=Release -DCMAKE_INSTALL_PREFIX=/usr/local/cares -G "Ninja" ..
+ninja
+sudo ninja install
+```
+
+Windows MSVC Command Line
+-------------------------
+
+```
+cd \path\to\cmake\source
+mkdir build
+cd build
+cmake -DCMAKE_BUILD_TYPE=Release -DCMAKE_INSTALL_PREFIX=C:\cares -G "NMake Makefiles" ..
+nmake
+nmake install
+```
+
+Windows MinGW-w64 Command Line via MSYS
+---------------------------------------
+```
+cd \path\to\cmake\source
+mkdir build
+cd build
+cmake -DCMAKE_BUILD_TYPE=Release -DCMAKE_INSTALL_PREFIX=C:\cares -G "MSYS Makefiles" ..
+make
+make install
+```
+
+
+Platform-specific build systems
+===============================
+
+Win32
+-----
+
+### Building Windows DLLs and C run-time (CRT) linkage issues
+
+As a general rule, building a DLL with static CRT linkage is highly
+discouraged, and intermixing CRTs in the same app is something to
+avoid at any cost.
+
+Reading and comprehension of the following Microsoft Learn article
+is a must for any Windows developer. Especially
+important is full understanding if you are not going to follow the
+advice given above.
+
+ - [Use the C Run-Time](https://learn.microsoft.com/en-us/troubleshoot/developer/visualstudio/cpp/libraries/use-c-run-time)
+
+If your app is misbehaving in some strange way, or it is suffering
+from memory corruption, before asking for further help, please try
+first to rebuild every single library your app uses as well as your
+app using the debug multithreaded dynamic C runtime.
+
+
+### MingW32
+
+Make sure that MinGW32's bin dir is in the search path, for example:
+
+ set PATH=c:\mingw32\bin;%PATH%
+
+then run 'make -f Makefile.m32' in the root dir.
+
+
+### MSVC 6 caveats
+
+If you use MSVC 6 it is required that you use the February 2003 edition PSDK:
+http://www.microsoft.com/msdownload/platformsdk/sdkupdate/psdk-full.htm
+
+
+### MSVC from command line
+
+Run the `vcvars32.bat` file to get a proper environment. The
+`vcvars32.bat` file is part of the Microsoft development environment and
+you may find it in `C:\Program Files\Microsoft Visual Studio\vc98\bin`
+provided that you installed Visual C/C++ 6 in the default directory.
+
+Further details in [README.msvc](README.msvc)
+
+
+### Important static c-ares usage note
+
+When building an application that uses the static c-ares library, you must
+add `-DCARES_STATICLIB` to your `CFLAGS`. Otherwise the linker will look for
+dynamic import symbols.
+
+
+IBM OS/2
+--------
+
+Building under OS/2 is not much different from building under unix.
+You need:
+
+ - emx 0.9d
+ - GNU make
+ - GNU patch
+ - ksh
+ - GNU bison
+ - GNU file utilities
+ - GNU sed
+ - autoconf 2.13
+
+If during the linking you get an error about `_errno` being an undefined
+symbol referenced from the text segment, you need to add `-D__ST_MT_ERRNO__`
+in your definitions.
+
+If you're getting huge binaries, probably your makefiles have the `-g` in
+`CFLAGS`.
+
+
+NetWare
+-------
+
+To compile `libcares.a` / `libcares.lib` you need:
+
+ - either any gcc / nlmconv, or CodeWarrior 7 PDK 4 or later.
+ - gnu make and awk running on the platform you compile on;
+ native Win32 versions can be downloaded from:
+ http://www.gknw.net/development/prgtools/
+ - recent Novell LibC SDK available from:
+ http://developer.novell.com/ndk/libc.htm
+ - or recent Novell CLib SDK available from:
+ http://developer.novell.com/ndk/clib.htm
+
+Set a search path to your compiler, linker and tools; on Linux make
+sure that the var `OSTYPE` contains the string 'linux'; set the var
+`NDKBASE` to point to the base of your Novell NDK; and then type
+`make -f Makefile.netware` from the top source directory;
+
+VCPKG
+=====
+
+You can build and install c-ares using [vcpkg](https://github.com/Microsoft/vcpkg/) dependency manager:
+
+```sh or powershell
+ git clone https://github.com/Microsoft/vcpkg.git
+ cd vcpkg
+ ./bootstrap-vcpkg.sh
+ ./vcpkg integrate install
+ ./vcpkg install c-ares
+```
+
+The c-ares port in vcpkg is kept up to date by Microsoft team members and community contributors. If the version is out of date, please [create an issue or pull request](https://github.com/Microsoft/vcpkg) on the vcpkg repository.
+
+WATCOM
+=====
+
+To build c-ares with OpenWatcom, you need to have at least version 1.9 of OpenWatcom. You can get the latest version from [http://openwatcom.org/ftp/install/](http://openwatcom.org/ftp/install/). Install the version that corresponds to your current host platform.
+
+After installing OpenWatcom, open a new command prompt and execute the following commands:
+
+```
+ cd \path\to\cmake\source
+ buildconf.bat
+ wmake -u -f Makefile.Watcom
+```
+
+After running wmake, you should get adig.exe, ahost.exe, and the static and dynamic versions of libcares.
+
+PORTS
+=====
+
+This is a probably incomplete list of known hardware and operating systems
+that c-ares has been compiled for. If you know a system c-ares compiles and
+runs on, that isn't listed, please let us know!
+
+ - Alpha Tru64 v5.0 5.1
+ - ARM Android 1.5, 2.1, 2.3
+ - MIPS IRIX 6.2, 6.5
+ - Power AIX 3.2.5, 4.2, 4.3.1, 4.3.2, 5.1, 5.2
+ - i386 Linux 1.3, 2.0, 2.2, 2.3, 2.4, 2.6
+ - i386 Novell NetWare
+ - i386 Windows 95, 98, ME, NT, 2000, XP, 2003
+ - x86_64 Linux
+
+
+Useful URLs
+===========
+
+ - c-ares: https://c-ares.org/
+ - MingW: http://www.mingw.org/
+ - MinGW-w64: http://mingw-w64.sourceforge.net/
+ - OpenWatcom: http://www.openwatcom.org/
diff --git a/subprojects/c-ares/LICENSE.md b/subprojects/c-ares/LICENSE.md
@@ -0,0 +1,27 @@
+# c-ares license
+
+MIT License
+
+
+Copyright (c) 1998 Massachusetts Institute of Technology
+Copyright (c) 2007 - 2023 Daniel Stenberg with many contributors, see AUTHORS
+file.
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of
+this software and associated documentation files (the "Software"), to deal in
+the Software without restriction, including without limitation the rights to
+use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of
+the Software, and to permit persons to whom the Software is furnished to do so,
+subject to the following conditions:
+
+The above copyright notice and this permission notice (including the next
+paragraph) shall be included in all copies or substantial portions of the
+Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
diff --git a/subprojects/c-ares/LICENSES/Autoconf-exception-3.0.txt b/subprojects/c-ares/LICENSES/Autoconf-exception-3.0.txt
@@ -0,0 +1,25 @@
+AUTOCONF CONFIGURE SCRIPT EXCEPTION
+
+Version 3.0, 18 August 2009
+
+Copyright © 2009 Free Software Foundation, Inc. >http://fsf.org/<
+
+Everyone is permitted to copy and distribute verbatim copies of this license document, but changing it is not allowed.
+
+This Exception is an additional permission under section 7 of the GNU General Public License, version 3 ("GPLv3"). It applies to a given file that bears a notice placed by the copyright holder of the file stating that the file is governed by GPLv3 along with this Exception.
+
+The purpose of this Exception is to allow distribution of Autoconf's typical output under terms of the recipient's choice (including proprietary).
+
+ 0. Definitions.
+
+ "Covered Code" is the source or object code of a version of Autoconf that is a covered work under this License.
+
+ "Normally Copied Code" for a version of Autoconf means all parts of its Covered Code which that version can copy from its code (i.e., not from its input file) into its minimally verbose, non-debugging and non-tracing output.
+
+ "Ineligible Code" is Covered Code that is not Normally Copied Code.
+ 1. Grant of Additional Permission.
+
+ You have permission to propagate output of Autoconf, even if such propagation would otherwise violate the terms of GPLv3. However, if by modifying Autoconf you cause any Ineligible Code of the version you received to become Normally Copied Code of your modified version, then you void this Exception for the resulting covered work. If you convey that resulting covered work, you must remove this Exception in accordance with the second paragraph of Section 7 of GPLv3.
+ 2. No Weakening of Autoconf Copyleft.
+
+ The availability of this Exception does not imply any general presumption that third-party software is unaffected by the copyleft requirements of the license of Autoconf.
diff --git a/subprojects/c-ares/LICENSES/BSD-3-Clause.txt b/subprojects/c-ares/LICENSES/BSD-3-Clause.txt
@@ -0,0 +1,11 @@
+Copyright (c) <year> <owner>.
+
+Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met:
+
+1. Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer.
+
+2. Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution.
+
+3. Neither the name of the copyright holder nor the names of its contributors may be used to endorse or promote products derived from this software without specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
diff --git a/subprojects/c-ares/LICENSES/FSFAP.txt b/subprojects/c-ares/LICENSES/FSFAP.txt
@@ -0,0 +1,4 @@
+Copying and distribution of this file, with or without modification, are
+permitted in any medium without royalty provided the copyright notice
+and this notice are preserved. This file is offered as-is, without any
+warranty.
diff --git a/subprojects/c-ares/LICENSES/GPL-3.0-or-later.txt b/subprojects/c-ares/LICENSES/GPL-3.0-or-later.txt
@@ -0,0 +1,674 @@
+ GNU GENERAL PUBLIC LICENSE
+ Version 3, 29 June 2007
+
+ Copyright (C) 2007 Free Software Foundation, Inc. <https://fsf.org/>
+ Everyone is permitted to copy and distribute verbatim copies
+ of this license document, but changing it is not allowed.
+
+ Preamble
+
+ The GNU General Public License is a free, copyleft license for
+software and other kinds of works.
+
+ The licenses for most software and other practical works are designed
+to take away your freedom to share and change the works. By contrast,
+the GNU General Public License is intended to guarantee your freedom to
+share and change all versions of a program--to make sure it remains free
+software for all its users. We, the Free Software Foundation, use the
+GNU General Public License for most of our software; it applies also to
+any other work released this way by its authors. You can apply it to
+your programs, too.
+
+ When we speak of free software, we are referring to freedom, not
+price. Our General Public Licenses are designed to make sure that you
+have the freedom to distribute copies of free software (and charge for
+them if you wish), that you receive source code or can get it if you
+want it, that you can change the software or use pieces of it in new
+free programs, and that you know you can do these things.
+
+ To protect your rights, we need to prevent others from denying you
+these rights or asking you to surrender the rights. Therefore, you have
+certain responsibilities if you distribute copies of the software, or if
+you modify it: responsibilities to respect the freedom of others.
+
+ For example, if you distribute copies of such a program, whether
+gratis or for a fee, you must pass on to the recipients the same
+freedoms that you received. You must make sure that they, too, receive
+or can get the source code. And you must show them these terms so they
+know their rights.
+
+ Developers that use the GNU GPL protect your rights with two steps:
+(1) assert copyright on the software, and (2) offer you this License
+giving you legal permission to copy, distribute and/or modify it.
+
+ For the developers' and authors' protection, the GPL clearly explains
+that there is no warranty for this free software. For both users' and
+authors' sake, the GPL requires that modified versions be marked as
+changed, so that their problems will not be attributed erroneously to
+authors of previous versions.
+
+ Some devices are designed to deny users access to install or run
+modified versions of the software inside them, although the manufacturer
+can do so. This is fundamentally incompatible with the aim of
+protecting users' freedom to change the software. The systematic
+pattern of such abuse occurs in the area of products for individuals to
+use, which is precisely where it is most unacceptable. Therefore, we
+have designed this version of the GPL to prohibit the practice for those
+products. If such problems arise substantially in other domains, we
+stand ready to extend this provision to those domains in future versions
+of the GPL, as needed to protect the freedom of users.
+
+ Finally, every program is threatened constantly by software patents.
+States should not allow patents to restrict development and use of
+software on general-purpose computers, but in those that do, we wish to
+avoid the special danger that patents applied to a free program could
+make it effectively proprietary. To prevent this, the GPL assures that
+patents cannot be used to render the program non-free.
+
+ The precise terms and conditions for copying, distribution and
+modification follow.
+
+ TERMS AND CONDITIONS
+
+ 0. Definitions.
+
+ "This License" refers to version 3 of the GNU General Public License.
+
+ "Copyright" also means copyright-like laws that apply to other kinds of
+works, such as semiconductor masks.
+
+ "The Program" refers to any copyrightable work licensed under this
+License. Each licensee is addressed as "you". "Licensees" and
+"recipients" may be individuals or organizations.
+
+ To "modify" a work means to copy from or adapt all or part of the work
+in a fashion requiring copyright permission, other than the making of an
+exact copy. The resulting work is called a "modified version" of the
+earlier work or a work "based on" the earlier work.
+
+ A "covered work" means either the unmodified Program or a work based
+on the Program.
+
+ To "propagate" a work means to do anything with it that, without
+permission, would make you directly or secondarily liable for
+infringement under applicable copyright law, except executing it on a
+computer or modifying a private copy. Propagation includes copying,
+distribution (with or without modification), making available to the
+public, and in some countries other activities as well.
+
+ To "convey" a work means any kind of propagation that enables other
+parties to make or receive copies. Mere interaction with a user through
+a computer network, with no transfer of a copy, is not conveying.
+
+ An interactive user interface displays "Appropriate Legal Notices"
+to the extent that it includes a convenient and prominently visible
+feature that (1) displays an appropriate copyright notice, and (2)
+tells the user that there is no warranty for the work (except to the
+extent that warranties are provided), that licensees may convey the
+work under this License, and how to view a copy of this License. If
+the interface presents a list of user commands or options, such as a
+menu, a prominent item in the list meets this criterion.
+
+ 1. Source Code.
+
+ The "source code" for a work means the preferred form of the work
+for making modifications to it. "Object code" means any non-source
+form of a work.
+
+ A "Standard Interface" means an interface that either is an official
+standard defined by a recognized standards body, or, in the case of
+interfaces specified for a particular programming language, one that
+is widely used among developers working in that language.
+
+ The "System Libraries" of an executable work include anything, other
+than the work as a whole, that (a) is included in the normal form of
+packaging a Major Component, but which is not part of that Major
+Component, and (b) serves only to enable use of the work with that
+Major Component, or to implement a Standard Interface for which an
+implementation is available to the public in source code form. A
+"Major Component", in this context, means a major essential component
+(kernel, window system, and so on) of the specific operating system
+(if any) on which the executable work runs, or a compiler used to
+produce the work, or an object code interpreter used to run it.
+
+ The "Corresponding Source" for a work in object code form means all
+the source code needed to generate, install, and (for an executable
+work) run the object code and to modify the work, including scripts to
+control those activities. However, it does not include the work's
+System Libraries, or general-purpose tools or generally available free
+programs which are used unmodified in performing those activities but
+which are not part of the work. For example, Corresponding Source
+includes interface definition files associated with source files for
+the work, and the source code for shared libraries and dynamically
+linked subprograms that the work is specifically designed to require,
+such as by intimate data communication or control flow between those
+subprograms and other parts of the work.
+
+ The Corresponding Source need not include anything that users
+can regenerate automatically from other parts of the Corresponding
+Source.
+
+ The Corresponding Source for a work in source code form is that
+same work.
+
+ 2. Basic Permissions.
+
+ All rights granted under this License are granted for the term of
+copyright on the Program, and are irrevocable provided the stated
+conditions are met. This License explicitly affirms your unlimited
+permission to run the unmodified Program. The output from running a
+covered work is covered by this License only if the output, given its
+content, constitutes a covered work. This License acknowledges your
+rights of fair use or other equivalent, as provided by copyright law.
+
+ You may make, run and propagate covered works that you do not
+convey, without conditions so long as your license otherwise remains
+in force. You may convey covered works to others for the sole purpose
+of having them make modifications exclusively for you, or provide you
+with facilities for running those works, provided that you comply with
+the terms of this License in conveying all material for which you do
+not control copyright. Those thus making or running the covered works
+for you must do so exclusively on your behalf, under your direction
+and control, on terms that prohibit them from making any copies of
+your copyrighted material outside their relationship with you.
+
+ Conveying under any other circumstances is permitted solely under
+the conditions stated below. Sublicensing is not allowed; section 10
+makes it unnecessary.
+
+ 3. Protecting Users' Legal Rights From Anti-Circumvention Law.
+
+ No covered work shall be deemed part of an effective technological
+measure under any applicable law fulfilling obligations under article
+11 of the WIPO copyright treaty adopted on 20 December 1996, or
+similar laws prohibiting or restricting circumvention of such
+measures.
+
+ When you convey a covered work, you waive any legal power to forbid
+circumvention of technological measures to the extent such circumvention
+is effected by exercising rights under this License with respect to
+the covered work, and you disclaim any intention to limit operation or
+modification of the work as a means of enforcing, against the work's
+users, your or third parties' legal rights to forbid circumvention of
+technological measures.
+
+ 4. Conveying Verbatim Copies.
+
+ You may convey verbatim copies of the Program's source code as you
+receive it, in any medium, provided that you conspicuously and
+appropriately publish on each copy an appropriate copyright notice;
+keep intact all notices stating that this License and any
+non-permissive terms added in accord with section 7 apply to the code;
+keep intact all notices of the absence of any warranty; and give all
+recipients a copy of this License along with the Program.
+
+ You may charge any price or no price for each copy that you convey,
+and you may offer support or warranty protection for a fee.
+
+ 5. Conveying Modified Source Versions.
+
+ You may convey a work based on the Program, or the modifications to
+produce it from the Program, in the form of source code under the
+terms of section 4, provided that you also meet all of these conditions:
+
+ a) The work must carry prominent notices stating that you modified
+ it, and giving a relevant date.
+
+ b) The work must carry prominent notices stating that it is
+ released under this License and any conditions added under section
+ 7. This requirement modifies the requirement in section 4 to
+ "keep intact all notices".
+
+ c) You must license the entire work, as a whole, under this
+ License to anyone who comes into possession of a copy. This
+ License will therefore apply, along with any applicable section 7
+ additional terms, to the whole of the work, and all its parts,
+ regardless of how they are packaged. This License gives no
+ permission to license the work in any other way, but it does not
+ invalidate such permission if you have separately received it.
+
+ d) If the work has interactive user interfaces, each must display
+ Appropriate Legal Notices; however, if the Program has interactive
+ interfaces that do not display Appropriate Legal Notices, your
+ work need not make them do so.
+
+ A compilation of a covered work with other separate and independent
+works, which are not by their nature extensions of the covered work,
+and which are not combined with it such as to form a larger program,
+in or on a volume of a storage or distribution medium, is called an
+"aggregate" if the compilation and its resulting copyright are not
+used to limit the access or legal rights of the compilation's users
+beyond what the individual works permit. Inclusion of a covered work
+in an aggregate does not cause this License to apply to the other
+parts of the aggregate.
+
+ 6. Conveying Non-Source Forms.
+
+ You may convey a covered work in object code form under the terms
+of sections 4 and 5, provided that you also convey the
+machine-readable Corresponding Source under the terms of this License,
+in one of these ways:
+
+ a) Convey the object code in, or embodied in, a physical product
+ (including a physical distribution medium), accompanied by the
+ Corresponding Source fixed on a durable physical medium
+ customarily used for software interchange.
+
+ b) Convey the object code in, or embodied in, a physical product
+ (including a physical distribution medium), accompanied by a
+ written offer, valid for at least three years and valid for as
+ long as you offer spare parts or customer support for that product
+ model, to give anyone who possesses the object code either (1) a
+ copy of the Corresponding Source for all the software in the
+ product that is covered by this License, on a durable physical
+ medium customarily used for software interchange, for a price no
+ more than your reasonable cost of physically performing this
+ conveying of source, or (2) access to copy the
+ Corresponding Source from a network server at no charge.
+
+ c) Convey individual copies of the object code with a copy of the
+ written offer to provide the Corresponding Source. This
+ alternative is allowed only occasionally and noncommercially, and
+ only if you received the object code with such an offer, in accord
+ with subsection 6b.
+
+ d) Convey the object code by offering access from a designated
+ place (gratis or for a charge), and offer equivalent access to the
+ Corresponding Source in the same way through the same place at no
+ further charge. You need not require recipients to copy the
+ Corresponding Source along with the object code. If the place to
+ copy the object code is a network server, the Corresponding Source
+ may be on a different server (operated by you or a third party)
+ that supports equivalent copying facilities, provided you maintain
+ clear directions next to the object code saying where to find the
+ Corresponding Source. Regardless of what server hosts the
+ Corresponding Source, you remain obligated to ensure that it is
+ available for as long as needed to satisfy these requirements.
+
+ e) Convey the object code using peer-to-peer transmission, provided
+ you inform other peers where the object code and Corresponding
+ Source of the work are being offered to the general public at no
+ charge under subsection 6d.
+
+ A separable portion of the object code, whose source code is excluded
+from the Corresponding Source as a System Library, need not be
+included in conveying the object code work.
+
+ A "User Product" is either (1) a "consumer product", which means any
+tangible personal property which is normally used for personal, family,
+or household purposes, or (2) anything designed or sold for incorporation
+into a dwelling. In determining whether a product is a consumer product,
+doubtful cases shall be resolved in favor of coverage. For a particular
+product received by a particular user, "normally used" refers to a
+typical or common use of that class of product, regardless of the status
+of the particular user or of the way in which the particular user
+actually uses, or expects or is expected to use, the product. A product
+is a consumer product regardless of whether the product has substantial
+commercial, industrial or non-consumer uses, unless such uses represent
+the only significant mode of use of the product.
+
+ "Installation Information" for a User Product means any methods,
+procedures, authorization keys, or other information required to install
+and execute modified versions of a covered work in that User Product from
+a modified version of its Corresponding Source. The information must
+suffice to ensure that the continued functioning of the modified object
+code is in no case prevented or interfered with solely because
+modification has been made.
+
+ If you convey an object code work under this section in, or with, or
+specifically for use in, a User Product, and the conveying occurs as
+part of a transaction in which the right of possession and use of the
+User Product is transferred to the recipient in perpetuity or for a
+fixed term (regardless of how the transaction is characterized), the
+Corresponding Source conveyed under this section must be accompanied
+by the Installation Information. But this requirement does not apply
+if neither you nor any third party retains the ability to install
+modified object code on the User Product (for example, the work has
+been installed in ROM).
+
+ The requirement to provide Installation Information does not include a
+requirement to continue to provide support service, warranty, or updates
+for a work that has been modified or installed by the recipient, or for
+the User Product in which it has been modified or installed. Access to a
+network may be denied when the modification itself materially and
+adversely affects the operation of the network or violates the rules and
+protocols for communication across the network.
+
+ Corresponding Source conveyed, and Installation Information provided,
+in accord with this section must be in a format that is publicly
+documented (and with an implementation available to the public in
+source code form), and must require no special password or key for
+unpacking, reading or copying.
+
+ 7. Additional Terms.
+
+ "Additional permissions" are terms that supplement the terms of this
+License by making exceptions from one or more of its conditions.
+Additional permissions that are applicable to the entire Program shall
+be treated as though they were included in this License, to the extent
+that they are valid under applicable law. If additional permissions
+apply only to part of the Program, that part may be used separately
+under those permissions, but the entire Program remains governed by
+this License without regard to the additional permissions.
+
+ When you convey a copy of a covered work, you may at your option
+remove any additional permissions from that copy, or from any part of
+it. (Additional permissions may be written to require their own
+removal in certain cases when you modify the work.) You may place
+additional permissions on material, added by you to a covered work,
+for which you have or can give appropriate copyright permission.
+
+ Notwithstanding any other provision of this License, for material you
+add to a covered work, you may (if authorized by the copyright holders of
+that material) supplement the terms of this License with terms:
+
+ a) Disclaiming warranty or limiting liability differently from the
+ terms of sections 15 and 16 of this License; or
+
+ b) Requiring preservation of specified reasonable legal notices or
+ author attributions in that material or in the Appropriate Legal
+ Notices displayed by works containing it; or
+
+ c) Prohibiting misrepresentation of the origin of that material, or
+ requiring that modified versions of such material be marked in
+ reasonable ways as different from the original version; or
+
+ d) Limiting the use for publicity purposes of names of licensors or
+ authors of the material; or
+
+ e) Declining to grant rights under trademark law for use of some
+ trade names, trademarks, or service marks; or
+
+ f) Requiring indemnification of licensors and authors of that
+ material by anyone who conveys the material (or modified versions of
+ it) with contractual assumptions of liability to the recipient, for
+ any liability that these contractual assumptions directly impose on
+ those licensors and authors.
+
+ All other non-permissive additional terms are considered "further
+restrictions" within the meaning of section 10. If the Program as you
+received it, or any part of it, contains a notice stating that it is
+governed by this License along with a term that is a further
+restriction, you may remove that term. If a license document contains
+a further restriction but permits relicensing or conveying under this
+License, you may add to a covered work material governed by the terms
+of that license document, provided that the further restriction does
+not survive such relicensing or conveying.
+
+ If you add terms to a covered work in accord with this section, you
+must place, in the relevant source files, a statement of the
+additional terms that apply to those files, or a notice indicating
+where to find the applicable terms.
+
+ Additional terms, permissive or non-permissive, may be stated in the
+form of a separately written license, or stated as exceptions;
+the above requirements apply either way.
+
+ 8. Termination.
+
+ You may not propagate or modify a covered work except as expressly
+provided under this License. Any attempt otherwise to propagate or
+modify it is void, and will automatically terminate your rights under
+this License (including any patent licenses granted under the third
+paragraph of section 11).
+
+ However, if you cease all violation of this License, then your
+license from a particular copyright holder is reinstated (a)
+provisionally, unless and until the copyright holder explicitly and
+finally terminates your license, and (b) permanently, if the copyright
+holder fails to notify you of the violation by some reasonable means
+prior to 60 days after the cessation.
+
+ Moreover, your license from a particular copyright holder is
+reinstated permanently if the copyright holder notifies you of the
+violation by some reasonable means, this is the first time you have
+received notice of violation of this License (for any work) from that
+copyright holder, and you cure the violation prior to 30 days after
+your receipt of the notice.
+
+ Termination of your rights under this section does not terminate the
+licenses of parties who have received copies or rights from you under
+this License. If your rights have been terminated and not permanently
+reinstated, you do not qualify to receive new licenses for the same
+material under section 10.
+
+ 9. Acceptance Not Required for Having Copies.
+
+ You are not required to accept this License in order to receive or
+run a copy of the Program. Ancillary propagation of a covered work
+occurring solely as a consequence of using peer-to-peer transmission
+to receive a copy likewise does not require acceptance. However,
+nothing other than this License grants you permission to propagate or
+modify any covered work. These actions infringe copyright if you do
+not accept this License. Therefore, by modifying or propagating a
+covered work, you indicate your acceptance of this License to do so.
+
+ 10. Automatic Licensing of Downstream Recipients.
+
+ Each time you convey a covered work, the recipient automatically
+receives a license from the original licensors, to run, modify and
+propagate that work, subject to this License. You are not responsible
+for enforcing compliance by third parties with this License.
+
+ An "entity transaction" is a transaction transferring control of an
+organization, or substantially all assets of one, or subdividing an
+organization, or merging organizations. If propagation of a covered
+work results from an entity transaction, each party to that
+transaction who receives a copy of the work also receives whatever
+licenses to the work the party's predecessor in interest had or could
+give under the previous paragraph, plus a right to possession of the
+Corresponding Source of the work from the predecessor in interest, if
+the predecessor has it or can get it with reasonable efforts.
+
+ You may not impose any further restrictions on the exercise of the
+rights granted or affirmed under this License. For example, you may
+not impose a license fee, royalty, or other charge for exercise of
+rights granted under this License, and you may not initiate litigation
+(including a cross-claim or counterclaim in a lawsuit) alleging that
+any patent claim is infringed by making, using, selling, offering for
+sale, or importing the Program or any portion of it.
+
+ 11. Patents.
+
+ A "contributor" is a copyright holder who authorizes use under this
+License of the Program or a work on which the Program is based. The
+work thus licensed is called the contributor's "contributor version".
+
+ A contributor's "essential patent claims" are all patent claims
+owned or controlled by the contributor, whether already acquired or
+hereafter acquired, that would be infringed by some manner, permitted
+by this License, of making, using, or selling its contributor version,
+but do not include claims that would be infringed only as a
+consequence of further modification of the contributor version. For
+purposes of this definition, "control" includes the right to grant
+patent sublicenses in a manner consistent with the requirements of
+this License.
+
+ Each contributor grants you a non-exclusive, worldwide, royalty-free
+patent license under the contributor's essential patent claims, to
+make, use, sell, offer for sale, import and otherwise run, modify and
+propagate the contents of its contributor version.
+
+ In the following three paragraphs, a "patent license" is any express
+agreement or commitment, however denominated, not to enforce a patent
+(such as an express permission to practice a patent or covenant not to
+sue for patent infringement). To "grant" such a patent license to a
+party means to make such an agreement or commitment not to enforce a
+patent against the party.
+
+ If you convey a covered work, knowingly relying on a patent license,
+and the Corresponding Source of the work is not available for anyone
+to copy, free of charge and under the terms of this License, through a
+publicly available network server or other readily accessible means,
+then you must either (1) cause the Corresponding Source to be so
+available, or (2) arrange to deprive yourself of the benefit of the
+patent license for this particular work, or (3) arrange, in a manner
+consistent with the requirements of this License, to extend the patent
+license to downstream recipients. "Knowingly relying" means you have
+actual knowledge that, but for the patent license, your conveying the
+covered work in a country, or your recipient's use of the covered work
+in a country, would infringe one or more identifiable patents in that
+country that you have reason to believe are valid.
+
+ If, pursuant to or in connection with a single transaction or
+arrangement, you convey, or propagate by procuring conveyance of, a
+covered work, and grant a patent license to some of the parties
+receiving the covered work authorizing them to use, propagate, modify
+or convey a specific copy of the covered work, then the patent license
+you grant is automatically extended to all recipients of the covered
+work and works based on it.
+
+ A patent license is "discriminatory" if it does not include within
+the scope of its coverage, prohibits the exercise of, or is
+conditioned on the non-exercise of one or more of the rights that are
+specifically granted under this License. You may not convey a covered
+work if you are a party to an arrangement with a third party that is
+in the business of distributing software, under which you make payment
+to the third party based on the extent of your activity of conveying
+the work, and under which the third party grants, to any of the
+parties who would receive the covered work from you, a discriminatory
+patent license (a) in connection with copies of the covered work
+conveyed by you (or copies made from those copies), or (b) primarily
+for and in connection with specific products or compilations that
+contain the covered work, unless you entered into that arrangement,
+or that patent license was granted, prior to 28 March 2007.
+
+ Nothing in this License shall be construed as excluding or limiting
+any implied license or other defenses to infringement that may
+otherwise be available to you under applicable patent law.
+
+ 12. No Surrender of Others' Freedom.
+
+ If conditions are imposed on you (whether by court order, agreement or
+otherwise) that contradict the conditions of this License, they do not
+excuse you from the conditions of this License. If you cannot convey a
+covered work so as to satisfy simultaneously your obligations under this
+License and any other pertinent obligations, then as a consequence you may
+not convey it at all. For example, if you agree to terms that obligate you
+to collect a royalty for further conveying from those to whom you convey
+the Program, the only way you could satisfy both those terms and this
+License would be to refrain entirely from conveying the Program.
+
+ 13. Use with the GNU Affero General Public License.
+
+ Notwithstanding any other provision of this License, you have
+permission to link or combine any covered work with a work licensed
+under version 3 of the GNU Affero General Public License into a single
+combined work, and to convey the resulting work. The terms of this
+License will continue to apply to the part which is the covered work,
+but the special requirements of the GNU Affero General Public License,
+section 13, concerning interaction through a network will apply to the
+combination as such.
+
+ 14. Revised Versions of this License.
+
+ The Free Software Foundation may publish revised and/or new versions of
+the GNU General Public License from time to time. Such new versions will
+be similar in spirit to the present version, but may differ in detail to
+address new problems or concerns.
+
+ Each version is given a distinguishing version number. If the
+Program specifies that a certain numbered version of the GNU General
+Public License "or any later version" applies to it, you have the
+option of following the terms and conditions either of that numbered
+version or of any later version published by the Free Software
+Foundation. If the Program does not specify a version number of the
+GNU General Public License, you may choose any version ever published
+by the Free Software Foundation.
+
+ If the Program specifies that a proxy can decide which future
+versions of the GNU General Public License can be used, that proxy's
+public statement of acceptance of a version permanently authorizes you
+to choose that version for the Program.
+
+ Later license versions may give you additional or different
+permissions. However, no additional obligations are imposed on any
+author or copyright holder as a result of your choosing to follow a
+later version.
+
+ 15. Disclaimer of Warranty.
+
+ THERE IS NO WARRANTY FOR THE PROGRAM, TO THE EXTENT PERMITTED BY
+APPLICABLE LAW. EXCEPT WHEN OTHERWISE STATED IN WRITING THE COPYRIGHT
+HOLDERS AND/OR OTHER PARTIES PROVIDE THE PROGRAM "AS IS" WITHOUT WARRANTY
+OF ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING, BUT NOT LIMITED TO,
+THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
+PURPOSE. THE ENTIRE RISK AS TO THE QUALITY AND PERFORMANCE OF THE PROGRAM
+IS WITH YOU. SHOULD THE PROGRAM PROVE DEFECTIVE, YOU ASSUME THE COST OF
+ALL NECESSARY SERVICING, REPAIR OR CORRECTION.
+
+ 16. Limitation of Liability.
+
+ IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING
+WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MODIFIES AND/OR CONVEYS
+THE PROGRAM AS PERMITTED ABOVE, BE LIABLE TO YOU FOR DAMAGES, INCLUDING ANY
+GENERAL, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING OUT OF THE
+USE OR INABILITY TO USE THE PROGRAM (INCLUDING BUT NOT LIMITED TO LOSS OF
+DATA OR DATA BEING RENDERED INACCURATE OR LOSSES SUSTAINED BY YOU OR THIRD
+PARTIES OR A FAILURE OF THE PROGRAM TO OPERATE WITH ANY OTHER PROGRAMS),
+EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE POSSIBILITY OF
+SUCH DAMAGES.
+
+ 17. Interpretation of Sections 15 and 16.
+
+ If the disclaimer of warranty and limitation of liability provided
+above cannot be given local legal effect according to their terms,
+reviewing courts shall apply local law that most closely approximates
+an absolute waiver of all civil liability in connection with the
+Program, unless a warranty or assumption of liability accompanies a
+copy of the Program in return for a fee.
+
+ END OF TERMS AND CONDITIONS
+
+ How to Apply These Terms to Your New Programs
+
+ If you develop a new program, and you want it to be of the greatest
+possible use to the public, the best way to achieve this is to make it
+free software which everyone can redistribute and change under these terms.
+
+ To do so, attach the following notices to the program. It is safest
+to attach them to the start of each source file to most effectively
+state the exclusion of warranty; and each file should have at least
+the "copyright" line and a pointer to where the full notice is found.
+
+ <one line to give the program's name and a brief idea of what it does.>
+ Copyright (C) <year> <name of author>
+
+ This program is free software: you can redistribute it and/or modify
+ it under the terms of the GNU General Public License as published by
+ the Free Software Foundation, either version 3 of the License, or
+ (at your option) any later version.
+
+ This program is distributed in the hope that it will be useful,
+ but WITHOUT ANY WARRANTY; without even the implied warranty of
+ MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+ GNU General Public License for more details.
+
+ You should have received a copy of the GNU General Public License
+ along with this program. If not, see <https://www.gnu.org/licenses/>.
+
+Also add information on how to contact you by electronic and paper mail.
+
+ If the program does terminal interaction, make it output a short
+notice like this when it starts in an interactive mode:
+
+ <program> Copyright (C) <year> <name of author>
+ This program comes with ABSOLUTELY NO WARRANTY; for details type `show w'.
+ This is free software, and you are welcome to redistribute it
+ under certain conditions; type `show c' for details.
+
+The hypothetical commands `show w' and `show c' should show the appropriate
+parts of the General Public License. Of course, your program's commands
+might be different; for a GUI interface, you would use an "about box".
+
+ You should also get your employer (if you work as a programmer) or school,
+if any, to sign a "copyright disclaimer" for the program, if necessary.
+For more information on this, and how to apply and follow the GNU GPL, see
+<https://www.gnu.org/licenses/>.
+
+ The GNU General Public License does not permit incorporating your program
+into proprietary programs. If your program is a subroutine library, you
+may consider it more useful to permit linking proprietary applications with
+the library. If this is what you want to do, use the GNU Lesser General
+Public License instead of this License. But first, please read
+<https://www.gnu.org/licenses/why-not-lgpl.html>.
diff --git a/subprojects/c-ares/LICENSES/LGPL-2.1-or-later.txt b/subprojects/c-ares/LICENSES/LGPL-2.1-or-later.txt
@@ -0,0 +1,160 @@
+GNU LESSER GENERAL PUBLIC LICENSE
+
+Version 2.1, February 1999
+
+Copyright (C) 1991, 1999 Free Software Foundation, Inc.
+51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
+
+Everyone is permitted to copy and distribute verbatim copies of this license document, but changing it is not allowed.
+
+[This is the first released version of the Lesser GPL. It also counts as the successor of the GNU Library Public License, version 2, hence the version number 2.1.]
+
+Preamble
+
+The licenses for most software are designed to take away your freedom to share and change it. By contrast, the GNU General Public Licenses are intended to guarantee your freedom to share and change free software--to make sure the software is free for all its users.
+
+This license, the Lesser General Public License, applies to some specially designated software packages--typically libraries--of the Free Software Foundation and other authors who decide to use it. You can use it too, but we suggest you first think carefully about whether this license or the ordinary General Public License is the better strategy to use in any particular case, based on the explanations below.
+
+When we speak of free software, we are referring to freedom of use, not price. Our General Public Licenses are designed to make sure that you have the freedom to distribute copies of free software (and charge for this service if you wish); that you receive source code or can get it if you want it; that you can change the software and use pieces of it in new free programs; and that you are informed that you can do these things.
+
+To protect your rights, we need to make restrictions that forbid distributors to deny you these rights or to ask you to surrender these rights. These restrictions translate to certain responsibilities for you if you distribute copies of the library or if you modify it.
+
+For example, if you distribute copies of the library, whether gratis or for a fee, you must give the recipients all the rights that we gave you. You must make sure that they, too, receive or can get the source code. If you link other code with the library, you must provide complete object files to the recipients, so that they can relink them with the library after making changes to the library and recompiling it. And you must show them these terms so they know their rights.
+
+We protect your rights with a two-step method: (1) we copyright the library, and (2) we offer you this license, which gives you legal permission to copy, distribute and/or modify the library.
+
+To protect each distributor, we want to make it very clear that there is no warranty for the free library. Also, if the library is modified by someone else and passed on, the recipients should know that what they have is not the original version, so that the original author's reputation will not be affected by problems that might be introduced by others.
+
+Finally, software patents pose a constant threat to the existence of any free program. We wish to make sure that a company cannot effectively restrict the users of a free program by obtaining a restrictive license from a patent holder. Therefore, we insist that any patent license obtained for a version of the library must be consistent with the full freedom of use specified in this license.
+
+Most GNU software, including some libraries, is covered by the ordinary GNU General Public License. This license, the GNU Lesser General Public License, applies to certain designated libraries, and is quite different from the ordinary General Public License. We use this license for certain libraries in order to permit linking those libraries into non-free programs.
+
+When a program is linked with a library, whether statically or using a shared library, the combination of the two is legally speaking a combined work, a derivative of the original library. The ordinary General Public License therefore permits such linking only if the entire combination fits its criteria of freedom. The Lesser General Public License permits more lax criteria for linking other code with the library.
+
+We call this license the "Lesser" General Public License because it does Less to protect the user's freedom than the ordinary General Public License. It also provides other free software developers Less of an advantage over competing non-free programs. These disadvantages are the reason we use the ordinary General Public License for many libraries. However, the Lesser license provides advantages in certain special circumstances.
+
+For example, on rare occasions, there may be a special need to encourage the widest possible use of a certain library, so that it becomes a de-facto standard. To achieve this, non-free programs must be allowed to use the library. A more frequent case is that a free library does the same job as widely used non-free libraries. In this case, there is little to gain by limiting the free library to free software only, so we use the Lesser General Public License.
+
+In other cases, permission to use a particular library in non-free programs enables a greater number of people to use a large body of free software. For example, permission to use the GNU C Library in non-free programs enables many more people to use the whole GNU operating system, as well as its variant, the GNU/Linux operating system.
+
+Although the Lesser General Public License is Less protective of the users' freedom, it does ensure that the user of a program that is linked with the Library has the freedom and the wherewithal to run that program using a modified version of the Library.
+
+The precise terms and conditions for copying, distribution and modification follow. Pay close attention to the difference between a "work based on the library" and a "work that uses the library". The former contains code derived from the library, whereas the latter must be combined with the library in order to run.
+
+TERMS AND CONDITIONS FOR COPYING, DISTRIBUTION AND MODIFICATION
+
+ 0. This License Agreement applies to any software library or other program which contains a notice placed by the copyright holder or other authorized party saying it may be distributed under the terms of this Lesser General Public License (also called "this License"). Each licensee is addressed as "you".
+
+ A "library" means a collection of software functions and/or data prepared so as to be conveniently linked with application programs (which use some of those functions and data) to form executables.
+
+ The "Library", below, refers to any such software library or work which has been distributed under these terms. A "work based on the Library" means either the Library or any derivative work under copyright law: that is to say, a work containing the Library or a portion of it, either verbatim or with modifications and/or translated straightforwardly into another language. (Hereinafter, translation is included without limitation in the term "modification".)
+
+ "Source code" for a work means the preferred form of the work for making modifications to it. For a library, complete source code means all the source code for all modules it contains, plus any associated interface definition files, plus the scripts used to control compilation and installation of the library.
+
+ Activities other than copying, distribution and modification are not covered by this License; they are outside its scope. The act of running a program using the Library is not restricted, and output from such a program is covered only if its contents constitute a work based on the Library (independent of the use of the Library in a tool for writing it). Whether that is true depends on what the Library does and what the program that uses the Library does.
+ 1. You may copy and distribute verbatim copies of the Library's complete source code as you receive it, in any medium, provided that you conspicuously and appropriately publish on each copy an appropriate copyright notice and disclaimer of warranty; keep intact all the notices that refer to this License and to the absence of any warranty; and distribute a copy of this License along with the Library.
+
+ You may charge a fee for the physical act of transferring a copy, and you may at your option offer warranty protection in exchange for a fee.
+ 2. You may modify your copy or copies of the Library or any portion of it, thus forming a work based on the Library, and copy and distribute such modifications or work under the terms of Section 1 above, provided that you also meet all of these conditions:
+ a) The modified work must itself be a software library.
+ b) You must cause the files modified to carry prominent notices stating that you changed the files and the date of any change.
+ c) You must cause the whole of the work to be licensed at no charge to all third parties under the terms of this License.
+ d) If a facility in the modified Library refers to a function or a table of data to be supplied by an application program that uses the facility, other than as an argument passed when the facility is invoked, then you must make a good faith effort to ensure that, in the event an application does not supply such function or table, the facility still operates, and performs whatever part of its purpose remains meaningful.
+
+ (For example, a function in a library to compute square roots has a purpose that is entirely well-defined independent of the application. Therefore, Subsection 2d requires that any application-supplied function or table used by this function must be optional: if the application does not supply it, the square root function must still compute square roots.)
+
+ These requirements apply to the modified work as a whole. If identifiable sections of that work are not derived from the Library, and can be reasonably considered independent and separate works in themselves, then this License, and its terms, do not apply to those sections when you distribute them as separate works. But when you distribute the same sections as part of a whole which is a work based on the Library, the distribution of the whole must be on the terms of this License, whose permissions for other licensees extend to the entire whole, and thus to each and every part regardless of who wrote it.
+
+ Thus, it is not the intent of this section to claim rights or contest your rights to work written entirely by you; rather, the intent is to exercise the right to control the distribution of derivative or collective works based on the Library.
+
+ In addition, mere aggregation of another work not based on the Library with the Library (or with a work based on the Library) on a volume of a storage or distribution medium does not bring the other work under the scope of this License.
+ 3. You may opt to apply the terms of the ordinary GNU General Public License instead of this License to a given copy of the Library. To do this, you must alter all the notices that refer to this License, so that they refer to the ordinary GNU General Public License, version 2, instead of to this License. (If a newer version than version 2 of the ordinary GNU General Public License has appeared, then you can specify that version instead if you wish.) Do not make any other change in these notices.
+
+ Once this change is made in a given copy, it is irreversible for that copy, so the ordinary GNU General Public License applies to all subsequent copies and derivative works made from that copy.
+
+ This option is useful when you wish to copy part of the code of the Library into a program that is not a library.
+ 4. You may copy and distribute the Library (or a portion or derivative of it, under Section 2) in object code or executable form under the terms of Sections 1 and 2 above provided that you accompany it with the complete corresponding machine-readable source code, which must be distributed under the terms of Sections 1 and 2 above on a medium customarily used for software interchange.
+
+ If distribution of object code is made by offering access to copy from a designated place, then offering equivalent access to copy the source code from the same place satisfies the requirement to distribute the source code, even though third parties are not compelled to copy the source along with the object code.
+ 5. A program that contains no derivative of any portion of the Library, but is designed to work with the Library by being compiled or linked with it, is called a "work that uses the Library". Such a work, in isolation, is not a derivative work of the Library, and therefore falls outside the scope of this License.
+
+ However, linking a "work that uses the Library" with the Library creates an executable that is a derivative of the Library (because it contains portions of the Library), rather than a "work that uses the library". The executable is therefore covered by this License. Section 6 states terms for distribution of such executables.
+
+ When a "work that uses the Library" uses material from a header file that is part of the Library, the object code for the work may be a derivative work of the Library even though the source code is not. Whether this is true is especially significant if the work can be linked without the Library, or if the work is itself a library. The threshold for this to be true is not precisely defined by law.
+
+ If such an object file uses only numerical parameters, data structure layouts and accessors, and small macros and small inline functions (ten lines or less in length), then the use of the object file is unrestricted, regardless of whether it is legally a derivative work. (Executables containing this object code plus portions of the Library will still fall under Section 6.)
+
+ Otherwise, if the work is a derivative of the Library, you may distribute the object code for the work under the terms of Section 6. Any executables containing that work also fall under Section 6, whether or not they are linked directly with the Library itself.
+ 6. As an exception to the Sections above, you may also combine or link a "work that uses the Library" with the Library to produce a work containing portions of the Library, and distribute that work under terms of your choice, provided that the terms permit modification of the work for the customer's own use and reverse engineering for debugging such modifications.
+
+ You must give prominent notice with each copy of the work that the Library is used in it and that the Library and its use are covered by this License. You must supply a copy of this License. If the work during execution displays copyright notices, you must include the copyright notice for the Library among them, as well as a reference directing the user to the copy of this License. Also, you must do one of these things:
+ a) Accompany the work with the complete corresponding machine-readable source code for the Library including whatever changes were used in the work (which must be distributed under Sections 1 and 2 above); and, if the work is an executable linked with the Library, with the complete machine-readable "work that uses the Library", as object code and/or source code, so that the user can modify the Library and then relink to produce a modified executable containing the modified Library. (It is understood that the user who changes the contents of definitions files in the Library will not necessarily be able to recompile the application to use the modified definitions.)
+ b) Use a suitable shared library mechanism for linking with the Library. A suitable mechanism is one that (1) uses at run time a copy of the library already present on the user's computer system, rather than copying library functions into the executable, and (2) will operate properly with a modified version of the library, if the user installs one, as long as the modified version is interface-compatible with the version that the work was made with.
+ c) Accompany the work with a written offer, valid for at least three years, to give the same user the materials specified in Subsection 6a, above, for a charge no more than the cost of performing this distribution.
+ d) If distribution of the work is made by offering access to copy from a designated place, offer equivalent access to copy the above specified materials from the same place.
+ e) Verify that the user has already received a copy of these materials or that you have already sent this user a copy.
+
+ For an executable, the required form of the "work that uses the Library" must include any data and utility programs needed for reproducing the executable from it. However, as a special exception, the materials to be distributed need not include anything that is normally distributed (in either source or binary form) with the major components (compiler, kernel, and so on) of the operating system on which the executable runs, unless that component itself accompanies the executable.
+
+ It may happen that this requirement contradicts the license restrictions of other proprietary libraries that do not normally accompany the operating system. Such a contradiction means you cannot use both them and the Library together in an executable that you distribute.
+ 7. You may place library facilities that are a work based on the Library side-by-side in a single library together with other library facilities not covered by this License, and distribute such a combined library, provided that the separate distribution of the work based on the Library and of the other library facilities is otherwise permitted, and provided that you do these two things:
+ a) Accompany the combined library with a copy of the same work based on the Library, uncombined with any other library facilities. This must be distributed under the terms of the Sections above.
+ b) Give prominent notice with the combined library of the fact that part of it is a work based on the Library, and explaining where to find the accompanying uncombined form of the same work.
+ 8. You may not copy, modify, sublicense, link with, or distribute the Library except as expressly provided under this License. Any attempt otherwise to copy, modify, sublicense, link with, or distribute the Library is void, and will automatically terminate your rights under this License. However, parties who have received copies, or rights, from you under this License will not have their licenses terminated so long as such parties remain in full compliance.
+ 9. You are not required to accept this License, since you have not signed it. However, nothing else grants you permission to modify or distribute the Library or its derivative works. These actions are prohibited by law if you do not accept this License. Therefore, by modifying or distributing the Library (or any work based on the Library), you indicate your acceptance of this License to do so, and all its terms and conditions for copying, distributing or modifying the Library or works based on it.
+ 10. Each time you redistribute the Library (or any work based on the Library), the recipient automatically receives a license from the original licensor to copy, distribute, link with or modify the Library subject to these terms and conditions. You may not impose any further restrictions on the recipients' exercise of the rights granted herein. You are not responsible for enforcing compliance by third parties with this License.
+ 11. If, as a consequence of a court judgment or allegation of patent infringement or for any other reason (not limited to patent issues), conditions are imposed on you (whether by court order, agreement or otherwise) that contradict the conditions of this License, they do not excuse you from the conditions of this License. If you cannot distribute so as to satisfy simultaneously your obligations under this License and any other pertinent obligations, then as a consequence you may not distribute the Library at all. For example, if a patent license would not permit royalty-free redistribution of the Library by all those who receive copies directly or indirectly through you, then the only way you could satisfy both it and this License would be to refrain entirely from distribution of the Library.
+
+ If any portion of this section is held invalid or unenforceable under any particular circumstance, the balance of the section is intended to apply, and the section as a whole is intended to apply in other circumstances.
+
+ It is not the purpose of this section to induce you to infringe any patents or other property right claims or to contest validity of any such claims; this section has the sole purpose of protecting the integrity of the free software distribution system which is implemented by public license practices. Many people have made generous contributions to the wide range of software distributed through that system in reliance on consistent application of that system; it is up to the author/donor to decide if he or she is willing to distribute software through any other system and a licensee cannot impose that choice.
+
+ This section is intended to make thoroughly clear what is believed to be a consequence of the rest of this License.
+ 12. If the distribution and/or use of the Library is restricted in certain countries either by patents or by copyrighted interfaces, the original copyright holder who places the Library under this License may add an explicit geographical distribution limitation excluding those countries, so that distribution is permitted only in or among countries not thus excluded. In such case, this License incorporates the limitation as if written in the body of this License.
+ 13. The Free Software Foundation may publish revised and/or new versions of the Lesser General Public License from time to time. Such new versions will be similar in spirit to the present version, but may differ in detail to address new problems or concerns.
+
+ Each version is given a distinguishing version number. If the Library specifies a version number of this License which applies to it and "any later version", you have the option of following the terms and conditions either of that version or of any later version published by the Free Software Foundation. If the Library does not specify a license version number, you may choose any version ever published by the Free Software Foundation.
+ 14. If you wish to incorporate parts of the Library into other free programs whose distribution conditions are incompatible with these, write to the author to ask for permission. For software which is copyrighted by the Free Software Foundation, write to the Free Software Foundation; we sometimes make exceptions for this. Our decision will be guided by the two goals of preserving the free status of all derivatives of our free software and of promoting the sharing and reuse of software generally.
+
+ NO WARRANTY
+ 15. BECAUSE THE LIBRARY IS LICENSED FREE OF CHARGE, THERE IS NO WARRANTY FOR THE LIBRARY, TO THE EXTENT PERMITTED BY APPLICABLE LAW. EXCEPT WHEN OTHERWISE STATED IN WRITING THE COPYRIGHT HOLDERS AND/OR OTHER PARTIES PROVIDE THE LIBRARY "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. THE ENTIRE RISK AS TO THE QUALITY AND PERFORMANCE OF THE LIBRARY IS WITH YOU. SHOULD THE LIBRARY PROVE DEFECTIVE, YOU ASSUME THE COST OF ALL NECESSARY SERVICING, REPAIR OR CORRECTION.
+ 16. IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MAY MODIFY AND/OR REDISTRIBUTE THE LIBRARY AS PERMITTED ABOVE, BE LIABLE TO YOU FOR DAMAGES, INCLUDING ANY GENERAL, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING OUT OF THE USE OR INABILITY TO USE THE LIBRARY (INCLUDING BUT NOT LIMITED TO LOSS OF DATA OR DATA BEING RENDERED INACCURATE OR LOSSES SUSTAINED BY YOU OR THIRD PARTIES OR A FAILURE OF THE LIBRARY TO OPERATE WITH ANY OTHER SOFTWARE), EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.
+
+END OF TERMS AND CONDITIONS
+
+How to Apply These Terms to Your New Libraries
+
+If you develop a new library, and you want it to be of the greatest possible use to the public, we recommend making it free software that everyone can redistribute and change. You can do so by permitting redistribution under these terms (or, alternatively, under the terms of the ordinary General Public License).
+
+To apply these terms, attach the following notices to the library. It is safest to attach them to the start of each source file to most effectively convey the exclusion of warranty; and each file should have at least the "copyright" line and a pointer to where the full notice is found.
+
+<one line to give the library's name and an idea of what it does.>
+Copyright (C) <year> <name of author>
+
+This library is free software; you can redistribute it and/or modify it under the terms of the GNU Lesser General Public License as published by the Free Software Foundation; either version 2.1 of the License, or (at your option) any later version.
+
+This library is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public License for more details.
+
+You should have received a copy of the GNU Lesser General Public License along with this library; if not, write to the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
+
+Also add information on how to contact you by electronic and paper mail.
+
+You should also get your employer (if you work as a programmer) or your school, if any, to sign a "copyright disclaimer" for the library, if necessary. Here is a sample; alter the names:
+
+Yoyodyne, Inc., hereby disclaims all copyright interest in
+the library `Frob' (a library for tweaking knobs) written
+by James Random Hacker.
+
+<signature of Ty Coon >, 1 April 1990
+Ty Coon, President of Vice
+That's all there is to it!
+Standard License Header
+
+<one line to give the library's name and an idea of what it does.>
+Copyright (C) <year> <name of author>
+
+This library is free software; you can redistribute it and/or modify it under the terms of the GNU Lesser General Public License as published by the Free Software Foundation; either version 2.1 of the License, or (at your option) any later version.
+
+This library is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public License for more details.
+
+You should have received a copy of the GNU Lesser General Public License along with this library; if not, write to the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
diff --git a/subprojects/c-ares/LICENSES/MIT.txt b/subprojects/c-ares/LICENSES/MIT.txt
@@ -0,0 +1,22 @@
+MIT License
+
+Copyright (c) <year> <copyright holders>
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of
+this software and associated documentation files (the "Software"), to deal in
+the Software without restriction, including without limitation the rights to
+use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of
+the Software, and to permit persons to whom the Software is furnished to do so,
+subject to the following conditions:
+
+The above copyright notice and this permission notice (including the next
+paragraph) shall be included in all copies or substantial portions of the
+Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
diff --git a/subprojects/c-ares/Makefile.Watcom b/subprojects/c-ares/Makefile.Watcom
@@ -0,0 +1,170 @@
+# Copyright (C) The c-ares project and its contributors
+# SPDX-License-Identifier: MIT
+#
+# Watcom / OpenWatcom / Win32 makefile for cares.
+# Quick hack by Guenter; comments to: /dev/nul
+# Updated by Douglas R. Reno, comments to: renodr2002@gmail.com. 2023
+#
+
+!ifndef %watcom
+!error WATCOM environment variable not set!
+!else
+SYS_INCL = -I$(%watcom)\h\nt -I$(%watcom)\h
+SYS_LIBS = $(%watcom)\lib386\nt;$(%watcom)\lib386
+!endif
+
+!ifdef %libname
+LIBNAME = $(%libname)
+!else
+LIBNAME = cares
+!endif
+TARGETS = $(LIBNAME).dll $(LIBNAME)_imp.lib $(LIBNAME).lib
+DEMOS = adig.exe ahost.exe
+
+CC = wcc386
+LD = wlink
+AR = wlib
+RC = wrc
+
+!ifdef __LOADDLL__
+! loaddll wcc386 wccd386
+! loaddll wpp386 wppd386
+! loaddll wlib wlibd
+!endif
+
+!if $(__VERSION__) < 1250
+RM = del /q /f 2>NUL
+!else
+RM = rm -f
+!endif
+MD = mkdir
+RD = rmdir /q /s 2>NUL
+CP = copy
+
+CFLAGS = -3r -mf -hc -zff -zgf -zq -zm -zc -s -fr=con -w2 -fpi -oilrtfm -aa &
+ -wcd=201 -bt=nt -d+ -dWIN32 -dCARES_BUILDING_LIBRARY &
+ -dNTDDI_VERSION=0x06020000 -I. -I.\include -I.\src\lib $(SYS_INCL)
+
+LFLAGS = option quiet, map, caseexact, eliminate
+
+!ifdef %debug
+DEBUG = -dDEBUG=1 -dDEBUGBUILD
+CFLAGS += -d3 $(DEBUG)
+LFLAGS += debug all
+!else
+CFLAGS += -d0
+!endif
+
+CFLAGS += -d_WIN32_WINNT=0x0602
+
+#
+# Change to suite.
+#
+!ifdef %use_watt32
+CFLAGS += -dWATT32 -I$(%watt_root)\inc
+!endif
+
+OBJ_BASE = WC_Win32.obj
+LINK_ARG = $(OBJ_BASE)\dyn\wlink.arg
+LIB_ARG = $(OBJ_BASE)\stat\wlib.arg
+
+# In order to process Makefile.inc wmake must be called with -u switch!
+!ifneq __MAKEOPTS__ -u
+!error You MUST call wmake with the -u switch!
+!else
+!include src\lib\Makefile.inc
+!endif
+
+OBJS = $(CSOURCES:.c=.obj)
+OBJS = $OBJ_DIR\$(OBJS: = $OBJ_DIR\)
+
+#
+# Use $(OBJS) as a template to generate $(OBJS_STAT) and $(OBJS_DYN).
+#
+OBJ_DIR = $(OBJ_BASE)\stat
+OBJS_STAT = $+ $(OBJS) $-
+
+OBJ_DIR = $(OBJ_BASE)\dyn
+OBJS_DYN += $(OBJS) $-
+
+ARESBUILDH = ares_build.h
+RESOURCE = $(OBJ_BASE)\dyn\cares.res
+ARESBUILDH = include\ares_build.h
+
+all: $(ARESBUILDH) $(OBJ_BASE) $(TARGETS) $(DEMOS) .SYMBOLIC
+ @echo Welcome to cares
+
+$(OBJ_BASE):
+ -$(MD) $^@
+ -$(MD) $^@\stat
+ -$(MD) $^@\dyn
+ -$(MD) $^@\tools
+
+$(ARESBUILDH): .EXISTSONLY
+ @echo Make sure to run buildconf.bat!
+
+$(LIBNAME).dll: $(OBJS_DYN) $(RESOURCE) $(LINK_ARG)
+ $(LD) name $^@ @$]@
+
+$(LIBNAME).lib: $(OBJS_STAT) $(LIB_ARG)
+ $(AR) -q -b -c $^@ @$]@
+
+$(OBJ_BASE)\tools\ares_getopt.obj:
+ $(CC) $(CFLAGS) -DCARES_STATICLIB .\src\tools\ares_getopt.c -fo=$^@
+
+adig.exe: $(OBJ_BASE)\tools\ares_getopt.obj $(LIBNAME).lib
+ $(CC) $(CFLAGS) src\tools\adig.c -fo=$(OBJ_BASE)\tools\adig.obj
+ $(LD) name $^@ system nt $(LFLAGS) file { $(OBJ_BASE)\tools\adig.obj $[@ } library $]@, ws2_32.lib, iphlpapi.lib
+
+ahost.exe: $(OBJ_BASE)\tools\ares_getopt.obj $(LIBNAME).lib
+ $(CC) $(CFLAGS) src\tools\ahost.c -fo=$(OBJ_BASE)\tools\ahost.obj
+ $(LD) name $^@ system nt $(LFLAGS) file { $(OBJ_BASE)\tools\ahost.obj $[@ } library $]@, ws2_32.lib, iphlpapi.lib
+
+clean: .SYMBOLIC
+ -$(RM) $(OBJS_STAT)
+ -$(RM) $(OBJS_DYN)
+ -$(RM) $(RESOURCE) $(LINK_ARG) $(LIB_ARG)
+
+vclean realclean: clean .SYMBOLIC
+ -$(RM) $(TARGETS) $(LIBNAME).map
+ -$(RM) $(DEMOS) $(DEMOS:.exe=.map)
+ -$(RD) $(OBJ_BASE)\stat
+ -$(RD) $(OBJ_BASE)\dyn
+ -$(RD) $(OBJ_BASE)\tools
+ -$(RD) $(OBJ_BASE)
+
+.ERASE
+.c: .\src\lib
+
+.ERASE
+$(RESOURCE): src\lib\cares.rc .AUTODEPEND
+ $(RC) $(DEBUG) -q -r -zm -I..\include $(SYS_INCL) $[@ -fo=$^@
+
+.ERASE
+.c{$(OBJ_BASE)\dyn}.obj:
+ $(CC) $(CFLAGS) -bd .\src\lib\$^& -fo=$^@
+
+.ERASE
+.c{$(OBJ_BASE)\stat}.obj:
+ $(CC) $(CFLAGS) -DCARES_STATICLIB .\src\lib\$^& -fo=$^@
+
+$(LINK_ARG): $(__MAKEFILES__)
+ %create $^@
+ @%append $^@ system nt dll
+ @%append $^@ file { $(OBJS_DYN) }
+ @%append $^@ option res=$(RESOURCE), implib=$(LIBNAME)_imp.lib
+ @%append $^@ $(LFLAGS)
+ @%append $^@ libpath $(SYS_LIBS)
+# @%append $^@ library clib3r.lib
+!ifdef %use_watt32
+ @%append $^@ library $(%watt_root)\lib\wattcpw_imp.lib
+!else
+ @%append $^@ library ws2_32.lib
+ @%append $^@ library iphlpapi.lib
+!endif
+
+$(LIB_ARG): $(__MAKEFILES__)
+ %create $^@
+ @for %f in ($(OBJS_STAT)) do @%append $^@ +- %f
+
+
diff --git a/subprojects/c-ares/Makefile.am b/subprojects/c-ares/Makefile.am
@@ -0,0 +1,58 @@
+#############################################################
+#
+# Copyright (C) the Massachusetts Institute of Technology.
+# Copyright (C) Daniel Stenberg
+#
+# Permission to use, copy, modify, and distribute this
+# software and its documentation for any purpose and without
+# fee is hereby granted, provided that the above copyright
+# notice appear in all copies and that both that copyright
+# notice and this permission notice appear in supporting
+# documentation, and that the name of M.I.T. not be used in
+# advertising or publicity pertaining to distribution of the
+# software without specific, written prior permission.
+# M.I.T. makes no representations about the suitability of
+# this software for any purpose. It is provided "as is"
+# without express or implied warranty.
+#
+# SPDX-License-Identifier: MIT
+#
+#############################################################
+
+AUTOMAKE_OPTIONS = foreign nostdinc 1.9.6
+ACLOCAL_AMFLAGS = -I m4 --install
+
+MSVCFILES = msvc_ver.inc buildconf.bat
+
+# adig and ahost are just sample programs and thus not mentioned with the
+# regular sources and headers
+EXTRA_DIST = AUTHORS CHANGES README.cares $(man_MANS) RELEASE-NOTES \
+ c-ares-config.cmake.in libcares.pc.cmake libcares.pc.in buildconf get_ver.awk \
+ maketgz TODO README.msvc $(MSVCFILES) INSTALL.md README.md LICENSE.md \
+ CMakeLists.txt Makefile.dj Makefile.m32 Makefile.netware Makefile.msvc \
+ Makefile.Watcom AUTHORS CONTRIBUTING.md SECURITY.md TODO \
+ cmake/EnableWarnings.cmake
+
+CLEANFILES = $(PDFPAGES) $(HTMLPAGES)
+
+DISTCLEANFILES = include/ares_build.h
+
+DIST_SUBDIRS = include src test docs
+
+SUBDIRS = @BUILD_SUBDIRS@
+
+pkgconfigdir = $(libdir)/pkgconfig
+pkgconfig_DATA = libcares.pc
+
+# where to install the c-ares headers
+libcares_ladir = $(includedir)
+
+
+# Make files named *.dist replace the file without .dist extension
+dist-hook:
+ find $(distdir) -name "*.dist" -exec rm {} \;
+ (distit=`find $(srcdir) -name "*.dist"`; \
+ for file in $$distit; do \
+ strip=`echo $$file | sed -e s/^$(srcdir)// -e s/\.dist//`; \
+ cp $$file $(distdir)$$strip; \
+ done)
diff --git a/subprojects/c-ares/Makefile.dj b/subprojects/c-ares/Makefile.dj
@@ -0,0 +1,103 @@
+#
+# c-ares Makefile for djgpp/gcc/Watt-32.
+# Copyright (C) Gisle Vanem <gvanem@yahoo.no>
+# SPDX-License-Identifier: MIT
+#
+include src/lib/Makefile.inc
+
+CSOURCES := $(addprefix src/lib/, $(CSOURCES))
+CSOURCES := $(filter-out src/lib/windows_port.c, $(CSOURCES))
+
+VPATH = src/lib src/tools
+
+#
+# Root directory for Waterloo tcp/ip.
+# WATT_ROOT should be set during Watt-32 install.
+#
+WATT32_ROOT = $(realpath $(WATT_ROOT))
+WATT32_LIB = $(WATT32_ROOT)/lib/libwatt.a
+
+OBJ_DIR = djgpp
+
+CFLAGS = -g -O2 -I./include -I./src/lib \
+ -I$(WATT32_ROOT)/inc -Wall \
+ -DWATT32 -DHAVE_CONFIG_H \
+ -Dselect=select_s
+
+LDFLAGS = -s
+
+ifeq ($(OS),Windows_NT)
+ #
+ # Windows hosted djgpp cross compiler. Get it from:
+ # https://github.com/andrewwutw/build-djgpp/releases
+ #
+ DJ_PREFIX ?= c:/some-path/djgpp/bin/i586-pc-msdosdjgpp-
+ CC = $(DJ_PREFIX)gcc
+
+else
+ #
+ # The normal djgpp 'gcc' for MSDOS.
+ #
+ CC = gcc
+endif
+
+OBJECTS = $(addprefix $(OBJ_DIR)/, \
+ $(notdir $(CSOURCES:.c=.o)))
+
+GENERATED = src/lib/ares_config.h \
+ include/ares_build.h
+
+TARGETS = libcares.a adig.exe ahost.exe
+
+.SECONDARY: $(OBJ_DIR)/ares_getopt.o
+
+all: $(OBJ_DIR) $(GENERATED) $(TARGETS)
+ @echo Welcome to c-ares.
+
+libcares.a: $(OBJECTS)
+ ar rs $@ $(OBJECTS)
+
+src/lib/ares_config.h: src/lib/config-dos.h
+ cp --update $< $@
+
+include/ares_build.h: include/ares_build.h.dist
+ cp --update $< $@
+
+%.exe: src/tools/%.c $(OBJ_DIR)/ares_getopt.o libcares.a
+ $(call compile_and_link, $@, $^ $(WATT32_LIB))
+
+# Clean generated files and objects.
+#
+clean:
+ - rm -f depend.dj $(GENERATED) $(OBJ_DIR)/*.o
+ - rmdir $(OBJ_DIR)
+
+# Clean everything
+#
+realclean vclean: clean
+ - rm -f $(TARGETS) $(TARGETS:.exe=.map)
+
+$(OBJ_DIR):
+ - mkdir $@
+
+$(OBJ_DIR)/%.o: %.c
+ $(CC) $(CFLAGS) -o $@ -c $<
+ @echo
+
+define compile_and_link
+ $(CC) -o $(1) $(CFLAGS) $(LDFLAGS) -Wl,--print-map,--sort-common $(2) > $(1:.exe=.map)
+ @echo
+endef
+
+DEP_REPLACE = sed -e 's@\(.*\)\.o: @\n$$(OBJ_DIR)\/\1.o: @' \
+ -e 's@$(WATT32_ROOT)@$$(WATT32_ROOT)@g'
+
+#
+# One may have to do 'make -f Makefile.dj clean' first in case
+# a foreign 'curl_config.h' is making trouble.
+#
+depend: $(GENERATED) Makefile.dj
+ $(CC) -MM $(CFLAGS) $(CSOURCES) | $(DEP_REPLACE) > depend.dj
+
+-include depend.dj
+
diff --git a/subprojects/c-ares/Makefile.m32 b/subprojects/c-ares/Makefile.m32
@@ -0,0 +1,80 @@
+#############################################################
+#
+# Makefile for building libcares.a with MingW32 (GCC-3.2)
+# Use: make -f Makefile.m32 [demos]
+#
+# Quick hack by Guenter; comments to: /dev/nul
+#
+# Copyright (C) The c-ares project and its contributors
+# SPDX-License-Identifier: MIT
+########################################################
+## Nothing more to do below this line!
+
+LIB = src/lib/libcares.a
+
+AR = $(CROSSPREFIX)ar
+CC = $(CROSSPREFIX)gcc
+LD = $(CROSSPREFIX)gcc
+RANLIB = $(CROSSPREFIX)ranlib
+#RM = rm -f
+CP = cp -afv
+
+CFLAGS = $(CARES_CFLAG_EXTRAS) -O2 -Wall -I./include -I./src/lib -D_WIN32_WINNT=0x0602
+CFLAGS += -DCARES_STATICLIB
+LDFLAGS = $(CARES_LDFLAG_EXTRAS) -s
+LIBS = -lws2_32 -liphlpapi
+
+# Makefile.inc provides the CSOURCES and HHEADERS defines
+include src/lib/Makefile.inc
+
+OBJLIB := $(patsubst %.c,src/lib/%.o,$(strip $(CSOURCES)))
+
+
+$(LIB): $(OBJLIB)
+ $(AR) cru $@ $^
+ $(RANLIB) $@
+
+all: $(LIB) demos
+
+demos: src/tools/adig.exe src/tools/ahost.exe
+
+tags:
+ etags *.[ch]
+
+%.exe: %.o src/tools/ares_getopt.o $(LIB)
+ $(LD) $(LDFLAGS) -o $@ $^ $(LIBS)
+
+$(OBJLIB): include/ares.h include/ares_dns.h include/ares_build.h
+
+.c.o:
+ $(CC) $(CFLAGS) -o $@ -c $<
+
+include/ares_build.h:
+ $(CP) include/ares_build.h.dist include/ares_build.h
+
+check:
+
+install:
+ ${top_srcdir}/mkinstalldirs ${DESTDIR}${libdir}
+ ${top_srcdir}/mkinstalldirs ${DESTDIR}${includedir}
+ ${top_srcdir}/mkinstalldirs ${DESTDIR}${mandir}/man3
+ ${INSTALL} -m 644 $(LIB) ${DESTDIR}${libdir}
+ ${RANLIB} ${DESTDIR}${libdir}/$(LIB)
+ chmod u-w ${DESTDIR}${libdir}/$(LIB)
+ ${INSTALL} -m 444 ${srcdir}/include/ares.h ${DESTDIR}${includedir}
+ ${INSTALL} -m 444 ${srcdir}/include/ares_build.h ${DESTDIR}${includedir}
+ ${INSTALL} -m 444 ${srcdir}/include/ares_dns_record.h ${DESTDIR}${includedir}
+ ${INSTALL} -m 444 ${srcdir}/include/ares_rules.h ${DESTDIR}${includedir}
+ ${INSTALL} -m 444 ${srcdir}/include/ares_version.h ${DESTDIR}${includedir}
+ (for man in $(MANPAGES); do \
+ ${INSTALL} -m 444 ${srcdir}/$${man} ${DESTDIR}${mandir}/man3; \
+ done)
+
+clean:
+ $(RM) src/tools/ares_getopt.o $(OBJLIB) $(LIB) src/tools/adig.exe src/tools/ahost.exe
+
+distclean: clean
+ $(RM) config.cache config.log config.status Makefile
+ifeq "$(wildcard include/ares_build.h.dist)" "include/ares_build.h.dist"
+ $(RM) include/ares_build.h
+endif
diff --git a/subprojects/c-ares/Makefile.msvc b/subprojects/c-ares/Makefile.msvc
@@ -0,0 +1,457 @@
+
+# Copyright (C) 2009-2013 by Daniel Stenberg
+#
+# Permission to use, copy, modify, and distribute this
+# software and its documentation for any purpose and without
+# fee is hereby granted, provided that the above copyright
+# notice appear in all copies and that both that copyright
+# notice and this permission notice appear in supporting
+# documentation, and that the name of M.I.T. not be used in
+# advertising or publicity pertaining to distribution of the
+# software without specific, written prior permission.
+# M.I.T. makes no representations about the suitability of
+# this software for any purpose. It is provided "as is"
+# without express or implied warranty.
+#
+# SPDX-License-Identifier: MIT
+
+# ------------------------------------------------------------------------------
+#
+# Makefile for building c-ares libraries and sample programs with MSVC.
+#
+# Usage: nmake /f makefile.msvc CFG=<config> <target>
+#
+# <config> must be one of: [ lib-release | lib-debug | dll-release | dll-debug }
+# <target> must be one of: [ ALL | c-ares | adig | ahost | clean }
+#
+# If a <target> other than ALL or clean is given, <config> becomes mandatory.
+#
+# If neither <config> nor <target> are specified this results in
+# all targets being built for all <config> c-ares library types.
+#
+# This makefile must be processed from the subdir where it is located.
+#
+# All results are generated below a subdirectory named msvcXXX.
+#
+# ------------------------------------------------------------------------------
+
+NAME = cares
+
+# ------------------------------------------------
+# c-ares static and dynamic libraries common base
+# file names for release and debug configurations
+# ------------------------------------------------
+
+STA_LIB_REL = lib$(NAME)
+DYN_LIB_REL = $(NAME)
+STA_LIB_DBG = $(STA_LIB_REL)d
+DYN_LIB_DBG = $(DYN_LIB_REL)d
+
+# -------------------------------------------
+# Base names for c-ares DLL import libraries
+# -------------------------------------------
+
+IMP_LIB_REL = $(DYN_LIB_REL)
+IMP_LIB_DBG = $(DYN_LIB_DBG)
+
+# --------------------------
+# Runtime library selection
+# --------------------------
+
+RTLIB = /MD
+RTLIBD = /MDd
+
+!IF "$(RTLIBCFG)" == "static"
+RTLIB = /MT
+RTLIBD = /MTd
+!ENDIF
+
+# --------------------------------------------------------
+# Define USE_WATT32 to 1 to use the Watt-32 tcp/ip stack,
+# otherwise Winsock tcp/ip stack will be used as default.
+# --------------------------------------------------------
+
+USE_WATT32 = 0
+
+# --------------------------------------------------------
+# Detect compiler version.
+# --------------------------------------------------------
+!INCLUDE .\msvc_ver.inc
+
+# ----------------------------------------------------
+# Verify that current subdir is the c-ares source one
+# ----------------------------------------------------
+
+!IF ! EXIST(.\src\lib\ares_init.c)
+! MESSAGE Can not process Makefile.msvc from outside of c-ares source subdirectory.
+! MESSAGE Change to the subdirectory where Makefile.msvc is found, and try again.
+! ERROR See previous message.
+!ENDIF
+
+# ------------------------------------------------------------------
+# Base subdir is the common root from which other subdirs will hang.
+# ------------------------------------------------------------------
+
+BASE_DIR = .\msvc
+
+# ----------------------------------------
+# Subdir holding sources for all projects
+# ----------------------------------------
+
+SRCDIR = .
+
+# -----------------------------
+# Default installation subdirs
+# -----------------------------
+
+!IFNDEF INSTALL_DIR
+INSTALL_DIR = .
+!ENDIF
+
+!IFNDEF INSTALL_DIR_LIB
+INSTALL_DIR_LIB = $(INSTALL_DIR)\lib
+!ENDIF
+
+!IFNDEF INSTALL_DIR_INC
+INSTALL_DIR_INC = $(INSTALL_DIR)\include
+!ENDIF
+
+# -------------------------
+# Configuration validation
+# -------------------------
+
+VALID_CFGSET = FALSE
+!IF "$(CFG)" == "lib-release" || "$(CFG)" == "lib-debug" || \
+ "$(CFG)" == "dll-release" || "$(CFG)" == "dll-debug"
+VALID_CFGSET = TRUE
+!ENDIF
+
+!IF "$(VALID_CFGSET)" == "FALSE" && "$(CFG)" != ""
+! MESSAGE MSVC c-ares makefile
+! MESSAGE
+! MESSAGE Usage: nmake /f makefile.msvc CFG=<config> <target>
+! MESSAGE
+! MESSAGE <config> must be one of: [ lib-release | lib-debug | dll-release | dll-debug }
+! MESSAGE <target> must be one of: [ ALL | c-ares | adig | ahost | clean }
+! MESSAGE
+! MESSAGE If a <target> other than ALL or clean is given, <config> becomes mandatory.
+! MESSAGE
+! MESSAGE If neither <config> nor <target> are specified this results in
+! MESSAGE all targets being built for all <config> c-ares library types.
+! MESSAGE
+! ERROR Choose a valid configuration.
+!ENDIF
+
+# --------------------------------------------------------
+# Project subdirs independent of configuration being used
+# --------------------------------------------------------
+
+CARES_DIR = $(BASE_DIR)\cares
+PROG2_DIR = $(BASE_DIR)\adig
+PROG3_DIR = $(BASE_DIR)\ahost
+
+# ---------------------------------------------------
+# Subdirs which are configuration dependent are only
+# defined when a valid configuration has been given.
+# ---------------------------------------------------
+
+!IF "$(VALID_CFGSET)" == "TRUE"
+CARES_OUTDIR = $(CARES_DIR)\$(CFG)
+PROG2_OUTDIR = $(PROG2_DIR)\$(CFG)
+PROG3_OUTDIR = $(PROG3_DIR)\$(CFG)
+CARES_OBJDIR = $(CARES_OUTDIR)\obj
+PROG2_OBJDIR = $(PROG2_OUTDIR)\obj
+PROG3_OBJDIR = $(PROG3_OUTDIR)\obj
+!ELSE
+!UNDEF CARES_OUTDIR
+!UNDEF PROG2_OUTDIR
+!UNDEF PROG3_OUTDIR
+!UNDEF CARES_OBJDIR
+!UNDEF PROG2_OBJDIR
+!UNDEF PROG3_OBJDIR
+!ENDIF
+
+# -------------------------------------
+# Settings that depend on tcp/ip stack
+# -------------------------------------
+
+!IF "$(USE_WATT32)" == "1"
+CFLAGS = /UWIN32 /DWATT32 /I$(WATT_ROOT)\inc
+EX_LIBS_REL = $(WATT_ROOT)\lib\wattcpvc_imp.lib
+EX_LIBS_DBG = $(WATT_ROOT)\lib\wattcpvc_imp_d.lib
+!ELSE
+CFLAGS = /DWIN32 /D_WIN32_WINNT=0x0602
+EX_LIBS_REL = ws2_32.lib advapi32.lib kernel32.lib iphlpapi.lib
+EX_LIBS_DBG = ws2_32.lib advapi32.lib kernel32.lib iphlpapi.lib
+!ENDIF
+
+# -------------------------------------------------
+# Switches that depend on ancient compiler versions
+# -------------------------------------------------
+
+!IF $(CC_VERS_NUM) == 60
+PDB_NONE = /pdb:none
+PDBTYPE_CONSOLIDATE = /pdbtype:consolidate
+!ELSE
+!UNDEF PDB_NONE
+!UNDEF PDBTYPE_CONSOLIDATE
+!ENDIF
+
+!IF $(CC_VERS_NUM) <= 70
+RT_ERROR_CHECKING = /GZ
+!ELSE
+RT_ERROR_CHECKING = /RTCsu
+!ENDIF
+
+# ----------------------------
+# Assorted commands and flags
+# ----------------------------
+
+CC_CMD_REL = cl.exe /nologo $(RTLIB) /DNDEBUG /O2
+CC_CMD_DBG = cl.exe /nologo $(RTLIBD) /D_DEBUG /Od /Zi $(RT_ERROR_CHECKING)
+CC_CFLAGS = $(CFLAGS) /I.\src\lib /I.\include /W3 /EHsc /FD
+
+RC_CMD_REL = rc.exe /l 0x409 /d "NDEBUG"
+RC_CMD_DBG = rc.exe /l 0x409 /d "_DEBUG"
+
+LINK_CMD_LIB = link.exe /lib /nologo
+LINK_CMD_DLL = link.exe /dll /nologo /incremental:no /fixed:no
+LINK_CMD_EXE = link.exe /nologo /incremental:no /fixed:no /subsystem:console
+
+LINK_CMD_EXE_REL = $(LINK_CMD_EXE) /release $(PDB_NONE)
+LINK_CMD_EXE_DBG = $(LINK_CMD_EXE) /debug $(PDBTYPE_CONSOLIDATE)
+
+# ---------------------------------
+# Configuration dependent settings
+# ---------------------------------
+
+!IF "$(CFG)" == "lib-release"
+CARES_TARGET = $(STA_LIB_REL).lib
+CARES_CFLAGS = /DCARES_BUILDING_LIBRARY /DCARES_STATICLIB
+CARES_LFLAGS =
+SPROG_CFLAGS = /DCARES_STATICLIB
+SPROG_LFLAGS = /libpath:$(CARES_OUTDIR) $(EX_LIBS_REL) $(STA_LIB_REL).lib
+CARES_LINK = $(LINK_CMD_LIB)
+SPROG_LINK = $(LINK_CMD_EXE_REL)
+CC_CMD = $(CC_CMD_REL)
+!ENDIF
+
+!IF "$(CFG)" == "lib-debug"
+CARES_TARGET = $(STA_LIB_DBG).lib
+CARES_CFLAGS = /DCARES_BUILDING_LIBRARY /DCARES_STATICLIB /DDEBUGBUILD
+CARES_LFLAGS =
+SPROG_CFLAGS = /DCARES_STATICLIB
+SPROG_LFLAGS = /libpath:$(CARES_OUTDIR) $(EX_LIBS_DBG) $(STA_LIB_DBG).lib
+CARES_LINK = $(LINK_CMD_LIB)
+SPROG_LINK = $(LINK_CMD_EXE_DBG)
+CC_CMD = $(CC_CMD_DBG)
+!ENDIF
+
+!IF "$(CFG)" == "dll-release"
+CARES_TARGET = $(DYN_LIB_REL).dll
+CARES_CFLAGS = /DCARES_BUILDING_LIBRARY
+CARES_LFLAGS = /release $(EX_LIBS_REL) /implib:$(CARES_OUTDIR)\$(IMP_LIB_REL).lib $(PDB_NONE)
+SPROG_CFLAGS =
+SPROG_LFLAGS = /libpath:$(CARES_OUTDIR) $(EX_LIBS_REL) $(IMP_LIB_REL).lib
+CARES_LINK = $(LINK_CMD_DLL)
+SPROG_LINK = $(LINK_CMD_EXE_REL)
+CC_CMD = $(CC_CMD_REL)
+USE_RES_FILE = TRUE
+RC_CMD = $(RC_CMD_REL)
+!ENDIF
+
+!IF "$(CFG)" == "dll-debug"
+CARES_TARGET = $(DYN_LIB_DBG).dll
+CARES_CFLAGS = /DCARES_BUILDING_LIBRARY /DDEBUGBUILD
+CARES_LFLAGS = /debug $(EX_LIBS_DBG) /implib:$(CARES_OUTDIR)\$(IMP_LIB_DBG).lib /pdb:$(CARES_OUTDIR)\$(DYN_LIB_DBG).pdb $(PDBTYPE_CONSOLIDATE)
+SPROG_CFLAGS =
+SPROG_LFLAGS = /libpath:$(CARES_OUTDIR) $(EX_LIBS_DBG) $(IMP_LIB_DBG).lib
+CARES_LINK = $(LINK_CMD_DLL)
+SPROG_LINK = $(LINK_CMD_EXE_DBG)
+CC_CMD = $(CC_CMD_DBG)
+USE_RES_FILE = TRUE
+RC_CMD = $(RC_CMD_DBG)
+!ENDIF
+
+# --------------------------------------------
+# Makefile.inc provides lists of source files
+# --------------------------------------------
+
+!INCLUDE .\src\lib\Makefile.inc
+!INCLUDE .\src\tools\Makefile.inc
+
+# ----------------------------
+# Build lists of object files
+# ----------------------------
+
+!IF "$(VALID_CFGSET)" == "TRUE"
+
+!IF [ECHO CARES_OBJS=^$(CARES_OBJDIR)\$(CSOURCES: = $(CARES_OBJDIR^)\) > .\cares_objs.inc] == 0
+!INCLUDE .\cares_objs.inc
+!IF [DEL .\cares_objs.inc]
+!ENDIF
+!ELSE
+!ERROR Problem generating CARES_OBJS list.
+!ENDIF
+CARES_OBJS = $(CARES_OBJS:.c=.obj)
+!IF "$(USE_RES_FILE)" == "TRUE"
+CARES_OBJS = $(CARES_OBJS) $(CARES_OBJDIR)\cares.res
+!ENDIF
+
+!IF [ECHO PROG2_OBJS=^$(PROG2_OBJDIR)\$(SAMPLESOURCES: = $(PROG2_OBJDIR^)\) > .\prog2_objs.inc] == 0
+!INCLUDE .\prog2_objs.inc
+!IF [DEL .\prog2_objs.inc]
+!ENDIF
+!ELSE
+!ERROR Problem generating PROG2_OBJS list.
+!ENDIF
+PROG2_OBJS = $(PROG2_OBJS:.c=.obj)
+PROG2_OBJS = $(PROG2_OBJS:/=\)
+PROG2_OBJS = $(PROG2_OBJS) $(PROG2_OBJDIR)\adig.obj
+
+!IF [ECHO PROG3_OBJS=^$(PROG3_OBJDIR)\$(SAMPLESOURCES: = $(PROG3_OBJDIR^)\) > .\prog3_objs.inc] == 0
+!INCLUDE .\prog3_objs.inc
+!IF [DEL .\prog3_objs.inc]
+!ENDIF
+!ELSE
+!ERROR Problem generating PROG3_OBJS list.
+!ENDIF
+PROG3_OBJS = $(PROG3_OBJS:.c=.obj)
+PROG3_OBJS = $(PROG3_OBJS:/=\)
+PROG3_OBJS = $(PROG3_OBJS) $(PROG3_OBJDIR)\ahost.obj
+
+!ENDIF
+
+
+# --------------------------------
+# Only our custom inference rules
+# --------------------------------
+
+.SUFFIXES:
+.SUFFIXES: .c .rc
+
+{$(SRCDIR)\src\lib}.rc{$(CARES_OBJDIR)}.res:
+ $(RC_CMD) /Fo $@ $<
+
+{$(SRCDIR)\src\lib}.c{$(CARES_OBJDIR)}.obj:
+ $(CC_CMD) $(CC_CFLAGS) $(CARES_CFLAGS) /Fo$@ /Fd$(@D)\ /c $<
+
+{$(SRCDIR)\src\tools}.c{$(PROG2_OBJDIR)}.obj:
+ $(CC_CMD) $(CC_CFLAGS) $(SPROG_CFLAGS) /Fo$@ /Fd$(@D)\ /c $<
+
+{$(SRCDIR)\src\tools}.c{$(PROG3_OBJDIR)}.obj:
+ $(CC_CMD) $(CC_CFLAGS) $(SPROG_CFLAGS) /Fo$@ /Fd$(@D)\ /c $<
+
+# Hack Alert! we reference ../lib/ files in the Makefile.inc for tools as they
+# share some files with the library itself. We need to hack around that here.
+
+{$(SRCDIR)\src\lib}.c{$(PROG2_OBJDIR)\..\lib}.obj:
+ $(CC_CMD) $(CC_CFLAGS) $(SPROG_CFLAGS) /Fo$(PROG2_OBJDIR)\$(@F) /Fd$(PROG2_OBJDIR)\ /c $<
+
+{$(SRCDIR)\src\lib}.c{$(PROG3_OBJDIR)\..\lib}.obj:
+ $(CC_CMD) $(CC_CFLAGS) $(SPROG_CFLAGS) /Fo$(PROG3_OBJDIR)\$(@F) /Fd$(PROG3_OBJDIR)\ /c $<
+
+# ------------------------------------------------------------- #
+# ------------------------------------------------------------- #
+# Default target when no CFG library type has been specified, #
+# results in building target ALL for all c-ares library types. #
+# ------------------------------------------------------------- #
+# ------------------------------------------------------------- #
+
+!IF "$(VALID_CFGSET)" == "FALSE"
+
+ALL:
+ $(MAKE) /NOLOGO /f .\Makefile.msvc CFG=lib-release ALL
+ $(MAKE) /NOLOGO /f .\Makefile.msvc CFG=lib-debug ALL
+ $(MAKE) /NOLOGO /f .\Makefile.msvc CFG=dll-release ALL
+ $(MAKE) /NOLOGO /f .\Makefile.msvc CFG=dll-debug ALL
+
+clean:
+ @-RMDIR /S /Q $(BASE_DIR) >NUL 2>&1
+
+install:
+ @$(MAKE) /nologo /f .\Makefile.msvc CFG=lib-release install
+ @$(MAKE) /nologo /f .\Makefile.msvc CFG=lib-debug install
+ @$(MAKE) /nologo /f .\Makefile.msvc CFG=dll-release install
+ @$(MAKE) /nologo /f .\Makefile.msvc CFG=dll-debug install
+
+!ENDIF
+
+# ---------------------------------------------------------------------
+# Targets only available when a proper CFG library type has been given
+# ---------------------------------------------------------------------
+
+!IF "$(VALID_CFGSET)" == "TRUE"
+
+ALL: c-ares adig ahost
+ @
+
+# $(HHEADERS) $(CSOURCES)
+c-ares: $(CARES_OBJDIR) $(CARES_OBJS) $(CARES_OUTDIR)
+ $(CARES_LINK) $(CARES_LFLAGS) /out:$(CARES_OUTDIR)\$(CARES_TARGET) $(CARES_OBJS)
+! IF "$(USE_RES_FILE)" == "TRUE"
+ @if exist $(CARES_OUTDIR)\$(CARES_TARGET).manifest mt -nologo -manifest $(CARES_OUTDIR)\$(CARES_TARGET).manifest -outputresource:$(CARES_OUTDIR)\$(CARES_TARGET);2
+! ENDIF
+
+# adig.c $(SAMPLESOURCES) $(SAMPLEHEADERS)
+adig: c-ares $(PROG2_OBJDIR) $(PROG2_OBJS) $(PROG2_OUTDIR)
+ $(SPROG_LINK) $(SPROG_LFLAGS) /out:$(PROG2_OUTDIR)\adig.exe $(PROG2_OBJS:..\lib=)
+ @if exist $(PROG2_OUTDIR)\adig.exe.manifest mt -nologo -manifest $(PROG2_OUTDIR)\adig.exe.manifest -outputresource:$(PROG2_OUTDIR)\adig.exe;1
+
+# ahost.c $(SAMPLESOURCES) $(SAMPLEHEADERS)
+ahost: c-ares $(PROG3_OBJDIR) $(PROG3_OBJS) $(PROG3_OUTDIR)
+ $(SPROG_LINK) $(SPROG_LFLAGS) /out:$(PROG3_OUTDIR)\ahost.exe $(PROG3_OBJS:..\lib=)
+ @if exist $(PROG3_OUTDIR)\ahost.exe.manifest mt -nologo -manifest $(PROG3_OUTDIR)\ahost.exe.manifest -outputresource:$(PROG3_OUTDIR)\ahost.exe;1
+
+$(CARES_OUTDIR): $(CARES_DIR)
+ @if not exist $(CARES_OUTDIR) mkdir $(CARES_OUTDIR)
+
+$(PROG2_OUTDIR): $(PROG2_DIR)
+ @if not exist $(PROG2_OUTDIR) mkdir $(PROG2_OUTDIR)
+
+$(PROG3_OUTDIR): $(PROG3_DIR)
+ @if not exist $(PROG3_OUTDIR) mkdir $(PROG3_OUTDIR)
+
+$(CARES_OBJDIR): $(CARES_OUTDIR)
+ @if not exist $(CARES_OBJDIR) mkdir $(CARES_OBJDIR)
+
+$(PROG2_OBJDIR): $(PROG2_OUTDIR)
+ @if not exist $(PROG2_OBJDIR) mkdir $(PROG2_OBJDIR)
+
+$(PROG3_OBJDIR): $(PROG3_OUTDIR)
+ @if not exist $(PROG3_OBJDIR) mkdir $(PROG3_OBJDIR)
+
+clean:
+ @-RMDIR /S /Q $(CARES_OUTDIR) >NUL 2>&1
+ @-RMDIR /S /Q $(PROG2_OUTDIR) >NUL 2>&1
+ @-RMDIR /S /Q $(PROG3_OUTDIR) >NUL 2>&1
+
+install:
+ @if not exist $(CARES_OUTDIR)\$(CARES_TARGET) \
+ $(MAKE) /f .\Makefile.msvc CFG=$(CFG) c-ares
+ @if not exist "$(INSTALL_DIR)" mkdir "$(INSTALL_DIR)"
+ @if not exist "$(INSTALL_DIR_LIB)" mkdir "$(INSTALL_DIR_LIB)"
+ @if not exist "$(INSTALL_DIR_INC)" mkdir "$(INSTALL_DIR_INC)"
+ @copy /y $(CARES_OUTDIR)\*.* "$(INSTALL_DIR_LIB)" >NUL
+ @copy /y $(SRCDIR)\include\ares.h "$(INSTALL_DIR_INC)" >NUL
+ @copy /y $(SRCDIR)\include\ares_build.h "$(INSTALL_DIR_INC)" >NUL
+ @copy /y $(SRCDIR)\include\ares_rules.h "$(INSTALL_DIR_INC)" >NUL
+ @copy /y $(SRCDIR)\include\ares_version.h "$(INSTALL_DIR_INC)" >NUL
+ @copy /y $(SRCDIR)\include\ares_dns_record.h "$(INSTALL_DIR_INC)" >NUL
+ @echo Installed c-ares $(CFG)
+
+!ENDIF
+
+$(BASE_DIR):
+ @if not exist $(BASE_DIR) mkdir $(BASE_DIR)
+
+$(CARES_DIR): $(BASE_DIR)
+ @if not exist $(CARES_DIR) mkdir $(CARES_DIR)
+
+$(PROG2_DIR): $(BASE_DIR)
+ @if not exist $(PROG2_DIR) mkdir $(PROG2_DIR)
+
+$(PROG3_DIR): $(BASE_DIR)
+ @if not exist $(PROG3_DIR) mkdir $(PROG3_DIR)
+
+# End of Makefile.msvc
diff --git a/subprojects/c-ares/Makefile.netware b/subprojects/c-ares/Makefile.netware
@@ -0,0 +1,431 @@
+#################################################################
+#
+# Makefile for building libcares (NetWare version - gnu make)
+# Use: make -f Makefile.netware
+#
+# Copyright (C) Guenter Knauf
+# SPDX-License-Identifier: MIT
+#
+#################################################################
+
+# Edit the path below to point to the base of your Novell NDK.
+ifndef NDKBASE
+NDKBASE = c:/novell
+endif
+
+ifndef INSTDIR
+INSTDIR = ../ares-$(LIBCARES_VERSION_STR)-bin-nw
+endif
+
+# Edit the vars below to change NLM target settings.
+TARGETS = adig.nlm ahost.nlm
+LTARGET = libcares.$(LIBEXT)
+VERSION = $(LIBCARES_VERSION)
+COPYR = $(LIBCARES_COPYRIGHT_STR)
+DESCR = cURL $(subst .def,,$(notdir $@)) $(LIBCARES_VERSION_STR) - http://curl.haxx.se
+MTSAFE = YES
+STACK = 64000
+SCREEN = none
+#EXPORTS =
+# Comment the line below if you dont want to load protected automatically.
+#LDRING = 3
+
+# Edit the var below to point to your lib architecture.
+ifndef LIBARCH
+LIBARCH = LIBC
+endif
+
+# must be equal to NDEBUG or DEBUG
+ifndef DB
+DB = NDEBUG
+endif
+# Optimization: -O<n> or debugging: -g
+ifeq ($(DB),NDEBUG)
+ OPT = -O2
+ OBJDIR = release
+else
+ OPT = -g
+ OBJDIR = debug
+endif
+
+# Include the version info retrieved from curlver.h
+-include $(OBJDIR)/version.inc
+
+# The following lines defines your compiler.
+ifdef CWFolder
+ METROWERKS = $(CWFolder)
+endif
+ifdef METROWERKS
+ # MWCW_PATH = $(subst \,/,$(METROWERKS))/Novell Support
+ MWCW_PATH = $(subst \,/,$(METROWERKS))/Novell Support/Metrowerks Support
+ CC = mwccnlm
+else
+ CC = gcc
+endif
+# a native win32 awk can be downloaded from here:
+# http://www.gknw.net/development/prgtools/awk-20070501.zip
+AWK = awk
+YACC = bison -y
+CP = cp -afv
+MKDIR = mkdir
+# RM = rm -f
+# if you want to mark the target as MTSAFE you will need a tool for
+# generating the xdc data for the linker; here's a minimal tool:
+# http://www.gknw.net/development/prgtools/mkxdc.zip
+MPKXDC = mkxdc
+
+# Global flags for all compilers
+CFLAGS += $(OPT) -D$(DB) -DNETWARE -DHAVE_CONFIG_H -nostdinc
+
+ifeq ($(CC),mwccnlm)
+LD = mwldnlm
+LDFLAGS = -nostdlib $(PRELUDE) $(OBJEXE) $(<:.def=.o) -o $@ -commandfile
+AR = mwldnlm
+ARFLAGS = -nostdlib -type library -o
+LIBEXT = lib
+#RANLIB =
+CFLAGS += -msgstyle gcc -gccinc -inline off -opt nointrinsics -proc 586
+CFLAGS += -relax_pointers
+#CFLAGS += -w on
+ifeq ($(LIBARCH),LIBC)
+ PRELUDE = $(SDK_LIBC)/imports/libcpre.o
+ CFLAGS += -align 4
+else
+ # PRELUDE = $(SDK_CLIB)/imports/clibpre.o
+ # to avoid the __init_* / __deinit_* whose dont use prelude from NDK
+ PRELUDE = "$(MWCW_PATH)/libraries/runtime/prelude.obj"
+ # CFLAGS += -include "$(MWCW_PATH)/headers/nlm_clib_prefix.h"
+ CFLAGS += -align 1
+endif
+else
+LD = nlmconv
+LDFLAGS = -T
+AR = ar
+ARFLAGS = -cq
+LIBEXT = a
+RANLIB = ranlib
+CFLAGS += -m32
+CFLAGS += -fno-builtin -fno-strict-aliasing
+ifeq ($(findstring gcc,$(CC)),gcc)
+CFLAGS += -fpcc-struct-return
+endif
+CFLAGS += -Wall # -pedantic
+ifeq ($(LIBARCH),LIBC)
+ PRELUDE = $(SDK_LIBC)/imports/libcpre.gcc.o
+else
+ # PRELUDE = $(SDK_CLIB)/imports/clibpre.gcc.o
+ # to avoid the __init_* / __deinit_* whose dont use prelude from NDK
+ # http://www.gknw.net/development/mk_nlm/gcc_pre.zip
+ PRELUDE = $(NDK_ROOT)/pre/prelude.o
+ CFLAGS += -include $(NDKBASE)/nlmconv/genlm.h
+endif
+endif
+
+NDK_ROOT = $(NDKBASE)/ndk
+SDK_CLIB = $(NDK_ROOT)/nwsdk
+SDK_LIBC = $(NDK_ROOT)/libc
+
+ifeq ($(LIBARCH),LIBC)
+ INCLUDES += -I$(SDK_LIBC)/include
+ # INCLUDES += -I$(SDK_LIBC)/include/nks
+ # INCLUDES += -I$(SDK_LIBC)/include/winsock
+ CFLAGS += -D_POSIX_SOURCE
+else
+ INCLUDES += -I$(SDK_CLIB)/include/nlm
+ # INCLUDES += -I$(SDK_CLIB)/include/nlm/obsolete
+ # INCLUDES += -I$(SDK_CLIB)/include
+endif
+
+CFLAGS += -I. $(INCLUDES)
+
+ifeq ($(MTSAFE),YES)
+ XDCOPT = -n
+endif
+ifeq ($(MTSAFE),NO)
+ XDCOPT = -u
+endif
+
+ifeq ($(findstring /sh,$(SHELL)),/sh)
+DL = '
+#-include $(NDKBASE)/nlmconv/ncpfs.inc
+endif
+
+# Makefile.inc provides the CSOURCES and HHEADERS defines
+include Makefile.inc
+
+OBJLIB := $(patsubst %.c,$(OBJDIR)/%.o,$(strip $(CSOURCES)))
+OBJEXE = $(OBJLIB) $(OBJDIR)/ares_getopt.o
+
+.PHONY: lib nlm prebuild dist install clean
+
+lib: prebuild $(LTARGET)
+
+nlm: prebuild $(TARGETS)
+
+prebuild: $(OBJDIR) ares_build.h $(OBJDIR)/version.inc ares_config.h
+
+install: $(INSTDIR) all
+ @$(CP) *.nlm $(INSTDIR)
+ @$(CP) ../CHANGES $(INSTDIR)
+ @$(CP) ../COPYING $(INSTDIR)
+ @$(CP) ../README $(INSTDIR)
+ @$(CP) ../RELEASE-NOTES $(INSTDIR)
+
+clean:
+ -$(RM) $(LTARGET) $(TARGETS) ares_config.h
+ -$(RM) -r $(OBJDIR)
+ -$(RM) -r arpa
+
+%.$(LIBEXT): $(OBJLIB)
+ @echo Creating $@
+ @-$(RM) $@
+ @$(AR) $(ARFLAGS) $@ $^
+ifdef RANLIB
+ @$(RANLIB) $@
+endif
+
+%.nlm: $(OBJDIR)/%.def $(OBJDIR)/%.o $(OBJDIR)/%.xdc $(OBJEXE)
+ @echo Linking $@
+ @-$(RM) $@
+ @$(LD) $(LDFLAGS) $<
+
+$(OBJDIR) $(INSTDIR):
+ @$(MKDIR) $@
+
+$(OBJDIR)/%.o: %.c
+# @echo Compiling $<
+ $(CC) $(CFLAGS) -c $< -o $@
+
+$(OBJDIR)/version.inc: ares_version.h $(OBJDIR)
+ @echo Creating $@
+ @$(AWK) -f get_ver.awk $< > $@
+
+$(OBJDIR)/%.xdc: Makefile.netware
+ @echo Creating $@
+ @$(MPKXDC) $(XDCOPT) $@
+
+$(OBJDIR)/%.def: Makefile.netware
+ @echo Creating $@
+ @echo $(DL)# DEF file for linking with $(LD)$(DL) > $@
+ @echo $(DL)# Do not edit this file - it is created by make!$(DL) >> $@
+ @echo $(DL)# All your changes will be lost!!$(DL) >> $@
+ @echo $(DL)#$(DL) >> $@
+ @echo $(DL)copyright "$(COPYR)"$(DL) >> $@
+ @echo $(DL)description "$(DESCR)"$(DL) >> $@
+ @echo $(DL)version $(VERSION)$(DL) >> $@
+ifdef NLMTYPE
+ @echo $(DL)type $(NLMTYPE)$(DL) >> $@
+endif
+ifdef STACK
+ @echo $(DL)stack $(STACK)$(DL) >> $@
+endif
+ifdef SCREEN
+ @echo $(DL)screenname "$(SCREEN)"$(DL) >> $@
+else
+ @echo $(DL)screenname "DEFAULT"$(DL) >> $@
+endif
+ifeq ($(DB),DEBUG)
+ @echo $(DL)debug$(DL) >> $@
+endif
+ @echo $(DL)threadname "$^"$(DL) >> $@
+ifdef XDCOPT
+ @echo $(DL)xdcdata $(@:.def=.xdc)$(DL) >> $@
+endif
+ifeq ($(LDRING),0)
+ @echo $(DL)flag_on 16$(DL) >> $@
+endif
+ifeq ($(LDRING),3)
+ @echo $(DL)flag_on 512$(DL) >> $@
+endif
+ifeq ($(LIBARCH),CLIB)
+ @echo $(DL)start _Prelude$(DL) >> $@
+ @echo $(DL)exit _Stop$(DL) >> $@
+ @echo $(DL)import @$(SDK_CLIB)/imports/clib.imp$(DL) >> $@
+ @echo $(DL)import @$(SDK_CLIB)/imports/threads.imp$(DL) >> $@
+ @echo $(DL)import @$(SDK_CLIB)/imports/nlmlib.imp$(DL) >> $@
+ @echo $(DL)import @$(SDK_CLIB)/imports/socklib.imp$(DL) >> $@
+ @echo $(DL)module clib$(DL) >> $@
+else
+ @echo $(DL)flag_on 64$(DL) >> $@
+ @echo $(DL)pseudopreemption$(DL) >> $@
+ @echo $(DL)start _LibCPrelude$(DL) >> $@
+ @echo $(DL)exit _LibCPostlude$(DL) >> $@
+ @echo $(DL)check _LibCCheckUnload$(DL) >> $@
+ @echo $(DL)import @$(SDK_LIBC)/imports/libc.imp$(DL) >> $@
+ @echo $(DL)import @$(SDK_LIBC)/imports/netware.imp$(DL) >> $@
+ @echo $(DL)module libc$(DL) >> $@
+endif
+ifdef MODULES
+ @echo $(DL)module $(MODULES)$(DL) >> $@
+endif
+ifdef EXPORTS
+ @echo $(DL)export $(EXPORTS)$(DL) >> $@
+endif
+ifdef IMPORTS
+ @echo $(DL)import $(IMPORTS)$(DL) >> $@
+endif
+ifeq ($(LD),nlmconv)
+ @echo $(DL)input $(PRELUDE)$(DL) >> $@
+ @echo $(DL)input $(OBJEXE)$(DL) >> $@
+ @echo $(DL)input $(@:.def=.o)$(DL) >> $@
+ @echo $(DL)output $(notdir $(@:.def=.nlm))$(DL) >> $@
+endif
+
+ares_config.h: Makefile.netware
+ @echo Creating $@
+ @echo $(DL)/* $@ for NetWare target.$(DL) > $@
+ @echo $(DL)** Do not edit this file - it is created by make!$(DL) >> $@
+ @echo $(DL)** All your changes will be lost!!$(DL) >> $@
+ @echo $(DL)*/$(DL) >> $@
+ @echo $(DL)#ifndef NETWARE$(DL) >> $@
+ @echo $(DL)#error This $(notdir $@) is created for NetWare platform!$(DL) >> $@
+ @echo $(DL)#endif$(DL) >> $@
+ @echo $(DL)#define VERSION "$(LIBCARES_VERSION_STR)"$(DL) >> $@
+ @echo $(DL)#define PACKAGE_BUGREPORT "a suitable curl mailing list => http://curl.haxx.se/mail/"$(DL) >> $@
+ifeq ($(LIBARCH),CLIB)
+ @echo $(DL)#define OS "i586-pc-clib-NetWare"$(DL) >> $@
+ @echo $(DL)#define HAVE_STRICMP 1$(DL) >> $@
+ @echo $(DL)#define HAVE_STRNICMP 1$(DL) >> $@
+ @echo $(DL)#define NETDB_USE_INTERNET 1$(DL) >> $@
+ @echo $(DL)#define RECV_TYPE_ARG1 int$(DL) >> $@
+ @echo $(DL)#define RECV_TYPE_ARG2 char *$(DL) >> $@
+ @echo $(DL)#define RECV_TYPE_ARG3 int$(DL) >> $@
+ @echo $(DL)#define RECV_TYPE_ARG4 int$(DL) >> $@
+ @echo $(DL)#define RECV_TYPE_RETV int$(DL) >> $@
+ @echo $(DL)#define RECVFROM_TYPE_ARG1 int$(DL) >> $@
+ @echo $(DL)#define RECVFROM_TYPE_ARG2 char$(DL) >> $@
+ @echo $(DL)#define RECVFROM_TYPE_ARG3 int$(DL) >> $@
+ @echo $(DL)#define RECVFROM_TYPE_ARG4 int$(DL) >> $@
+ @echo $(DL)#define RECVFROM_TYPE_ARG5 struct sockaddr$(DL) >> $@
+ @echo $(DL)#define RECVFROM_TYPE_ARG6 int$(DL) >> $@
+ @echo $(DL)#define RECVFROM_TYPE_RETV int$(DL) >> $@
+ @echo $(DL)#define SEND_QUAL_ARG2$(DL) >> $@
+ @echo $(DL)#define SEND_TYPE_ARG1 int$(DL) >> $@
+ @echo $(DL)#define SEND_TYPE_ARG2 char *$(DL) >> $@
+ @echo $(DL)#define SEND_TYPE_ARG3 int$(DL) >> $@
+ @echo $(DL)#define SEND_TYPE_ARG4 int$(DL) >> $@
+ @echo $(DL)#define SEND_TYPE_RETV int$(DL) >> $@
+else
+ @echo $(DL)#define OS "i586-pc-libc-NetWare"$(DL) >> $@
+ @echo $(DL)#define HAVE_DLFCN_H 1$(DL) >> $@
+ @echo $(DL)#define HAVE_DLOPEN 1$(DL) >> $@
+ @echo $(DL)#define HAVE_FTRUNCATE 1$(DL) >> $@
+ @echo $(DL)#define HAVE_GETTIMEOFDAY 1$(DL) >> $@
+ @echo $(DL)#define HAVE_INTTYPES_H 1$(DL) >> $@
+ @echo $(DL)#define HAVE_LONGLONG 1$(DL) >> $@
+ @echo $(DL)#define HAVE_STDINT_H 1$(DL) >> $@
+ @echo $(DL)#define HAVE_STRCASECMP 1$(DL) >> $@
+ @echo $(DL)#define HAVE_STRLCAT 1$(DL) >> $@
+ @echo $(DL)#define HAVE_STRLCPY 1$(DL) >> $@
+ @echo $(DL)#define HAVE_STRTOLL 1$(DL) >> $@
+ @echo $(DL)#define HAVE_SYS_PARAM_H 1$(DL) >> $@
+ @echo $(DL)#define HAVE_SYS_SELECT_H 1$(DL) >> $@
+ @echo $(DL)#define HAVE_TERMIOS_H 1$(DL) >> $@
+ @echo $(DL)#define HAVE_AF_INET6 1$(DL) >> $@
+ @echo $(DL)#define HAVE_PF_INET6 1$(DL) >> $@
+ @echo $(DL)#define HAVE_FREEADDRINFO 1$(DL) >> $@
+ @echo $(DL)#define HAVE_GETADDRINFO 1$(DL) >> $@
+ @echo $(DL)#define HAVE_SOCKADDR_IN6_SIN6_SCOPE_ID 1$(DL) >> $@
+ @echo $(DL)#define HAVE_STRUCT_IN6_ADDR 1$(DL) >> $@
+ @echo $(DL)#define HAVE_STRUCT_SOCKADDR_IN6 1$(DL) >> $@
+ @echo $(DL)#define RECV_TYPE_ARG1 int$(DL) >> $@
+ @echo $(DL)#define RECV_TYPE_ARG2 void *$(DL) >> $@
+ @echo $(DL)#define RECV_TYPE_ARG3 size_t$(DL) >> $@
+ @echo $(DL)#define RECV_TYPE_ARG4 int$(DL) >> $@
+ @echo $(DL)#define RECV_TYPE_RETV ssize_t$(DL) >> $@
+ @echo $(DL)#define RECVFROM_TYPE_ARG1 int$(DL) >> $@
+ @echo $(DL)#define RECVFROM_TYPE_ARG2 void$(DL) >> $@
+ @echo $(DL)#define RECVFROM_TYPE_ARG3 size_t$(DL) >> $@
+ @echo $(DL)#define RECVFROM_TYPE_ARG4 int$(DL) >> $@
+ @echo $(DL)#define RECVFROM_TYPE_ARG5 struct sockaddr$(DL) >> $@
+ @echo $(DL)#define RECVFROM_TYPE_ARG6 size_t$(DL) >> $@
+ @echo $(DL)#define RECVFROM_TYPE_RETV ssize_t$(DL) >> $@
+ @echo $(DL)#define RECVFROM_TYPE_ARG2_IS_VOID 1$(DL) >> $@
+ @echo $(DL)#define SEND_QUAL_ARG2$(DL) >> $@
+ @echo $(DL)#define SEND_TYPE_ARG1 int$(DL) >> $@
+ @echo $(DL)#define SEND_TYPE_ARG2 void *$(DL) >> $@
+ @echo $(DL)#define SEND_TYPE_ARG3 size_t$(DL) >> $@
+ @echo $(DL)#define SEND_TYPE_ARG4 int$(DL) >> $@
+ @echo $(DL)#define SEND_TYPE_RETV ssize_t$(DL) >> $@
+endif
+ @echo $(DL)#define HAVE_ARPA_INET_H 1$(DL) >> $@
+ @echo $(DL)#define HAVE_ASSERT_H 1$(DL) >> $@
+ @echo $(DL)#define HAVE_ERRNO_H 1$(DL) >> $@
+ @echo $(DL)#define HAVE_ERR_H 1$(DL) >> $@
+ @echo $(DL)#define HAVE_FCNTL_H 1$(DL) >> $@
+ @echo $(DL)#define HAVE_GETENV 1$(DL) >> $@
+ @echo $(DL)#define HAVE_GETHOSTBYADDR 1$(DL) >> $@
+ @echo $(DL)#define HAVE_GETHOSTBYNAME 1$(DL) >> $@
+ @echo $(DL)#define HAVE_GETHOSTNAME 1$(DL) >> $@
+ @echo $(DL)#define HAVE_GETPROTOBYNAME 1$(DL) >> $@
+ @echo $(DL)#define HAVE_GMTIME_R 1$(DL) >> $@
+ @echo $(DL)#define HAVE_INET_ADDR 1$(DL) >> $@
+ @echo $(DL)#define HAVE_IOCTL 1$(DL) >> $@
+ @echo $(DL)#define HAVE_IOCTL_FIONBIO 1$(DL) >> $@
+ @echo $(DL)#define HAVE_LIMITS_H 1$(DL) >> $@
+ @echo $(DL)#define HAVE_LL 1$(DL) >> $@
+ @echo $(DL)#define HAVE_LOCALTIME_R 1$(DL) >> $@
+ @echo $(DL)#define HAVE_MALLOC_H 1$(DL) >> $@
+ @echo $(DL)#define HAVE_NETINET_IN_H 1$(DL) >> $@
+ @echo $(DL)#define HAVE_RECV 1$(DL) >> $@
+ @echo $(DL)#define HAVE_RECVFROM 1$(DL) >> $@
+ @echo $(DL)#define HAVE_SELECT 1$(DL) >> $@
+ @echo $(DL)#define HAVE_SEND 1$(DL) >> $@
+ @echo $(DL)#define HAVE_SETJMP_H 1$(DL) >> $@
+ @echo $(DL)#define HAVE_SIGNAL 1$(DL) >> $@
+ @echo $(DL)#define HAVE_SIGNAL_H 1$(DL) >> $@
+ @echo $(DL)#define HAVE_SIG_ATOMIC_T 1$(DL) >> $@
+ @echo $(DL)#define HAVE_SOCKET 1$(DL) >> $@
+ @echo $(DL)#define HAVE_STDLIB_H 1$(DL) >> $@
+ @echo $(DL)#define HAVE_STRDUP 1$(DL) >> $@
+ @echo $(DL)#define HAVE_STRFTIME 1$(DL) >> $@
+ @echo $(DL)#define HAVE_STRING_H 1$(DL) >> $@
+ @echo $(DL)#define HAVE_STRSTR 1$(DL) >> $@
+ @echo $(DL)#define HAVE_STRUCT_ADDRINFO 1$(DL) >> $@
+ @echo $(DL)#define HAVE_STRUCT_TIMEVAL 1$(DL) >> $@
+ @echo $(DL)#define HAVE_SYS_IOCTL_H 1$(DL) >> $@
+ @echo $(DL)#define HAVE_SYS_STAT_H 1$(DL) >> $@
+ @echo $(DL)#define HAVE_SYS_TIME_H 1$(DL) >> $@
+ @echo $(DL)#define HAVE_TIME_H 1$(DL) >> $@
+ @echo $(DL)#define HAVE_UNAME 1$(DL) >> $@
+ @echo $(DL)#define HAVE_UNISTD_H 1$(DL) >> $@
+ @echo $(DL)#define HAVE_UTIME 1$(DL) >> $@
+ @echo $(DL)#define HAVE_UTIME_H 1$(DL) >> $@
+ @echo $(DL)#define HAVE_WRITEV 1$(DL) >> $@
+ @echo $(DL)#define RETSIGTYPE void$(DL) >> $@
+ @echo $(DL)#define STDC_HEADERS 1$(DL) >> $@
+ @echo $(DL)#define TIME_WITH_SYS_TIME 1$(DL) >> $@
+ifdef NW_WINSOCK
+ @echo $(DL)#define HAVE_CLOSESOCKET 1$(DL) >> $@
+else
+ @echo $(DL)#define HAVE_SYS_TYPES_H 1$(DL) >> $@
+ @echo $(DL)#define HAVE_SYS_SOCKET_H 1$(DL) >> $@
+ @echo $(DL)#define HAVE_SYS_SOCKIO_H 1$(DL) >> $@
+ @echo $(DL)#define HAVE_NETDB_H 1$(DL) >> $@
+endif
+ @echo $(DL)#ifdef __GNUC__$(DL) >> $@
+ @echo $(DL)#define HAVE_VARIADIC_MACROS_GCC 1$(DL) >> $@
+ @echo $(DL)#else$(DL) >> $@
+ @echo $(DL)#define HAVE_VARIADIC_MACROS_C99 1$(DL) >> $@
+ @echo $(DL)#endif$(DL) >> $@
+
+FORCE: ;
+
+ares_build.h: Makefile.netware FORCE
+ @echo Creating $@
+ @echo $(DL)/* $@ intended for NetWare target.$(DL) > $@
+ @echo $(DL)** Do not edit this file - it is created by make!$(DL) >> $@
+ @echo $(DL)** All your changes will be lost!!$(DL) >> $@
+ @echo $(DL)*/$(DL) >> $@
+ @echo $(DL)#ifndef NETWARE$(DL) >> $@
+ @echo $(DL)#error This $(notdir $@) is created for NetWare platform!$(DL) >> $@
+ @echo $(DL)#endif$(DL) >> $@
+ @echo $(DL)#ifndef __CARES_BUILD_H$(DL) >> $@
+ @echo $(DL)#define __CARES_BUILD_H$(DL) >> $@
+ifeq ($(LIBARCH),CLIB)
+ @echo $(DL)#define CARES_TYPEOF_ARES_SOCKLEN_T int$(DL) >> $@
+else
+ @echo $(DL)#define CARES_TYPEOF_ARES_SOCKLEN_T unsigned int$(DL) >> $@
+endif
+ @echo $(DL)typedef CARES_TYPEOF_ARES_SOCKLEN_T ares_socklen_t;$(DL) >> $@
+ @echo $(DL)#endif /* __CARES_BUILD_H */$(DL) >> $@
diff --git a/subprojects/c-ares/NEWS b/subprojects/c-ares/NEWS
@@ -0,0 +1,21 @@
+Major changes since:
+* see the CHANGES file
+
+Major changes in release 1.1.1:
+* ares should now compile as C++ code (no longer uses reserved word
+ "class").
+* Added SRV support to adig test program.
+* Fixed a few error handling bugs in query processing.
+
+Major changes in release 1.1.0:
+* Added ares_free_string() function so that memory can be freed in the
+ same layer as it is allocated, a desirable feature in some
+ environments.
+* A few of the ares_dns.h macros are fixed to use the proper bitwise
+ operator.
+* Fixed a couple of fenceposts fixed in ares_expand_name()'s
+ bounds-checking.
+* In process_timeouts(), extract query->next before calling
+ next_server() and possibly freeing the query structure.
+* Casted arguments to ctype macros casted to unsigned char, since not
+ all char values are valid inputs to those macros according to ANSI.
diff --git a/subprojects/c-ares/README.cares b/subprojects/c-ares/README.cares
@@ -0,0 +1,15 @@
+c-ares
+======
+
+This package is based on ares 1.1.1 (written by Greg Hudson). Daniel Stenberg
+decided to fork and release a separate project since the original ares author
+didn't want the improvements that were vital for our use of it.
+
+This package is dubbed 'c-ares' since Daniel wanted this for use within the
+curl project (hence the letter C) and it makes a nice pun. c-ares is not API
+compatible with ares: a new name makes that more obvious to the public.
+
+The original libares was distributed at
+ftp://athena-dist.mit.edu:pub/ATHENA/ares (which seems to not be alive
+anymore). A local copy of the original ares package is kept here:
+https://c-ares.org/download/ares-1.1.1.tar.gz
diff --git a/subprojects/c-ares/README.md b/subprojects/c-ares/README.md
@@ -0,0 +1,67 @@
+c-ares
+======
+
+[](https://cirrus-ci.com/github/c-ares/c-ares)
+[](https://ci.appveyor.com/project/c-ares/c-ares/branch/master)
+[](https://coveralls.io/github/c-ares/c-ares)
+[](https://bestpractices.coreinfrastructure.org/projects/291)
+[](https://bugs.chromium.org/p/oss-fuzz/issues/list?sort=-opened&can=1&q=proj:c-ares)
+[](https://sonarcloud.io/summary/new_code?id=c-ares_c-ares)
+[](https://scan.coverity.com/projects/c-ares)
+
+This is c-ares, an asynchronous resolver library. It is intended for
+applications which need to perform DNS queries without blocking, or need to
+perform multiple DNS queries in parallel. The primary examples of such
+applications are servers which communicate with multiple clients and programs
+with graphical user interfaces.
+
+The full source code is available in the ['c-ares' release archives](https://c-ares.org/download/),
+and in a git repository: https://github.com/c-ares/c-ares. See the
+[INSTALL.md](INSTALL.md) file for build information.
+
+If you find bugs, correct flaws, have questions or have comments in general in
+regard to c-ares (or by all means the original ares too), get in touch with us
+on the c-ares mailing list: https://lists.haxx.se/listinfo/c-ares
+
+c-ares is distributed under the MIT license.
+
+You'll find all c-ares details and news here:
+ https://c-ares.org/
+
+
+Notes for c-ares hackers
+------------------------
+
+* The distributed `ares_build.h` file is only intended to be used on systems
+ which can not run the also distributed configure script.
+
+* The distributed `ares_build.h` file is generated as a copy of `ares_build.h.dist`
+ when the c-ares source code distribution archive file is originally created.
+
+* If you check out from git on a non-configure platform, you must run the
+ appropriate `buildconf*` script to set up `ares_build.h` and other local files
+ before being able to compile the library.
+
+* On systems capable of running the `configure` script, the `configure` process
+ will overwrite the distributed `ares_build.h` file with one that is suitable
+ and specific to the library being configured and built, this new file is
+ generated from the `ares_build.h.in` template file.
+
+* If you intend to distribute an already compiled c-ares library you **MUST**
+ also distribute along with it the generated `ares_build.h` which has been
+ used to compile it. Otherwise, the library will be of no use for the users of
+ the library that you have built. It is **your** responsibility to provide this
+ file. No one at the c-ares project can know how you have built the library.
+
+* File `ares_build.h` includes platform and configuration dependent info,
+ and must not be modified by anyone. Configure script generates it for you.
+
+* We cannot assume anything else but very basic compiler features being
+ present. While c-ares requires an ANSI C compiler to build, some of the
+ earlier ANSI compilers clearly can't deal with some preprocessor operators.
+
+* Newlines must remain unix-style for older compilers' sake.
+
+* Comments must be written in the old-style /* unnested C-fashion */
+
+* Try to keep line lengths below 80 columns.
diff --git a/subprojects/c-ares/README.msvc b/subprojects/c-ares/README.msvc
@@ -0,0 +1,102 @@
+
+
+ ___ __ _ _ __ ___ ___
+ / __| ___ / _` | '__/ _ \/ __|
+ | (_ |___| (_| | | | __/\__ \
+ \___| \__,_|_| \___||___/
+
+
+ How to build c-ares using MSVC or Visual Studio
+ =================================================
+
+
+
+ How to build using MSVC from the command line
+ ---------------------------------------------
+
+ Open a command prompt window and ensure that the environment is properly
+ set up in order to use MSVC or Visual Studio compiler tools.
+
+ Change to c-ares source folder where Makefile.msvc file is located and run:
+
+ > nmake -f Makefile.msvc
+
+ This will build all c-ares libraries as well as three sample programs.
+
+ Once the above command has finished a new folder named MSVCXX will exist
+ below the folder where makefile.msvc is found. The name of the folder
+ depends on the MSVC compiler version being used to build c-ares.
+
+ Below the MSVCXX folder there will exist four folders named 'cares',
+ 'ahost', and 'adig'. The 'cares' folder is the one that
+ holds the c-ares libraries you have just generated, the other three
+ hold sample programs that use the libraries.
+
+ The above command builds four versions of the c-ares library, dynamic
+ and static versions and each one in release and debug flavours. Each
+ of these is found in folders named dll-release, dll-debug, lib-release,
+ and lib-debug, which hang from the 'cares' folder mentioned above. Each
+ sample program also has folders with the same names to reflect which
+ library version it is using.
+
+
+ How to install using MSVC from the command line
+ -----------------------------------------------
+
+ In order to allow easy usage of c-ares libraries it may be convenient to
+ install c-ares libraries and header files to a common subdirectory tree.
+
+ Once that c-ares libraries have been built using procedure described above,
+ use same command prompt window to define environment variable INSTALL_DIR
+ to designate the top subdirectory where installation of c-ares libraries and
+ header files will be done.
+
+ > set INSTALL_DIR=c:\c-ares
+
+ Afterwards, run following command to actually perform the installation:
+
+ > nmake -f Makefile.msvc install
+
+ Installation procedure will copy c-ares libraries to subdirectory 'lib' and
+ c-ares header files to subdirectory 'include' below the INSTALL_DIR subdir.
+
+ When environment variable INSTALL_DIR is not defined, installation is done
+ to c-ares source folder where Makefile.msvc file is located.
+
+
+
+ Relationship between c-ares library file names and versions
+ -----------------------------------------------------------
+
+ c-ares static release library version files:
+
+ libcares.lib -> static release library
+
+ c-ares static debug library version files:
+
+ libcaresd.lib -> static debug library
+
+ c-ares dynamic release library version files:
+
+ cares.dll -> dynamic release library
+ cares.lib -> import library for the dynamic release library
+ cares.exp -> export file for the dynamic release library
+
+ c-ares dynamic debug library version files:
+
+ caresd.dll -> dynamic debug library
+ caresd.lib -> import library for the dynamic debug library
+ caresd.exp -> export file for the dynamic debug library
+ caresd.pdb -> debug symbol file for the dynamic debug library
+
+
+ How to use c-ares static libraries
+ ----------------------------------
+
+ When using the c-ares static library in your program, you will have to
+ define preprocessor symbol CARES_STATICLIB while building your program,
+ otherwise you will get errors at linkage stage.
+
+
+Have Fun!
+
diff --git a/subprojects/c-ares/RELEASE-NOTES b/subprojects/c-ares/RELEASE-NOTES
@@ -0,0 +1,47 @@
+c-ares version 1.25.0
+
+This is a maintenance release.
+
+Changes:
+ o AutoTools: rewrite build system to be lighter weight and fix issues in some
+ semi-modern systems. It is likely this has broken building on some less
+ common and legacy OSs, please report issues. [1]
+ o Rewrite ares_strsplit() as a wrapper for ares__buf_split() for memory
+ safety reasons. [4]
+ o The ahost utility now uses ares_getaddrinfo() and returns both IPv4 and
+ IPv6 addresses by default. [6]
+ o OpenBSD: Add SOCK_DNS flag when creating socket. [12]
+
+Bug Fixes:
+ o Tests: Live reverse lookups for Google's public DNS servers no longer
+ return results, replace with CloudFlare pubic DNS servers. [2]
+ o MacOS legacy SDKs require sys/socket.h before net/if.h [3]
+ o Connection failures should increment the server failure count first or a
+ retry might be enqueued to the same server. [5]
+ o On systems that don't implement the ability to enumerate network interfaces
+ the stubs used the wrong prototype. [7]
+ o Fix minor warnings and documentation typos. [8]
+ o Fix support for older GoogleTest versions. [9]
+ o getrandom() may require sys/random.h on some systems. [10]
+ o Fix building tests with symbol hiding enabled. [11]
+
+Thanks go to these friendly people for their efforts and contributions:
+ Brad House (@bradh352)
+ Daniel Stenberg (@bagder)
+ Gregor Jasny (@gjasny)
+ Martin Chang (@marty1885)
+(4 contributors)
+
+References to bug reports and discussions on issues:
+ [1] = https://github.com/c-ares/c-ares/pull/674
+ [2] = https://github.com/c-ares/c-ares/commit/1231aa7
+ [3] = https://github.com/c-ares/c-ares/pull/673
+ [4] = https://github.com/c-ares/c-ares/commit/88c444d
+ [5] = https://github.com/c-ares/c-ares/commit/05181a6
+ [6] = https://github.com/c-ares/c-ares/pull/669
+ [7] = https://github.com/c-ares/c-ares/commit/eebfe0c
+ [8] = https://github.com/c-ares/c-ares/pull/666
+ [9] = https://github.com/c-ares/c-ares/commit/d186f11
+ [10] = https://github.com/c-ares/c-ares/issues/665
+ [11] = https://github.com/c-ares/c-ares/issues/664
+ [12] = https://github.com/c-ares/c-ares/pull/659
diff --git a/subprojects/c-ares/RELEASE-PROCEDURE.md b/subprojects/c-ares/RELEASE-PROCEDURE.md
@@ -0,0 +1,54 @@
+c-ares release procedure - how to do a release
+==============================================
+
+in the source code repo
+-----------------------
+
+- edit `RELEASE-NOTES` to be accurate
+
+- edit `configure.ac`'s `CARES_VERSION_INFO`, and `CMakeLists.txt`'s
+ `CARES_LIB_VERSIONINFO` set to the same value to denote the current shared
+ object versioning.
+
+- edit `include/ares_version.h` and set `ARES_VERSION_*` definitions to reflect
+ the current version.
+
+- make sure all relevant changes are committed on the master branch
+
+- tag the git repo in this style: `git tag -a cares-1_14_0` -a annotates the
+ tag and we use underscores instead of dots in the version number.
+
+- run "./maketgz 1.14.0" to build the release tarball. It is important that
+ you run this on a machine with the correct set of autotools etc installed
+ as this is what then will be shipped and used by most users on *nix like
+ systems.
+
+- push the git commits and the new tag
+
+- gpg sign the tarball
+
+- upload the resulting files to https://c-ares.org/download/
+
+in the c-ares-www repo
+----------------------
+
+- edit `index.t` (version number and date),
+
+- edit `changelog.t` (add the new release in there)
+
+- commit all local changes
+
+- tag the repo with the same tag as used for the source repo
+
+- push the git commits and the new tag
+
+inform
+------
+
+- send an email to the c-ares mailing list. Insert the RELEASE-NOTES into the
+ mail.
+
+celebrate
+---------
+
+- suitable beverage intake is encouraged for the festivities
diff --git a/subprojects/c-ares/SECURITY.md b/subprojects/c-ares/SECURITY.md
@@ -0,0 +1,100 @@
+c-ares security
+===============
+
+This document is intended to provide guidance on how security vulnerabilities
+should be handled in the c-ares project.
+
+Publishing Information
+----------------------
+
+All known and public c-ares vulnerabilities will be listed on [the c-ares web
+site](https://c-ares.org/vulns.html).
+
+Security vulnerabilities should not be entered in the project's public bug
+tracker unless the necessary configuration is in place to limit access to the
+issue to only the reporter and the project's security team.
+
+Vulnerability Handling
+----------------------
+
+The typical process for handling a new security vulnerability is as follows.
+
+No information should be made public about a vulnerability until it is
+formally announced at the end of this process. That means, for example that a
+bug tracker entry must NOT be created to track the issue since that will make
+the issue public and it should not be discussed on the project's public
+mailing list. Also messages associated with any commits should not make any
+reference to the security nature of the commit if done prior to the public
+announcement.
+
+- The person discovering the issue, the reporter, reports the vulnerability
+ privately to `c-ares-security@haxx.se`. That's an email alias that reaches a
+ handful of selected and trusted people.
+
+- Messages that do not relate to the reporting or managing of an undisclosed
+ security vulnerability in c-ares are ignored and no further action is
+ required.
+
+- A person in the security team sends an e-mail to the original reporter to
+ acknowledge the report.
+
+- The security team investigates the report and either rejects it or accepts
+ it.
+
+- If the report is rejected, the team writes to the reporter to explain why.
+
+- If the report is accepted, the team writes to the reporter to let him/her
+ know it is accepted and that they are working on a fix.
+
+- The security team discusses the problem, works out a fix, considers the
+ impact of the problem and suggests a release schedule. This discussion
+ should involve the reporter as much as possible.
+
+- The release of the information should be "as soon as possible" and is most
+ often synced with an upcoming release that contains the fix. If the
+ reporter, or anyone else, thinks the next planned release is too far away
+ then a separate earlier release for security reasons should be considered.
+
+- Write a security advisory draft about the problem that explains what the
+ problem is, its impact, which versions it affects, solutions or
+ workarounds, when the release is out and make sure to credit all
+ contributors properly.
+
+- Request a CVE number from
+ [distros@openwall](http://oss-security.openwall.org/wiki/mailing-lists/distros)
+ when also informing and preparing them for the upcoming public security
+ vulnerability announcement - attach the advisory draft for information. Note
+ that 'distros' won't accept an embargo longer than 19 days.
+
+- Update the "security advisory" with the CVE number.
+
+- The security team commits the fix in a private branch. The commit message
+ should ideally contain the CVE number. This fix is usually also distributed
+ to the 'distros' mailing list to allow them to use the fix prior to the
+ public announcement.
+
+- At the day of the next release, the private branch is merged into the master
+ branch and pushed. Once pushed, the information is accessible to the public
+ and the actual release should follow suit immediately afterwards.
+
+- The project team creates a release that includes the fix.
+
+- The project team announces the release and the vulnerability to the world in
+ the same manner we always announce releases. It gets sent to the c-ares
+ mailing list and the oss-security mailing list.
+
+- The security web page on the web site should get the new vulnerability
+ mentioned.
+
+C-ARES-SECURITY (at haxx dot se)
+--------------------------------
+
+Who is on this list? There are a couple of criteria you must meet, and then we
+might ask you to join the list or you can ask to join it. It really isn't very
+formal. We basically only require that you have a long-term presence in the
+c-ares project and you have shown an understanding for the project and its way
+of working. You must've been around for a good while and you should have no
+plans in vanishing in the near future.
+
+We do not make the list of partipants public mostly because it tends to vary
+somewhat over time and a list somewhere will only risk getting outdated.
diff --git a/subprojects/c-ares/TODO b/subprojects/c-ares/TODO
@@ -0,0 +1,4 @@
+TODO
+====
+
+Please see https://github.com/c-ares/c-ares/issues
diff --git a/subprojects/c-ares/appveyor.yml b/subprojects/c-ares/appveyor.yml
@@ -0,0 +1,198 @@
+# Copyright (C) The c-ares project and its contributors
+# SPDX-License-Identifier: MIT
+
+image: Previous Visual Studio 2022
+
+# Github/Bitbucket only: get source code for one particular commit as zip archive, instead of git clone'ing.
+shallow_clone: true
+
+# Github/Bitbucket only: per-file commit filtering
+skip_commits:
+ files:
+ - .gitignore
+ - '**/*.md'
+ - .travis.yml
+ - .cirrus.yml
+ - '.github/**'
+
+# List of build configurations to test.
+configuration:
+ - DEBUG
+
+# Note: You can set extra cmake args for a particular matrix entry with CMAKE_EXTRA_OPTIONS. For example:
+# CMAKE_EXTRA_OPTIONS: -DOPENSSL_ROOT_DIR=C:/OpenSSL-Win32
+environment:
+ matrix:
+ # MSVC 2022, 32-bit x86 (cmake)
+ - COMPILER: MSVC
+ CONFTOOL: CMAKE
+ SYSTEM: CONSOLE
+ SKIP_TESTS: no
+ MSVC_SETUP_ARG: x86
+ MSVC_SETUP_PATH: C:\Program Files\Microsoft Visual Studio\2022\Community\VC\Auxiliary\Build\vcvars32.bat
+ CMAKE_EXTRA_OPTIONS: -GNinja -DCARES_BUILD_TESTS=ON -DGTEST_ROOT=C:\projects\googletest -DCMAKE_MSVC_RUNTIME_LIBRARY=MultiThreadedDebugDLL
+ TOOLSDIR: ./build/bin
+ TESTDIR: ./build/bin
+ BUILD_GOOGLETEST: yes
+
+ # MSVC 2022, 64-bit x64 (cmake)
+ - COMPILER: MSVC
+ CONFTOOL: CMAKE
+ SYSTEM: CONSOLE
+ SKIP_TESTS: no
+ MSVC_SETUP_ARG: x64
+ MSVC_SETUP_PATH: C:\Program Files\Microsoft Visual Studio\2022\Community\VC\Auxiliary\Build\vcvars64.bat
+ TOOLSDIR: ./build/bin
+ TESTDIR: ./build/bin
+ CMAKE_EXTRA_OPTIONS: -GNinja -DCARES_BUILD_TESTS=ON -DGTEST_ROOT=C:\projects\googletest -DCMAKE_MSVC_RUNTIME_LIBRARY=MultiThreadedDebugDLL
+ BUILD_GOOGLETEST: yes
+
+ # MinGW gcc via MSYS2 (latest version)
+ - COMPILER: MINGW
+ CONFTOOL: CMAKE
+ SYSTEM: MSYS2
+ SKIP_TESTS: no
+ MSYSTEM: MINGW64
+ TOOLSDIR: ./build/bin
+ TESTDIR: ./build/bin
+ CMAKE_EXTRA_OPTIONS: -GNinja
+ CHERE_INVOKING: YES
+
+ # MinGW gcc via MSYS2 using autotools
+ - COMPILER: MINGW
+ CONFTOOL: AUTOTOOLS
+ SKIP_TESTS: no
+ SYSTEM: MSYS2
+ MSYSTEM: MINGW64
+ TOOLSDIR: ./src/tools
+ TESTDIR: ./test
+ CHERE_INVOKING: YES
+
+ # MinGW clang UBSAN via MSYS2
+ - COMPILER: MINGW
+ CONFTOOL: CMAKE
+ SKIP_TESTS: no
+ SYSTEM: MSYS2
+ MSYSTEM: CLANG64
+ TOOLSDIR: ./build/bin
+ TESTDIR: ./build/bin
+ CMAKE_EXTRA_OPTIONS: -GNinja -DCMAKE_CXX_FLAGS=-fsanitize=undefined -DCMAKE_C_FLAGS=-fsanitize=undefined -DCMAKE_SHARED_LINKER_FLAGS=-fsanitize=undefined -DCMAKE_EXE_LINKER_FLAGS=-fsanitize=undefined
+ CHERE_INVOKING: YES
+
+ # MinGW clang ASAN via MSYS2 -- doesn't work due to some issue with clang itself
+ # - COMPILER: MINGW
+ # CONFTOOL: CMAKE
+ # SKIP_TESTS: no
+ # SYSTEM: MSYS2
+ # MSYSTEM: CLANG64
+ # TESTDIR: ./cmakebld/bin
+ # CMAKE_EXTRA_OPTIONS: -GNinja -DCMAKE_CXX_FLAGS=-fsanitize=address -DCMAKE_C_FLAGS=-fsanitize=address -DCMAKE_SHARED_LINKER_FLAGS=-fsanitize=address -DCMAKE_EXE_LINKER_FLAGS=-fsanitize=address
+ # CHERE_INVOKING: YES
+
+ # MSVC 2022, 64-bit x86 (nmake)
+ - COMPILER: MSVC
+ CONFTOOL: NMAKE
+ SYSTEM: CONSOLE
+ SKIP_TESTS: no
+ MSVC_SETUP_ARG: x64
+ MSVC_SETUP_PATH: C:\Program Files\Microsoft Visual Studio\2022\Community\VC\Auxiliary\Build\vcvars64.bat
+ BUILD_GOOGLETEST: yes
+
+ # MSVC 2022, 32-bit x86 (nmake)
+ - COMPILER: MSVC
+ CONFTOOL: NMAKE
+ SYSTEM: CONSOLE
+ SKIP_TESTS: no
+ MSVC_SETUP_ARG: x86
+ MSVC_SETUP_PATH: C:\Program Files\Microsoft Visual Studio\2022\Community\VC\Auxiliary\Build\vcvars32.bat
+ BUILD_GOOGLETEST: yes
+
+ # MinGW, 32-bit x86 (makefiles)
+ - COMPILER: MINGW
+ CONFTOOL: MAKE
+ SYSTEM: CONSOLE
+ SKIP_TESTS: no
+ PATH: C:\mingw-w64\i686-8.1.0-posix-dwarf-rt_v6-rev0\mingw32\bin;%PATH%
+ BUILD_GOOGLETEST: yes
+
+ # MinGW, 32-bit x86 (cmake static only)
+ - COMPILER: MINGW
+ CONFTOOL: CMAKE
+ SYSTEM: CONSOLE
+ SKIP_TESTS: no
+ TOOLSDIR: ./build/bin
+ TESTDIR: ./build/bin
+ PATH: C:\mingw-w64\i686-8.1.0-posix-dwarf-rt_v6-rev0\mingw32\bin;%PATH%
+ CMAKE_EXTRA_OPTIONS: -DCARES_SHARED=OFF -GNinja -DCARES_BUILD_TESTS=ON -DGTEST_ROOT=C:\projects\googletest
+ BUILD_GOOGLETEST: yes
+
+ # MSVC 2022, UWP (cmake)
+ - COMPILER: MSVC
+ CONFTOOL: CMAKE
+ SYSTEM: CONSOLE
+ SKIP_TESTS: yes
+ MSVC_SETUP_ARG: x64 store
+ MSVC_SETUP_PATH: C:\Program Files\Microsoft Visual Studio\2022\Community\VC\Auxiliary\Build\vcvarsall.bat
+ CMAKE_EXTRA_OPTIONS: -DCMAKE_SYSTEM_NAME=WindowsStore -DCMAKE_SYSTEM_VERSION=10.0 -A x64
+
+install:
+ - if "%COMPILER%" == "MINGW" rename "C:\Program Files\Git\usr\bin\sh.exe" "sh2.exe"
+
+before_build:
+ # Setup build environment for the selected compiler (not all compilers need to do anything here).
+ # -- Visual Studio --
+ - if "%COMPILER%" == "MSVC" call "%MSVC_SETUP_PATH%" %MSVC_SETUP_ARG%
+ - if "%SYSTEM%" == "MSYS2" C:\msys64\usr\bin\bash -lc "pacman --noconfirm -Syuu"
+ - if "%SYSTEM%" == "MSYS2" if "%MSYSTEM%" == "MINGW64" C:\msys64\usr\bin\bash -lc "pacman --noconfirm -Syu autoconf autoconf-archive automake libtool make git mingw-w64-x86_64-gcc mingw-w64-x86_64-cmake mingw-w64-x86_64-ninja mingw-w64-x86_64-gtest"
+ - if "%SYSTEM%" == "MSYS2" if "%MSYSTEM%" == "CLANG64" C:\msys64\usr\bin\bash -lc "pacman --noconfirm -Syu autoconf autoconf-archive automake libtool make git mingw-w64-clang-x86_64-clang mingw-w64-clang-x86_64-clang-analyzer mingw-w64-clang-x86_64-cmake mingw-w64-clang-x86_64-ninja mingw-w64-clang-x86_64-gtest"
+ - if "%BUILD_GOOGLETEST%" == "yes" git clone --depth=1 https://github.com/google/googletest googletest
+ - if "%BUILD_GOOGLETEST%" == "yes" cd googletest
+ - if "%BUILD_GOOGLETEST%" == "yes" cmake -DCMAKE_INSTALL_PREFIX=C:\projects\googletest -DCMAKE_POLICY_DEFAULT_CMP0091:STRING=NEW -DCMAKE_MSVC_RUNTIME_LIBRARY=MultiThreadedDebugDLL -GNinja -Bbuild
+ - if "%BUILD_GOOGLETEST%" == "yes" cmake --build build --config Debug
+ - if "%BUILD_GOOGLETEST%" == "yes" cmake --install build --config Debug
+ - if "%BUILD_GOOGLETEST%" == "yes" cd ..
+
+build_script:
+ - if "%SYSTEM%" == "MSYS2" if "%CONFTOOL%" == "CMAKE" C:\msys64\usr\bin\bash -lc "%ANALYZE_PREFIX% cmake -DCMAKE_BUILD_TYPE=%configuration% -DCMAKE_INSTALL_PREFIX=C:/projects/build-cares/test_install -DCARES_STATIC=ON -DCARES_STATIC_PIC=ON -DCARES_BUILD_TESTS=ON %CMAKE_EXTRA_OPTIONS% -Bbuild ."
+ - if "%SYSTEM%" == "MSYS2" if "%CONFTOOL%" == "CMAKE" C:\msys64\usr\bin\bash -lc "%ANALYZE_PREFIX% cmake --build build"
+ - if "%SYSTEM%" == "MSYS2" if "%CONFTOOL%" == "AUTOTOOLS" C:\msys64\usr\bin\bash -lc "./buildconf"
+ - if "%SYSTEM%" == "MSYS2" if "%CONFTOOL%" == "AUTOTOOLS" C:\msys64\usr\bin\bash -lc "%ANALYZE_PREFIX% ./configure --enable-static --disable-shared --enable-tests"
+ - if "%SYSTEM%" == "MSYS2" if "%CONFTOOL%" == "AUTOTOOLS" C:\msys64\usr\bin\bash -lc "%ANALYZE_PREFIX% make"
+ - if "%SYSTEM%" == "CONSOLE" if "%CONFTOOL%" == "NMAKE" copy .\include\ares_build.h.dist .\include\ares_build.h
+ - if "%SYSTEM%" == "CONSOLE" if "%CONFTOOL%" == "NMAKE" nmake /NOLOGO /f .\Makefile.msvc
+ - if "%SYSTEM%" == "CONSOLE" if "%CONFTOOL%" == "CMAKE" cmake -DCMAKE_BUILD_TYPE=%configuration% -DCMAKE_INSTALL_PREFIX=C:\projects\build-cares\test_install -DCARES_STATIC=ON -DCARES_STATIC_PIC=ON %CMAKE_EXTRA_OPTIONS% -Bbuild
+ - if "%SYSTEM%" == "CONSOLE" if "%CONFTOOL%" == "CMAKE" cmake --build build --config Debug
+ - if "%SYSTEM%" == "CONSOLE" if "%CONFTOOL%" == "CMAKE" cmake --install build --config Debug
+ - if "%SYSTEM%" == "CONSOLE" if "%CONFTOOL%" == "MAKE" copy .\include\ares_build.h.dist .\include\ares_build.h
+ - if "%SYSTEM%" == "CONSOLE" if "%CONFTOOL%" == "MAKE" mingw32-make.exe -f Makefile.m32 demos
+
+test_script:
+ # We can't use powershell for tests due to treating stderr as an error
+ - if "%SYSTEM%" == "MSYS2" if not "%SKIP_TESTS%" == "yes" C:\msys64\usr\bin\bash -lc "%TOOLSDIR%/adig.exe www.google.com"
+ - if "%SYSTEM%" == "MSYS2" if not "%SKIP_TESTS%" == "yes" C:\msys64\usr\bin\bash -lc "%TOOLSDIR%/ahost.exe www.google.com"
+ - if "%SYSTEM%" == "MSYS2" if not "%SKIP_TESTS%" == "yes" C:\msys64\usr\bin\bash -lc "%TESTDIR%/arestest.exe -4 -v --gtest_filter=-*LiveSearchTXT*:*LiveSearchANY*:*LiveGetLocalhostByAddr*"
+ - if "%SYSTEM%" == "CONSOLE" if "%CONFTOOL%" == "NMAKE" if not "%SKIP_TESTS%" == "yes" cd test
+ - if "%SYSTEM%" == "CONSOLE" if "%CONFTOOL%" == "NMAKE" if not "%SKIP_TESTS%" == "yes" nmake GTEST_ROOT=C:\projects\googletest /NOLOGO /f .\Makefile.msvc vtest
+ - if "%SYSTEM%" == "CONSOLE" if "%CONFTOOL%" == "NMAKE" if not "%SKIP_TESTS%" == "yes" nmake GTEST_ROOT=C:\projects\googletest /NOLOGO /f .\Makefile.msvc aresfuzz aresfuzzname dnsdump
+ - if "%SYSTEM%" == "CONSOLE" if "%CONFTOOL%" == "NMAKE" if not "%SKIP_TESTS%" == "yes" .\msvc\arestest\lib-debug\dnsdump.exe fuzzinput\answer_a fuzzinput\answer_aaaa
+ - if "%SYSTEM%" == "CONSOLE" if "%CONFTOOL%" == "MAKE" if not "%SKIP_TESTS%" == "yes" cd test
+ - if "%SYSTEM%" == "CONSOLE" if "%CONFTOOL%" == "MAKE" if not "%SKIP_TESTS%" == "yes" mingw32-make.exe GTEST_ROOT=C:\projects\googletest -f Makefile.m32 vtest
+ - if "%SYSTEM%" == "CONSOLE" if "%CONFTOOL%" == "MAKE" if not "%SKIP_TESTS%" == "yes" mingw32-make.exe GTEST_ROOT=C:\projects\googletest -f Makefile.m32 aresfuzz.exe aresfuzzname.exe dnsdump.exe
+ - if "%SYSTEM%" == "CONSOLE" if "%CONFTOOL%" == "MAKE" if not "%SKIP_TESTS%" == "yes" .\dnsdump.exe fuzzinput\answer_a fuzzinput\answer_aaaa
+ - if "%SYSTEM%" == "CONSOLE" if "%CONFTOOL%" == "CMAKE" if not "%SKIP_TESTS%" == "yes" cd %TESTDIR%
+ - if "%SYSTEM%" == "CONSOLE" if "%CONFTOOL%" == "CMAKE" if not "%SKIP_TESTS%" == "yes" .\adig.exe www.google.com
+ - if "%SYSTEM%" == "CONSOLE" if "%CONFTOOL%" == "CMAKE" if not "%SKIP_TESTS%" == "yes" .\ahost.exe www.google.com
+ - if "%SYSTEM%" == "CONSOLE" if "%CONFTOOL%" == "CMAKE" if not "%SKIP_TESTS%" == "yes" .\arestest.exe -4 -v --gtest_filter=-*LiveSearchTXT*:*LiveSearchANY*:*LiveGetLocalhostByAddr*
+ - if "%SYSTEM%" == "CONSOLE" if "%CONFTOOL%" == "CMAKE" if not "%SKIP_TESTS%" == "yes" .\dnsdump.exe "%APPVEYOR_BUILD_FOLDER%\test\fuzzinput\answer_a" "%APPVEYOR_BUILD_FOLDER%\test\fuzzinput\answer_aaaa"
+
+#on_finish:
+# - cd C:\projects\build-cares\test
+# - dir /B *.log > list.txt
+# - cmake -E tar cfv all_tests.zip --format=zip --files-from=list.txt
+# - appveyor PushArtifact all_tests.zip
+# - ps: $blockRdp = $true; iex ((new-object net.webclient).DownloadString('https://raw.githubusercontent.com/appveyor/ci/master/scripts/enable-rdp.ps1'))
+# Force build worker to stay open after build is done, so we can RDP into it.
+
+# Enable RDP connections into build worker.
+#init:
+# - ps: iex ((new-object net.webclient).DownloadString('https://raw.githubusercontent.com/appveyor/ci/master/scripts/enable-rdp.ps1'))
diff --git a/subprojects/c-ares/buildconf b/subprojects/c-ares/buildconf
@@ -0,0 +1,6 @@
+#!/bin/sh
+# Copyright (C) The c-ares project and its contributors
+# SPDX-License-Identifier: MIT
+
+echo "*** Do not use buildconf. Instead, just use: autoreconf -fi" >&2
+exec ${AUTORECONF:-autoreconf} -fi "${@}"
diff --git a/subprojects/c-ares/buildconf.bat b/subprojects/c-ares/buildconf.bat
@@ -0,0 +1,23 @@
+@echo off
+REM
+REM
+REM This batch file must be used to set up a git tree to build on
+REM systems where there is no autotools support (i.e. Microsoft).
+REM
+REM This file is not included nor needed for c-ares' release
+REM archives, neither for c-ares' daily snapshot archives.
+REM
+REM Copyright (C) The c-ares project and its contributors
+REM SPDX-License-Identifier: MIT
+
+if exist GIT-INFO goto start_doing
+ECHO ERROR: This file shall only be used with a c-ares git checkout.
+goto end_all
+:start_doing
+
+if not exist include\ares_build.h.dist goto end_ares_build_h
+copy /Y include\ares_build.h.dist include\ares_build.h
+:end_ares_build_h
+
+:end_all
+
diff --git a/subprojects/c-ares/c-ares-config.cmake.in b/subprojects/c-ares/c-ares-config.cmake.in
@@ -0,0 +1,27 @@
+# Copyright (C) The c-ares project and its contributors
+# SPDX-License-Identifier: MIT
+
+@PACKAGE_INIT@
+
+set_and_check(c-ares_INCLUDE_DIR "@PACKAGE_CMAKE_INSTALL_INCLUDEDIR@")
+
+include("${CMAKE_CURRENT_LIST_DIR}/c-ares-config-version.cmake")
+include("${CMAKE_CURRENT_LIST_DIR}/c-ares-targets.cmake")
+
+set(c-ares_LIBRARY c-ares::cares)
+
+if(@CARES_SHARED@)
+ if(NOT TARGET c-ares::cares_shared)
+ add_library(c-ares::cares_shared INTERFACE IMPORTED)
+ set_target_properties(c-ares::cares_shared PROPERTIES INTERFACE_LINK_LIBRARIES "c-ares::cares")
+ endif()
+ set(c-ares_SHARED_LIBRARY c-ares::cares_shared)
+endif()
+
+if(@CARES_STATIC@)
+ if(NOT TARGET c-ares::cares_static)
+ add_library(c-ares::cares_static INTERFACE IMPORTED)
+ set_target_properties(c-ares::cares_static PROPERTIES INTERFACE_LINK_LIBRARIES "c-ares::cares")
+ endif()
+ set(c-ares_STATIC_LIBRARY c-ares::cares_static)
+endif()
diff --git a/subprojects/c-ares/ci/build.sh b/subprojects/c-ares/ci/build.sh
@@ -0,0 +1,38 @@
+#!/bin/sh
+# Copyright (C) The c-ares project and its contributors
+# SPDX-License-Identifier: MIT
+set -e
+
+OS=""
+if [ "$TRAVIS_OS_NAME" != "" ]; then
+ OS="$TRAVIS_OS_NAME"
+elif [ "$CIRRUS_OS" != "" ]; then
+ OS="$CIRRUS_OS"
+fi
+
+if [ "$DIST" = "iOS" ] ; then
+ XCODE_PATH=`xcode-select -print-path`
+ SYSROOT="${XCODE_PATH}/Platforms/iPhoneOS.platform/Developer/SDKs/iPhoneOS.sdk/"
+fi
+
+if [ "$BUILD_TYPE" = "autotools" -o "$BUILD_TYPE" = "coverage" ]; then
+ autoreconf -fi
+ mkdir atoolsbld
+ cd atoolsbld
+ if [ "$DIST" = "iOS" ] ; then
+ export CFLAGS="${CFLAGS} -isysroot ${SYSROOT}"
+ export CXXFLAGS="${CXXFLAGS} -isysroot ${SYSROOT}"
+ export LDFLAGS="${LDFLAGS} -isysroot ${SYSROOT}"
+ fi
+ export CFLAGS="${CFLAGS} -O0 -g"
+ export CXXFLAGS="${CXXFLAGS} -O0 -g"
+ $SCAN_WRAP ../configure --disable-symbol-hiding --enable-maintainer-mode $CONFIG_OPTS
+ $SCAN_WRAP make
+else
+ # Use cmake for everything else
+ if [ "$DIST" = "iOS" ] ; then
+ CMAKE_FLAGS="${CMAKE_FLAGS} -DCMAKE_OSX_SYSROOT=${SYSROOT}"
+ fi
+ $SCAN_WRAP cmake ${CMAKE_FLAGS} ${CMAKE_TEST_FLAGS} -Bcmakebld .
+ $SCAN_WRAP cmake --build cmakebld
+fi
diff --git a/subprojects/c-ares/ci/covupload.sh b/subprojects/c-ares/ci/covupload.sh
@@ -0,0 +1,14 @@
+#!/bin/bash
+# Copyright (C) The c-ares project and its contributors
+# SPDX-License-Identifier: MIT
+set -e
+if [ "$BUILD_TYPE" = "coverage" ]; then
+ echo "CI_NAME=${CI_NAME}"
+ echo "CI_BUILD_NUMBER=${CI_BUILD_NUMBER}"
+ echo "CI_BUILD_URL=${CI_BUILD_URL}"
+ echo "CI_BRANCH=${CI_BRANCH}"
+ echo "CI_PULL_REQUEST=${CI_PULL_REQUEST}"
+ PATH="${PATH}:/root/.local/bin:~/.local/bin"
+ export PATH
+ coveralls --gcov-options '\-lp'
+fi
diff --git a/subprojects/c-ares/ci/distcheck.sh b/subprojects/c-ares/ci/distcheck.sh
@@ -0,0 +1,35 @@
+#!/bin/sh
+# Copyright (C) The c-ares project and its contributors
+# SPDX-License-Identifier: MIT
+set -e
+
+OS=""
+if [ "$TRAVIS_OS_NAME" != "" ]; then
+ OS="$TRAVIS_OS_NAME"
+elif [ "$CIRRUS_OS" != "" ]; then
+ OS="$CIRRUS_OS"
+fi
+
+if [ "$OS" = "linux" ]; then
+ # Make distribution tarball
+ ./maketgz 99.98.97
+ # Extract distribution tarball for building
+ tar xvf c-ares-99.98.97.tar.gz
+ cd c-ares-99.98.97
+ # Build autotools
+ mkdir build-autotools
+ cd build-autotools
+ ../configure --disable-symbol-hiding --enable-expose-statics --enable-maintainer-mode --enable-debug
+ make
+ cd test
+ $TEST_WRAP ./arestest -4 -v $TEST_FILTER
+ cd ../..
+ # Build CMake
+ mkdir build-cmake
+ cd build-cmake
+ cmake -DCMAKE_BUILD_TYPE=DEBUG -DCARES_STATIC=ON -DCARES_STATIC_PIC=ON -DCARES_BUILD_TESTS=ON ..
+ make
+ cd bin
+ $TEST_WRAP ./arestest -4 -v $TEST_FILTER
+ cd ../..
+fi
diff --git a/subprojects/c-ares/ci/test.sh b/subprojects/c-ares/ci/test.sh
@@ -0,0 +1,40 @@
+#!/bin/sh
+# Copyright (C) The c-ares project and its contributors
+# SPDX-License-Identifier: MIT
+set -e
+
+# Travis on MacOS uses CloudFlare's DNS (1.1.1.1/1.0.0.1) which rejects ANY requests.
+# Also, LiveSearchTXT is known to fail on Cirrus-CI on some MacOS hosts, we don't get
+# a truncated UDP response so we never follow up with TCP.
+# Note res_ninit() and /etc/resolv.conf actually have different configs, bad Travis
+[ -z "$TEST_FILTER" ] && export TEST_FILTER="--gtest_filter=-*LiveSearchTXT*:*LiveSearchANY*"
+
+# No tests for ios as it is a cross-compile
+if [ "$BUILD_TYPE" = "ios" -o "$BUILD_TYPE" = "ios-cmake" -o "$DIST" = "iOS" ] ; then
+ exit 0
+fi
+
+# Analyze tests don't need runtime, its static analysis
+if [ "$BUILD_TYPE" = "analyze" ] ; then
+ exit 0
+fi
+
+PWD=`pwd`
+TESTDIR="${PWD}/test"
+
+if [ "$BUILD_TYPE" = "autotools" -o "$BUILD_TYPE" = "coverage" ]; then
+ TOOLSBIN="${PWD}/atoolsbld/src/tools"
+ TESTSBIN="${PWD}/atoolsbld/test"
+else
+ TOOLSBIN="${PWD}/cmakebld/bin"
+ TESTSBIN="${PWD}/cmakebld/bin"
+fi
+
+$TEST_WRAP "${TOOLSBIN}/adig" www.google.com
+$TEST_WRAP "${TOOLSBIN}/ahost" www.google.com
+cd "${TESTSBIN}"
+$TEST_WRAP ./arestest -4 -v $TEST_FILTER
+./aresfuzz ${TESTDIR}/fuzzinput/*
+./aresfuzzname ${TESTDIR}/fuzznames/*
+./dnsdump "${TESTDIR}/fuzzinput/answer_a" "${TESTDIR}/fuzzinput/answer_aaaa"
+cd "${PWD}"
diff --git a/subprojects/c-ares/cmake/EnableWarnings.cmake b/subprojects/c-ares/cmake/EnableWarnings.cmake
@@ -0,0 +1,399 @@
+# Copyright (c) Monetra Technologies LLC
+# SPDX-License-Identifier: MIT
+
+# EnableWarnings.cmake
+#
+# Checks for and turns on a large number of warning C flags.
+#
+# Adds the following helper functions:
+#
+# remove_warnings(... list of warnings ...)
+# Turn off given list of individual warnings for all targets and subdirectories added after this.
+#
+# remove_all_warnings()
+# Remove all warning flags, add -w to suppress built-in warnings.
+#
+# remove_all_warnings_from_targets(... list of targets ...)
+# Suppress warnings for the given targets only.
+#
+# push_warnings()
+# Save current warning flags by pushing them onto an internal stack. Note that modifications to the internal
+# stack are only visible in the current CMakeLists.txt file and its children.
+#
+# Note: changing warning flags multiple times in the same directory only affects add_subdirectory() calls.
+# Targets in the directory will always use the warning flags in effect at the end of the CMakeLists.txt
+# file - this is due to really weird and annoying legacy behavior of CMAKE_C_FLAGS.
+#
+# pop_warnings()
+# Restore the last set of flags that were saved with push_warnings(). Note that modifications to the internal
+# stack are only visible in the current CMakeLists.txt file and its children.
+#
+
+if (_internal_enable_warnings_already_run)
+ return()
+endif ()
+set(_internal_enable_warnings_already_run TRUE)
+
+include(CheckCCompilerFlag)
+include(CheckCXXCompilerFlag)
+
+get_property(languages GLOBAL PROPERTY ENABLED_LANGUAGES)
+
+# internal helper: _int_enable_warnings_set_flags_ex(langs_var configs_var [warnings flags])
+function(_int_enable_warnings_set_flags_ex langs_var configs_var)
+ if (NOT ARGN)
+ return()
+ endif ()
+
+ if (NOT ${configs_var})
+ set(${configs_var} "NONE")
+ endif ()
+ string(TOUPPER "${${configs_var}}" ${configs_var})
+
+ foreach(_flag ${ARGN})
+ string(MAKE_C_IDENTIFIER "HAVE_${_flag}" varname)
+
+ if ("C" IN_LIST ${langs_var})
+ check_c_compiler_flag(${_flag} ${varname})
+ if (${varname})
+ foreach (config IN LISTS ${configs_var})
+ if (config STREQUAL "NONE")
+ set(config)
+ else ()
+ set(config "_${config}")
+ endif ()
+ string(APPEND CMAKE_C_FLAGS${config} " ${_flag}")
+ endforeach ()
+ endif ()
+ endif ()
+
+ if ("CXX" IN_LIST ${langs_var})
+ string(APPEND varname "_CXX")
+ check_cxx_compiler_flag(${_flag} ${varname})
+ if (${varname})
+ foreach (config IN LISTS ${configs_var})
+ if (config STREQUAL "NONE")
+ set(config)
+ else ()
+ set(config "_${config}")
+ endif ()
+ string(APPEND CMAKE_CXX_FLAGS${config} " ${_flag}")
+ endforeach ()
+ endif ()
+ endif ()
+ endforeach()
+
+ foreach(lang C CXX)
+ foreach (config IN LISTS ${configs_var})
+ string(TOUPPER "${config}" config)
+ if (config STREQUAL "NONE")
+ set(config)
+ else ()
+ set(config "_${config}")
+ endif ()
+ string(STRIP "${CMAKE_${lang}_FLAGS${config}}" CMAKE_${lang}_FLAGS${config})
+ set(CMAKE_${lang}_FLAGS${config} "${CMAKE_${lang}_FLAGS${config}}" PARENT_SCOPE)
+ endforeach ()
+ endforeach()
+endfunction()
+
+# internal helper: _int_enable_warnings_set_flags(langs_var [warnings flags])
+macro(_int_enable_warnings_set_flags langs_var)
+ set(configs "NONE")
+ _int_enable_warnings_set_flags_ex(${langs_var} configs ${ARGN})
+endmacro()
+
+set(_flags_C)
+set(_flags_CXX)
+set(_debug_flags_C)
+set(_debug_flags_CXX)
+
+if (MSVC)
+ # Visual Studio uses a completely different nomenclature for warnings than gcc/mingw/clang, so none of the
+ # "-W[name]" warnings will work.
+
+ # W4 would be better but it produces unnecessary warnings like:
+ # * warning C4706: assignment within conditional expression
+ # Triggered when doing "while(1)"
+ # * warning C4115: 'timeval' : named type definition in parentheses
+ # * warning C4201: nonstandard extension used : nameless struct/union
+ # Triggered by system includes (commctrl.h, shtypes.h, Shlobj.h)
+ set(_flags
+ /W3
+ /we4013 # Treat "function undefined, assuming extern returning int" warning as an error. https://docs.microsoft.com/en-us/cpp/error-messages/compiler-warnings/compiler-warning-level-3-c4013
+ )
+
+ list(APPEND _flags_C ${_flags})
+ list(APPEND _flags_CXX ${_flags})
+
+elseif (CMAKE_C_COMPILER_ID MATCHES "Intel")
+ # Intel's compiler warning flags are more like Visual Studio than GCC, though the numbers aren't the same.
+ set(_flags
+ # Use warning level 3, quite wordy.
+ -w3
+ # Disable warnings we don't care about (add more as they are encountered).
+ -wd383 # Spammy warning about initializing from a temporary object in C++ (which is done all the time ...).
+ -wd11074 # Diagnostic related to inlining.
+ -wd11076 # Diagnostic related to inlining.
+ )
+
+ list(APPEND _flags_C ${_flags})
+ list(APPEND _flags_CXX ${_flags})
+
+elseif (CMAKE_C_COMPILER_ID MATCHES "XL")
+ set (_flags
+ -qwarn64
+ -qformat=all
+ -qflag=i:i
+ )
+ list(APPEND _flags_C ${_flags})
+ list(APPEND _flags_CXX ${_flags})
+
+else ()
+ # If we're compiling with GCC / Clang / MinGW (or anything else besides Visual Studio or Intel):
+ # C Flags:
+ list(APPEND _flags_C
+ -Wall
+ -Wextra
+
+ # Enable additional warnings not covered by Wall and Wextra.
+ -Wcast-align
+ -Wconversion
+ -Wdeclaration-after-statement
+ -Wdouble-promotion
+ -Wfloat-equal
+ -Wformat-security
+ -Winit-self
+ -Wjump-misses-init
+ -Wlogical-op
+ -Wmissing-braces
+ -Wmissing-declarations
+ -Wmissing-format-attribute
+ -Wmissing-include-dirs
+ -Wmissing-prototypes
+ -Wnested-externs
+ -Wno-coverage-mismatch
+ -Wold-style-definition
+ -Wpacked
+ -Wpointer-arith
+ -Wredundant-decls
+ -Wshadow
+ -Wsign-conversion
+ -Wstrict-overflow
+ -Wstrict-prototypes
+ -Wtrampolines
+ -Wundef
+ -Wunused
+ -Wvariadic-macros
+ -Wvla
+ -Wwrite-strings
+
+ # On Windows MinGW I think implicit fallthrough enabled by -Wextra must not default to 3
+ -Wimplicit-fallthrough=3
+
+ # Treat implicit variable typing and implicit function declarations as errors.
+ -Werror=implicit-int
+ -Werror=implicit-function-declaration
+
+ # Make MacOSX honor -mmacosx-version-min
+ -Werror=partial-availability
+
+ # Some clang versions might warn if an argument like "-I/path/to/headers" is unused,
+ # silence these.
+ -Qunused-arguments
+ )
+
+ # C++ flags:
+ list(APPEND _flags_CXX
+ -Wall
+ -Wextra
+
+ # Enable additional warnings not covered by Wall and Wextra.
+ -Wcast-align
+ -Wformat-security
+ -Wmissing-declarations
+ -Wmissing-format-attribute
+ -Wpacked-bitfield-compat
+ -Wredundant-decls
+ -Wvla
+
+ # Turn off unused parameter warnings with C++ (they happen often in C++ and Qt).
+ -Wno-unused-parameter
+
+ # Some clang versions might warn if an argument like "-I/path/to/headers" is unused,
+ # silence these.
+ -Qunused-arguments
+ )
+
+ # Note: when cross-compiling to Windows from Cygwin, the Qt Mingw packages have a bunch of
+ # noisy type-conversion warnings in headers. So, only enable those warnings if we're
+ # not building that configuration.
+ if (NOT (WIN32 AND (CMAKE_HOST_SYSTEM_NAME MATCHES "CYGWIN")))
+ list(APPEND _flags_CXX
+ -Wconversion
+ -Wfloat-equal
+ -Wsign-conversion
+ )
+ endif ()
+
+ # Add flags to force colored output even when output is redirected via pipe.
+ if (CMAKE_GENERATOR MATCHES "Ninja")
+ set(color_default TRUE)
+ else ()
+ set(color_default FALSE)
+ endif ()
+ option(FORCE_COLOR "Force compiler to always colorize, even when output is redirected." ${color_default})
+ mark_as_advanced(FORCE FORCE_COLOR)
+ if (FORCE_COLOR)
+ set(_flags
+ -fdiagnostics-color=always # GCC
+ -fcolor-diagnostics # Clang
+ )
+ list(APPEND _flags_C ${_flags})
+ list(APPEND _flags_CXX ${_flags})
+ endif ()
+
+ # Add -fno-omit-frame-pointer (and optionally -fno-inline) to make debugging and stack dumps nicer.
+ set(_flags
+ -fno-omit-frame-pointer
+ )
+ option(M_NO_INLINE "Disable function inlining for RelWithDebInfo and Debug configurations?" FALSE)
+ if (M_NO_INLINE)
+ list(APPEND _flags
+ -fno-inline
+ )
+ endif ()
+ list(APPEND _debug_flags_C ${_flags})
+ list(APPEND _debug_flags_CXX ${_flags})
+endif ()
+
+# Check and set compiler flags.
+set(_debug_configs
+ RelWithDebInfo
+ Debug
+)
+foreach(_lang ${languages})
+ _int_enable_warnings_set_flags(_lang ${_flags_${_lang}})
+ _int_enable_warnings_set_flags_ex(_lang _debug_configs ${_debug_flags_${_lang}})
+
+ # Ensure pure Debug builds are NOT optimized (not possible on Visual Studio).
+ # Any optimization of a Debug build will prevent debuggers like lldb from
+ # fully displaying backtraces and stepping.
+ if (NOT MSVC)
+ set(_config Debug)
+ _int_enable_warnings_set_flags_ex(_lang _config -O0)
+ endif ()
+endforeach()
+
+
+
+# - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
+# Helper functions
+
+
+# This function can be called in subdirectories, to prune out warnings that they don't want.
+# vararg: warning flags to remove from list of enabled warnings. All "no" flags after EXPLICIT_DISABLE
+# will be added to C flags.
+#
+# Ex.: remove_warnings(-Wall -Wdouble-promotion -Wcomment) prunes those warnings flags from the compile command.
+function(remove_warnings)
+ get_property(languages GLOBAL PROPERTY ENABLED_LANGUAGES)
+ set(langs C)
+ if ("CXX" IN_LIST languages)
+ list(APPEND langs CXX)
+ endif ()
+
+ foreach(lang ${langs})
+ set(toadd)
+ set(in_explicit_disable FALSE)
+ foreach (flag ${ARGN})
+ if (flag STREQUAL "EXPLICIT_DISABLE")
+ set(in_explicit_disable TRUE)
+ elseif (in_explicit_disable)
+ list(APPEND toadd "${flag}")
+ else ()
+ string(REGEX REPLACE "${flag}([ \t]+|$)" "" CMAKE_${lang}_FLAGS "${CMAKE_${lang}_FLAGS}")
+ endif ()
+ endforeach ()
+ _int_enable_warnings_set_flags(lang ${toadd})
+ string(STRIP "${CMAKE_${lang}_FLAGS}" CMAKE_${lang}_FLAGS)
+ set(CMAKE_${lang}_FLAGS "${CMAKE_${lang}_FLAGS}" PARENT_SCOPE)
+ endforeach()
+endfunction()
+
+
+# Explicitly suppress all warnings. As long as this flag is the last warning flag, warnings will be
+# suppressed even if earlier flags enabled warnings.
+function(remove_all_warnings)
+ get_property(languages GLOBAL PROPERTY ENABLED_LANGUAGES)
+ set(langs C)
+ if ("CXX" IN_LIST languages)
+ list(APPEND langs CXX)
+ endif ()
+
+ foreach(lang ${langs})
+ string(REGEX REPLACE "[-/][Ww][^ \t]*([ \t]+|$)" "" CMAKE_${lang}_FLAGS "${CMAKE_${lang}_FLAGS}")
+ if (MSVC)
+ string(APPEND CMAKE_${lang}_FLAGS " /w")
+ else ()
+ string(APPEND CMAKE_${lang}_FLAGS " -w")
+ endif ()
+ string(STRIP "${CMAKE_${lang}_FLAGS}" CMAKE_${lang}_FLAGS)
+ set(CMAKE_${lang}_FLAGS "${CMAKE_${lang}_FLAGS}" PARENT_SCOPE)
+ endforeach()
+endfunction()
+
+
+function(remove_all_warnings_from_targets)
+ foreach (target ${ARGN})
+ if (MSVC)
+ target_compile_options(${target} PRIVATE "/w")
+ else ()
+ target_compile_options(${target} PRIVATE "-w")
+ endif ()
+ endforeach()
+endfunction()
+
+
+# Save the current warning settings to an internal variable.
+function(push_warnings)
+ get_property(languages GLOBAL PROPERTY ENABLED_LANGUAGES)
+ set(langs C)
+ if ("CXX" IN_LIST languages)
+ list(APPEND langs CXX)
+ endif ()
+
+ foreach(lang ${langs})
+ if (CMAKE_${lang}_FLAGS MATCHES ";")
+ message(AUTHOR_WARNING "Cannot push warnings for ${lang}, CMAKE_${lang}_FLAGS contains semicolons")
+ continue()
+ endif ()
+ # Add current flags to end of internal list.
+ list(APPEND _enable_warnings_internal_${lang}_flags_stack "${CMAKE_${lang}_FLAGS}")
+ # Propagate results up to caller's scope.
+ set(_enable_warnings_internal_${lang}_flags_stack "${_enable_warnings_internal_${lang}_flags_stack}" PARENT_SCOPE)
+ endforeach()
+endfunction()
+
+
+# Restore the current warning settings from an internal variable.
+function(pop_warnings)
+ get_property(languages GLOBAL PROPERTY ENABLED_LANGUAGES)
+ set(langs C)
+ if ("CXX" IN_LIST languages)
+ list(APPEND langs CXX)
+ endif ()
+
+ foreach(lang ${langs})
+ if (NOT _enable_warnings_internal_${lang}_flags_stack)
+ continue()
+ endif ()
+ # Pop flags off of end of list, overwrite current flags with whatever we popped off.
+ list(GET _enable_warnings_internal_${lang}_flags_stack -1 CMAKE_${lang}_FLAGS)
+ list(REMOVE_AT _enable_warnings_internal_${lang}_flags_stack -1)
+ # Propagate results up to caller's scope.
+ set(_enable_warnings_internal_${lang}_flags_stack "${_enable_warnings_internal_${lang}_flags_stack}" PARENT_SCOPE)
+ string(STRIP "${CMAKE_${lang}_FLAGS}" CMAKE_${lang}_FLAGS)
+ set(CMAKE_${lang}_FLAGS "${CMAKE_${lang}_FLAGS}" PARENT_SCOPE)
+ endforeach()
+endfunction()
diff --git a/subprojects/c-ares/configure.ac b/subprojects/c-ares/configure.ac
@@ -0,0 +1,867 @@
+dnl Copyright (C) The c-ares project and its contributors
+dnl SPDX-License-Identifier: MIT
+AC_PREREQ([2.69])
+
+AC_INIT([c-ares], [1.25.0],
+ [c-ares mailing list: http://lists.haxx.se/listinfo/c-ares])
+
+CARES_VERSION_INFO="12:1:10"
+dnl This flag accepts an argument of the form current[:revision[:age]]. So,
+dnl passing -version-info 3:12:1 sets current to 3, revision to 12, and age to
+dnl 1.
+dnl
+dnl If either revision or age are omitted, they default to 0. Also note that age
+dnl must be less than or equal to the current interface number.
+dnl
+dnl Here are a set of rules to help you update your library version information:
+dnl
+dnl 1.Start with version information of 0:0:0 for each libtool library.
+dnl
+dnl 2.Update the version information only immediately before a public release of
+dnl your software. More frequent updates are unnecessary, and only guarantee
+dnl that the current interface number gets larger faster.
+dnl
+dnl 3.If the library source code has changed at all since the last update, then
+dnl increment revision (c:r+1:a)
+dnl
+dnl 4.If any interfaces have been added, removed, or changed since the last
+dnl update, increment current, and set revision to 0. (c+1:r=0:a)
+dnl
+dnl 5.If any interfaces have been added since the last public release, then
+dnl increment age. (c:r:a+1)
+dnl
+dnl 6.If any interfaces have been removed since the last public release, then
+dnl set age to 0. (c:r:a=0)
+dnl
+AC_SUBST([CARES_VERSION_INFO])
+
+AC_CONFIG_SRCDIR([src/lib/ares_ipv6.h])
+AC_CONFIG_HEADERS([src/lib/ares_config.h include/ares_build.h])
+AC_CONFIG_AUX_DIR(config)
+AC_CONFIG_MACRO_DIR([m4])
+AC_USE_SYSTEM_EXTENSIONS
+AX_CXX_COMPILE_STDCXX_14([noext],[optional])
+AM_INIT_AUTOMAKE([foreign subdir-objects 1.9.6])
+AC_ENABLE_SHARED
+LT_INIT([win32-dll,shared,pic,disable-fast-install,aix-soname=svr4])
+AC_LANG([C])
+AC_PROG_CC
+AM_PROG_CC_C_O
+AC_PROG_EGREP
+AC_PROG_INSTALL
+AC_CANONICAL_HOST
+AX_COMPILER_VENDOR
+
+AC_ARG_ENABLE(warnings,
+ AS_HELP_STRING([--disable-warnings],[Disable strict compiler warnings]),
+ [ enable_warnings=${enableval} ],
+ [ enable_warnings=yes ])
+
+AC_ARG_ENABLE(symbol-hiding,
+ AS_HELP_STRING([--disable-symbol-hiding], [Disable symbol hiding. Enabled by default if the compiler supports it.]),
+ [
+ symbol_hiding="$enableval"
+ if test "$symbol_hiding" = "no" -a "x$enable_shared" = "xyes" ; then
+ case $host_os in
+ cygwin* | mingw* | pw32* | cegcc*)
+ AC_MSG_ERROR([Cannot disable symbol hiding on windows])
+ ;;
+ esac
+ fi
+ ],
+ [
+ if test "x$enable_shared" = "xyes" ; then
+ symbol_hiding="maybe"
+ else
+ symbol_hiding="no"
+ fi
+ ]
+)
+
+AC_ARG_ENABLE(tests,
+ AS_HELP_STRING([--disable-tests], [disable building of test suite. Built by default if GoogleTest is found.]),
+ [ build_tests="$enableval" ],
+ [ if test "x$HAVE_CXX14" = "x1" && test "x$cross_compiling" = "xno" ; then
+ build_tests="maybe"
+ else
+ build_tests="no"
+ fi
+ ]
+)
+
+AC_ARG_ENABLE(cares-threads,
+ AS_HELP_STRING([--disable-cares-threads], [Disable building of thread safety support]),
+ [ CARES_THREADS=${enableval} ],
+ [ CARES_THREADS=yes ])
+
+AC_ARG_WITH(random,
+ AS_HELP_STRING([--with-random=FILE],
+ [read randomness from FILE (default=/dev/urandom)]),
+ [ CARES_RANDOM_FILE="$withval" ],
+ [ CARES_RANDOM_FILE="/dev/urandom" ]
+)
+if test -n "$CARES_RANDOM_FILE" && test X"$CARES_RANDOM_FILE" != Xno ; then
+ AC_SUBST(CARES_RANDOM_FILE)
+ AC_DEFINE_UNQUOTED(CARES_RANDOM_FILE, "$CARES_RANDOM_FILE", [a suitable file/device to read random data from])
+fi
+
+AM_MAINTAINER_MODE
+m4_ifdef([AM_SILENT_RULES], [AM_SILENT_RULES([yes])])
+
+
+dnl CARES_DEFINE_UNQUOTED (VARIABLE, [VALUE])
+dnl -------------------------------------------------
+dnl Like AC_DEFINE_UNQUOTED this macro will define a C preprocessor
+dnl symbol that can be further used in custom template configuration
+dnl files. This macro, unlike AC_DEFINE_UNQUOTED, does not use a third
+dnl argument for the description. Symbol definitions done with this
+dnl macro are intended to be exclusively used in handcrafted *.h.in
+dnl template files. Contrary to what AC_DEFINE_UNQUOTED does, this one
+dnl prevents autoheader generation and insertion of symbol template
+dnl stub and definition into the first configuration header file. Do
+dnl not use this macro as a replacement for AC_DEFINE_UNQUOTED, each
+dnl one serves different functional needs.
+
+AC_DEFUN([CARES_DEFINE_UNQUOTED], [
+cat >>confdefs.h <<_EOF
+[@%:@define] $1 ifelse($#, 2, [$2], 1)
+_EOF
+])
+
+AX_CODE_COVERAGE
+AX_CHECK_USER_NAMESPACE
+AX_CHECK_UTS_NAMESPACE
+AC_SYS_LARGEFILE
+
+case $host_os in
+ solaris*)
+ AC_DEFINE(ETC_INET, 1, [if a /etc/inet dir is being used])
+ ;;
+esac
+
+dnl solaris needed flag
+case $host_os in
+ solaris2*)
+ if test "x$GCC" = 'xyes'; then
+ AX_APPEND_LINK_FLAGS([-mimpure-text])
+ fi
+ ;;
+ *)
+ ;;
+esac
+
+dnl -no-undefined libtool (not linker) flag for windows
+cares_use_no_undefined=no
+case $host_os in
+ cygwin* | mingw* | pw32* | cegcc* | os2* | aix*)
+ cares_use_no_undefined=yes
+ ;;
+ *)
+ ;;
+esac
+AM_CONDITIONAL([CARES_USE_NO_UNDEFINED], [test "$cares_use_no_undefined" = 'yes'])
+
+
+AC_MSG_CHECKING([whether this is native windows])
+ac_cv_native_windows=no
+ac_cv_windows=no
+case $host_os in
+ mingw*)
+ ac_cv_native_windows=yes
+ ac_cv_windows=yes
+ ;;
+ cygwin*)
+ ac_cv_windows=yes
+ ;;
+esac
+if test "$ax_cv_c_compiler_vendor" = "microsoft" ; then
+ ac_cv_native_windows=yes
+ ac_cv_windows=yes
+fi
+if test "$ac_cv_native_windows" = "yes" ; then
+ CPPFLAGS="$CPPFLAGS -D_WIN32_WINNT=0x0602 -DWIN32_LEAN_AND_MEAN"
+fi
+AC_MSG_RESULT($ac_cv_native_windows)
+
+dnl Disable static builds by default on Windows unless overwritten since Windows
+dnl can't simultaneously build shared and static with autotools.
+if test "x$ac_cv_windows" = "xyes" ; then
+ AC_DISABLE_STATIC
+fi
+
+
+dnl Only windows requires CARES_STATICLIB definition
+if test "x$enable_shared" = "xno" -a "x$enable_static" = "xyes" ; then
+ AC_MSG_CHECKING([whether we need CARES_STATICLIB definition])
+ if test "$ac_cv_native_windows" = "yes" ; then
+ AX_APPEND_FLAG([-DCARES_STATICLIB], [CPPFLAGS])
+ AC_MSG_RESULT([yes])
+ else
+ AC_MSG_RESULT([no])
+ fi
+fi
+
+dnl Test for symbol hiding
+CARES_SYMBOL_HIDING_CFLAG=""
+if test "$symbol_hiding" != "no" ; then
+ compiler_supports_symbol_hiding="no"
+ if test "$ac_cv_windows" = "yes" ; then
+ compiler_supports_symbol_hiding="yes"
+ else
+ case "$ax_cv_c_compiler_vendor" in
+ clang|gnu|intel)
+ AX_APPEND_COMPILE_FLAGS([-fvisibility=hidden], [CARES_SYMBOL_HIDING_CFLAG])
+ if test "x$CARES_SYMBOL_HIDING_CFLAG" != "x" ; then
+ compiler_supports_symbol_hiding="yes"
+ fi
+ ;;
+ sun)
+ AX_APPEND_COMPILE_FLAGS([-xldscope=hidden], [CARES_SYMBOL_HIDING_CFLAG])
+ if test "x$CARES_SYMBOL_HIDING_CFLAG" != "x" ; then
+ compiler_supports_symbol_hiding="yes"
+ fi
+ ;;
+ esac
+ fi
+ if test "$compiler_supports_symbol_hiding" = "no" ; then
+ if test "$symbol_hiding" = "yes" ; then
+ AC_MSG_ERROR([Compiler does not support symbol hiding])
+ else
+ symbol_hiding="no"
+ fi
+ else
+ AC_DEFINE([CARES_SYMBOL_HIDING], [ 1 ], [Set to 1 if non-pubilc shared library symbols are hidden])
+ symbol_hiding="yes"
+ fi
+fi
+AM_CONDITIONAL(CARES_SYMBOL_HIDING, test "x$symbol_hiding" = "xyes")
+AC_SUBST(CARES_SYMBOL_HIDING_CFLAG)
+
+
+if test "$enable_warnings" = "yes"; then
+ AX_APPEND_COMPILE_FLAGS([-Wall \
+ -Wextra \
+ -Wcast-align \
+ -Wconversion \
+ -Wdeclaration-after-statement \
+ -Wdouble-promotion \
+ -Wfloat-equal \
+ -Wformat-security \
+ -Winit-self \
+ -Wjump-misses-init \
+ -Wlogical-op \
+ -Wmissing-braces \
+ -Wmissing-declarations \
+ -Wmissing-format-attribute \
+ -Wmissing-include-dirs \
+ -Wmissing-prototypes \
+ -Wnested-externs \
+ -Wno-coverage-mismatch \
+ -Wold-style-definition \
+ -Wpacked \
+ -Wpointer-arith \
+ -Wredundant-decls \
+ -Wshadow \
+ -Wsign-conversion \
+ -Wstrict-overflow \
+ -Wstrict-prototypes \
+ -Wtrampolines \
+ -Wundef \
+ -Wunused \
+ -Wvariadic-macros \
+ -Wvla \
+ -Wwrite-strings \
+ -Werror=implicit-int \
+ -Werror=implicit-function-declaration \
+ -Werror=partial-availability \
+ ], [CFLAGS], [-Werror])
+fi
+
+if test "$ax_cv_c_compiler_vendor" = "intel"; then
+ CFLAGS="$CFLAGS -shared-intel"
+fi
+
+if test "$ac_cv_native_windows" = "yes" ; then
+ dnl we use [ - ] in the 4th argument to tell AC_CHECK_HEADERS to simply
+ dnl check for existence of the headers, not usability. This is because
+ dnl on windows, header order matters, and you need to include headers *after*
+ dnl other headers, AC_CHECK_HEADERS only allows you to specify headers that
+ dnl must be included *before* the header being checked.
+
+ AC_CHECK_HEADERS(
+ windows.h \
+ winsock2.h \
+ ws2tcpip.h \
+ iphlpapi.h \
+ netioapi.h \
+ ws2ipdef.h,
+ [], [], [-])
+
+ dnl Windows builds require linking to iphlpapi
+ if test "$ac_cv_header_winsock2_h" = "yes"; then
+ LIBS="$LIBS -lws2_32 -liphlpapi"
+ fi
+fi
+
+dnl **********************************************************************
+dnl Checks for libraries.
+dnl **********************************************************************
+
+dnl see if libnsl or libsocket are required
+AC_SEARCH_LIBS([getservbyport], [nsl socket resolv])
+
+AC_MSG_CHECKING([if libxnet is required])
+need_xnet=no
+case $host_os in
+ hpux*)
+ XNET_LIBS=""
+ AX_APPEND_LINK_FLAGS([-lxnet], [XNET_LIBS])
+ if test "x$XNET_LIBS" != "x" ; then
+ LIBS="$LIBS $XNET_LIBS"
+ need_xnet=yes
+ fi
+ ;;
+esac
+AC_MSG_RESULT($need_xnet)
+
+dnl resolv lib for Apple (MacOS and iOS)
+AS_IF([test "x$host_vendor" = "xapple"], [
+ AC_SEARCH_LIBS([res_servicename], [resolv], [
+ AC_DEFINE([CARES_USE_LIBRESOLV], [1], [Use resolver library to configure cares])
+ ], [
+ AC_MSG_ERROR([Unable to find libresolv which is required for iPhone targets])
+ ])
+])
+
+dnl resolv lib for z/OS
+AS_IF([test "x$host_vendor" = "xibm" -a "x$host_os" = "xopenedition" ], [
+ AC_SEARCH_LIBS([res_init], [resolv], [
+ AC_DEFINE([CARES_USE_LIBRESOLV], [1], [Use resolver library to configure cares])
+ ], [
+ AC_MSG_ERROR([Unable to find libresolv which is required for z/OS])
+ ])
+])
+
+
+dnl iOS 10?
+AS_IF([test "x$host_vendor" = "xapple"], [
+ AC_MSG_CHECKING([for iOS minimum version 10 or later])
+ AC_COMPILE_IFELSE([
+ AC_LANG_PROGRAM([[
+#include <stdio.h>
+#include <AvailabilityMacros.h>
+#include <TargetConditionals.h>
+ ]], [[
+#if TARGET_OS_IPHONE == 0 || __IPHONE_OS_VERSION_MIN_REQUIRED < 100000
+#error Not iOS 10 or later
+#endif
+return 0;
+ ]])
+ ],[
+ AC_MSG_RESULT([yes])
+ ac_cv_ios_10="yes"
+ ],[
+ AC_MSG_RESULT([no])
+ ])
+])
+
+dnl macOS 10.12?
+AS_IF([test "x$host_vendor" = "xapple"], [
+ AC_MSG_CHECKING([for macOS minimum version 10.12 or later])
+ AC_COMPILE_IFELSE([
+ AC_LANG_PROGRAM([[
+#include <stdio.h>
+#include <AvailabilityMacros.h>
+#include <TargetConditionals.h>
+ ]], [[
+#ifndef MAC_OS_X_VERSION_10_12
+# define MAC_OS_X_VERSION_10_12 101200
+#endif
+#if MAC_OS_X_VERSION_MIN_REQUIRED < MAC_OS_X_VERSION_10_12
+#error Not macOS 10.12 or later
+#endif
+return 0;
+ ]])
+ ],[
+ AC_MSG_RESULT([yes])
+ ac_cv_macos_10_12="yes"
+ ],[
+ AC_MSG_RESULT([no])
+ ])
+])
+
+AC_MSG_CHECKING([whether to use libgcc])
+AC_ARG_ENABLE(libgcc,
+AS_HELP_STRING([--enable-libgcc],[use libgcc when linking]),
+[ case "$enableval" in
+ yes)
+ LIBS="$LIBS -lgcc"
+ AC_MSG_RESULT(yes)
+ ;;
+ *)
+ AC_MSG_RESULT(no)
+ ;;
+ esac ],
+ AC_MSG_RESULT(no)
+)
+
+dnl check for a few basic system headers we need
+AC_CHECK_HEADERS(
+ malloc.h \
+ memory.h \
+ sys/types.h \
+ sys/time.h \
+ sys/select.h \
+ sys/socket.h \
+ sys/filio.h \
+ sys/ioctl.h \
+ sys/param.h \
+ sys/uio.h \
+ sys/random.h \
+ assert.h \
+ iphlpapi.h \
+ netioapi.h \
+ netdb.h \
+ netinet/in.h \
+ netinet/tcp.h \
+ net/if.h \
+ ifaddrs.h \
+ fcntl.h \
+ errno.h \
+ socket.h \
+ strings.h \
+ stdbool.h \
+ time.h \
+ limits.h \
+ arpa/nameser.h \
+ arpa/nameser_compat.h \
+ arpa/inet.h,
+dnl to do if not found
+[],
+dnl to do if found
+[],
+dnl default includes
+[
+#ifdef HAVE_SYS_TYPES_H
+#include <sys/types.h>
+#endif
+#ifdef HAVE_SYS_TIME_H
+#include <sys/time.h>
+#endif
+dnl We do this default-include simply to make sure that the nameser_compat.h
+dnl header *REALLY* can be include after the new nameser.h. It seems AIX 5.1
+dnl (and others?) is not designed to allow this.
+#ifdef HAVE_ARPA_NAMESER_H
+#include <arpa/nameser.h>
+#endif
+
+dnl *Sigh* these are needed in order for net/if.h to get properly detected.
+#ifdef HAVE_SYS_SOCKET_H
+#include <sys/socket.h>
+#endif
+#ifdef HAVE_NETINET_IN_H
+#include <netinet/in.h>
+#endif
+]
+)
+
+
+cares_all_includes="
+#include <stdio.h>
+#include <stdlib.h>
+#ifdef HAVE_SYS_UIO_H
+# include <sys/uio.h>
+#endif
+#ifdef HAVE_NETINET_IN_H
+# include <netinet/in.h>
+#endif
+#ifdef HAVE_TCP_H
+# include <tcp.h>
+#endif
+#ifdef HAVE_SYS_FILIO_H
+# include <sys/filio.h>
+#endif
+#ifdef HAVE_SYS_IOCTL_H
+# include <sys/ioctl.h>
+#endif
+#ifdef HAVE_UNISTD_H
+# include <unistd.h>
+#endif
+#ifdef HAVE_STRINGS_H
+# include <strings.h>
+#endif
+#ifdef HAVE_SYS_TYPES_H
+# include <sys/types.h>
+#endif
+#ifdef HAVE_SYS_SOCKET_H
+# include <sys/socket.h>
+#endif
+#ifdef HAVE_SYS_PARAM_H
+# include <sys/param.h>
+#endif
+#ifdef HAVE_FCNTL_H
+# include <fcntl.h>
+#endif
+#ifdef HAVE_NET_IF_H
+# include <net/if.h>
+#endif
+#ifdef HAVE_IFADDRS_H
+# include <ifaddrs.h>
+#endif
+#ifdef HAVE_NETINET_IN_H
+# include <netinet/in.h>
+#endif
+#ifdef HAVE_NETINET_TCP_H
+# include <netinet/tcp.h>
+#endif
+#ifdef HAVE_NETDB_H
+# include <netdb.h>
+#endif
+#ifdef HAVE_ARPA_INET_H
+# include <arpa/inet.h>
+#endif
+#ifdef HAVE_RESOLV_H
+# include <resolv.h>
+#endif
+#ifdef HAVE_IPHLPAPI_H
+# include <iphlpapi.h>
+#endif
+#ifdef HAVE_NETIOAPI_H
+# include <netioapi.h>
+#endif
+#ifdef HAVE_WINSOCK2_H
+# include <winsock2.h>
+#endif
+#ifdef HAVE_WS2IPDEF_H
+# include <ws2ipdef.h>
+#endif
+#ifdef HAVE_WS2TCPIP_H
+# include <ws2tcpip.h>
+#endif
+#ifdef HAVE_WINDOWS_H
+# include <windows.h>
+#endif
+"
+
+AC_CHECK_DECL([HAVE_ARPA_NAMESER_H],[CARES_DEFINE_UNQUOTED([CARES_HAVE_ARPA_NAMESER_H])], [])
+AC_CHECK_DECL([HAVE_ARPA_NAMESER_COMPAT_H],[CARES_DEFINE_UNQUOTED([CARES_HAVE_ARPA_NAMESER_COMPAT_H])],[])
+AC_CHECK_TYPE(long long, [AC_DEFINE(HAVE_LONGLONG, 1, [Define to 1 if the compiler supports the 'long long' data type.])])
+AC_CHECK_TYPE(ssize_t, [ CARES_TYPEOF_ARES_SSIZE_T=ssize_t ], [ CARES_TYPEOF_ARES_SSIZE_T=int ])
+AC_DEFINE_UNQUOTED([CARES_TYPEOF_ARES_SSIZE_T], ${CARES_TYPEOF_ARES_SSIZE_T}, [the signed version of size_t])
+
+AC_CHECK_TYPE(socklen_t,
+ [
+ AC_DEFINE(HAVE_SOCKLEN_T, [], [socklen_t])
+ CARES_DEFINE_UNQUOTED([CARES_TYPEOF_ARES_SOCKLEN_T], [socklen_t])
+ ],
+ [ CARES_DEFINE_UNQUOTED([CARES_TYPEOF_ARES_SOCKLEN_T], [int]) ],
+ $cares_all_includes
+ )
+
+AC_CHECK_TYPE(SOCKET, [], [], $cares_all_includes)
+
+
+
+dnl ###############################################################################
+dnl recv, recvfrom, send, getnameinfo, gethostname
+dnl ARGUMENTS AND RETURN VALUES
+
+AC_CHECK_FUNCS([recv recvfrom send getnameinfo gethostname])
+
+if test "x$ac_cv_type_ssize_t" = "xyes" -a "x$ac_cv_type_socklen_t" = "xyes" -a "x$ac_cv_native_windows" != "xyes" ; then
+ recvfrom_type_retv="ssize_t"
+ recvfrom_type_arg3="size_t"
+else
+ recvfrom_type_retv="int"
+ recvfrom_type_arg3="int"
+fi
+
+if test "x$ac_cv_type_SOCKET" = "xyes" ; then
+ dnl If the SOCKET type is defined, it uses socket ... should be windows only
+ recvfrom_type_arg1="SOCKET"
+else
+ recvfrom_type_arg1="int"
+fi
+
+if test "x$ac_cv_type_socklen_t" = "xyes" ; then
+ recvfrom_type_arg6="socklen_t *"
+ getnameinfo_type_arg2="socklen_t"
+ getnameinfo_type_arg46="socklen_t"
+else
+ recvfrom_type_arg6="int *"
+ getnameinfo_type_arg2="int"
+ getnameinfo_type_arg46="int"
+fi
+
+if test "x$ac_cv_native_windows" = "xyes" ; then
+ recv_type_arg2="char *"
+else
+ recv_type_arg2="void *"
+fi
+
+dnl Functions are typically consistent so the equivalent fields map ... equivalently
+recv_type_retv=${recvfrom_type_retv}
+send_type_retv=${recvfrom_type_retv}
+recv_type_arg1=${recvfrom_type_arg1}
+recvfrom_type_arg2=${recv_type_arg2}
+send_type_arg1=${recvfrom_type_arg1}
+recv_type_arg3=${recvfrom_type_arg3}
+send_type_arg3=${recvfrom_type_arg3}
+gethostname_type_arg2=${recvfrom_type_arg3}
+
+dnl These should always be "sane" values to use always
+recvfrom_qual_arg5=
+recvfrom_type_arg4=int
+recvfrom_type_arg5="struct sockaddr *"
+recv_type_arg4=int
+getnameinfo_type_arg1="struct sockaddr *"
+getnameinfo_type_arg7=int
+send_type_arg2="void *"
+send_type_arg4=int
+
+AC_DEFINE_UNQUOTED([RECVFROM_TYPE_RETV], [ ${recvfrom_type_retv} ], [ recvfrom() return value ])
+AC_DEFINE_UNQUOTED([RECVFROM_TYPE_ARG1], [ ${recvfrom_type_arg1} ], [ recvfrom() arg1 type ])
+AC_DEFINE_UNQUOTED([RECVFROM_TYPE_ARG2], [ ${recvfrom_type_arg2} ], [ recvfrom() arg2 type ])
+AC_DEFINE_UNQUOTED([RECVFROM_TYPE_ARG3], [ ${recvfrom_type_arg3} ], [ recvfrom() arg3 type ])
+AC_DEFINE_UNQUOTED([RECVFROM_TYPE_ARG4], [ ${recvfrom_type_arg4} ], [ recvfrom() arg4 type ])
+AC_DEFINE_UNQUOTED([RECVFROM_TYPE_ARG5], [ ${recvfrom_type_arg5} ], [ recvfrom() arg5 type ])
+AC_DEFINE_UNQUOTED([RECVFROM_QUAL_ARG5], [ ${recvfrom_qual_arg5}], [ recvfrom() arg5 qualifier])
+
+AC_DEFINE_UNQUOTED([RECV_TYPE_RETV], [ ${recv_type_retv} ], [ recv() return value ])
+AC_DEFINE_UNQUOTED([RECV_TYPE_ARG1], [ ${recv_type_arg1} ], [ recv() arg1 type ])
+AC_DEFINE_UNQUOTED([RECV_TYPE_ARG2], [ ${recv_type_arg2} ], [ recv() arg2 type ])
+AC_DEFINE_UNQUOTED([RECV_TYPE_ARG3], [ ${recv_type_arg3} ], [ recv() arg3 type ])
+AC_DEFINE_UNQUOTED([RECV_TYPE_ARG4], [ ${recv_type_arg4} ], [ recv() arg4 type ])
+
+AC_DEFINE_UNQUOTED([SEND_TYPE_RETV], [ ${send_type_retv} ], [ send() return value ])
+AC_DEFINE_UNQUOTED([SEND_TYPE_ARG1], [ ${send_type_arg1} ], [ send() arg1 type ])
+AC_DEFINE_UNQUOTED([SEND_TYPE_ARG2], [ ${send_type_arg2} ], [ send() arg2 type ])
+AC_DEFINE_UNQUOTED([SEND_QUAL_ARG2], [ ], [ send() arg2 qualifier ])
+AC_DEFINE_UNQUOTED([SEND_TYPE_ARG3], [ ${send_type_arg3} ], [ send() arg3 type ])
+AC_DEFINE_UNQUOTED([SEND_TYPE_ARG4], [ ${send_type_arg4} ], [ send() arg4 type ])
+
+AC_DEFINE_UNQUOTED([GETNAMEINFO_TYPE_ARG1], [ ${getnameinfo_type_arg1} ], [ getnameinfo() arg1 type ])
+AC_DEFINE_UNQUOTED([GETNAMEINFO_TYPE_ARG2], [ ${getnameinfo_type_arg2} ], [ getnameinfo() arg2 type ])
+AC_DEFINE_UNQUOTED([GETNAMEINFO_TYPE_ARG7], [ ${getnameinfo_type_arg7} ], [ getnameinfo() arg7 type ])
+AC_DEFINE_UNQUOTED([GETNAMEINFO_TYPE_ARG46], [ ${getnameinfo_type_arg46} ], [ getnameinfo() arg4 and 6 type ])
+
+AC_DEFINE_UNQUOTED([GETHOSTNAME_TYPE_ARG2], [ ${gethostname_type_arg2} ], [ gethostname() arg2 type ])
+
+
+
+dnl ###############################################################################
+
+dnl clock_gettime might require an external library
+AC_SEARCH_LIBS([clock_gettime], [rt posix4])
+
+AC_CHECK_FUNCS(connect \
+ closesocket \
+ CloseSocket \
+ fcntl \
+ getenv \
+ gethostname \
+ getrandom \
+ getservbyport_r \
+ inet_net_pton \
+ inet_ntop \
+ inet_pton \
+ ioctl \
+ IoctlSocket \
+ ioctlsocket \
+ setsockopt \
+ socket \
+ strcasecmp \
+ strdup \
+ stricmp \
+ strncasecmp \
+ strncmpi \
+ strnicmp \
+ writev \
+ arc4random_buf \
+ stat \
+ gettimeofday \
+ clock_gettime \
+ if_indextoname \
+ if_nametoindex \
+ ConvertInterfaceIndexToLuid \
+ ConvertInterfaceLuidToNameA \
+ getifaddrs \
+ __system_property_get)
+
+
+if test "$ac_cv_func_getservbyport_r" = "yes" ; then
+ AC_MSG_CHECKING([number of arguments for getservbyport_r()])
+ getservbyport_r_args=6
+ case $host_os in
+ solaris*)
+ getservbyport_r_args=5
+ ;;
+ aix*|openbsd*)
+ getservbyport_r_args=4
+ ;;
+ esac
+ AC_MSG_RESULT([$getservbyport_r_args])
+ AC_DEFINE_UNQUOTED([GETSERVBYPORT_R_ARGS], [ $getservbyport_r_args ], [ number of arguments for getservbyport_r() ])
+fi
+
+if test "$ac_cv_func_getservbyname_r" = "yes" ; then
+ AC_MSG_CHECKING([number of arguments for getservbyname_r()])
+ getservbyname_r_args=6
+ case $host_os in
+ solaris*)
+ getservbyname_r_args=5
+ ;;
+ aix*|openbsd*)
+ getservbyname_r_args=4
+ ;;
+ esac
+ AC_DEFINE_UNQUOTED([GETSERVBYNAME_R_ARGS], [ $getservbyname_r_args ], [ number of arguments for getservbyname_r() ])
+ AC_MSG_RESULT([$getservbyname_r_args])
+fi
+
+AC_TYPE_SIZE_T
+AC_CHECK_DECL(AF_INET6, [AC_DEFINE([HAVE_AF_INET6],1,[Define to 1 if you have AF_INET6])], [], $cares_all_includes)
+AC_CHECK_DECL(PF_INET6, [AC_DEFINE([HAVE_PF_INET6],1,[Define to 1 if you have PF_INET6])], [], $cares_all_includes)
+AC_CHECK_TYPES(struct in6_addr, [], [], $cares_all_includes)
+AC_CHECK_TYPES(struct sockaddr_in6, [], [], $cares_all_includes)
+AC_CHECK_TYPES(struct sockaddr_storage, [], [], $cares_all_includes)
+AC_CHECK_TYPES(struct addrinfo, [], [], $cares_all_includes)
+AC_CHECK_TYPES(struct timeval, [], [], $cares_all_includes)
+AC_CHECK_MEMBERS(struct sockaddr_in6.sin6_scope_id, [], [], $cares_all_includes)
+AC_CHECK_MEMBERS(struct addrinfo.ai_flags, [], [], $cares_all_includes)
+AC_CHECK_DECL(FIONBIO, [], [], $cares_all_includes)
+AC_CHECK_DECL(O_NONBLOCK, [], [], $cares_all_includes)
+AC_CHECK_DECL(SO_NONBLOCK, [], [], $cares_all_includes)
+AC_CHECK_DECL(MSG_NOSIGNAL, [], [], $cares_all_includes)
+AC_CHECK_DECL(CLOCK_MONOTONIC, [], [], $cares_all_includes)
+
+if test "$ac_cv_have_decl_CLOCK_MONOTONIC" = "yes" -a "$ac_cv_func_clock_gettime" = "yes" ; then
+ AC_DEFINE([HAVE_CLOCK_GETTIME_MONOTONIC], [ 1 ], [ clock_gettime() with CLOCK_MONOTONIC support ])
+fi
+
+if test "$ac_cv_have_decl_FIONBIO" = "yes" -a "$ac_cv_func_ioctl" = "yes" ; then
+ AC_DEFINE([HAVE_IOCTL_FIONBIO], [ 1 ], [ ioctl() with FIONBIO support ])
+fi
+if test "$ac_cv_have_decl_FIONBIO" = "yes" -a "$ac_cv_func_ioctlsocket" = "yes" ; then
+ AC_DEFINE([HAVE_IOCTLSOCKET_FIONBIO], [ 1 ], [ ioctlsocket() with FIONBIO support ])
+fi
+if test "$ac_cv_have_decl_SO_NONBLOCK" = "yes" -a "$ac_cv_func_setsockopt" = "yes" ; then
+ AC_DEFINE([HAVE_SETSOCKOPT_SO_NONBLOCK], [ 1 ], [ setsockopt() with SO_NONBLOCK support ])
+fi
+if test "$ac_cv_have_decl_O_NONBLOCK" = "yes" -a "$ac_cv_func_fcntl" = "yes" ; then
+ AC_DEFINE([HAVE_FCNTL_O_NONBLOCK], [ 1 ], [ fcntl() with O_NONBLOCK support ])
+fi
+
+dnl ares_build.h.in specific defines
+if test "x$ac_cv_header_sys_types_h" = "xyes" ; then
+ CARES_DEFINE_UNQUOTED([CARES_HAVE_SYS_TYPES_H],[1])
+fi
+if test "x$ac_cv_header_sys_random_h" = "xyes" ; then
+ CARES_DEFINE_UNQUOTED([CARES_HAVE_SYS_RANDOM_H],[1])
+fi
+if test "x$ac_cv_header_sys_socket_h" = "xyes" ; then
+ CARES_DEFINE_UNQUOTED([CARES_HAVE_SYS_SOCKET_H],[1])
+fi
+if test "x$ac_cv_header_ws2tcpip_h" = "xyes" ; then
+ CARES_DEFINE_UNQUOTED([CARES_HAVE_WS2TCPIP_H],[1])
+fi
+if test "x$ac_cv_header_winsock2_h" = "xyes" ; then
+ CARES_DEFINE_UNQUOTED([CARES_HAVE_WINSOCK2_H],[1])
+fi
+if test "x$ac_cv_header_windows_h" = "xyes" ; then
+ CARES_DEFINE_UNQUOTED([CARES_HAVE_WINDOWS_H],[1])
+fi
+if test "x$ac_cv_header_arpa_nameser_h" = "xyes" ; then
+ CARES_DEFINE_UNQUOTED([CARES_HAVE_ARPA_NAMESER_H],[1])
+fi
+if test "x$ac_cv_header_arpa_nameser_compa_h" = "xyes" ; then
+ CARES_DEFINE_UNQUOTED([CARES_HAVE_ARPA_NAMESER_COMPA_H],[1])
+fi
+
+
+dnl ------------ THREADING --------------
+
+dnl windows always supports threads, only check non-windows systems.
+if test "${CARES_THREADS}" = "yes" -a "x${ac_cv_native_windows}" != "xyes" ; then
+ AX_PTHREAD([ ], [
+ AC_MSG_WARN([threads requested but not supported])
+ CARES_THREADS=no
+ ])
+
+ if test "${CARES_THREADS}" = "yes" ; then
+ AC_CHECK_HEADERS([pthread.h pthread_np.h])
+ LIBS="$PTHREAD_LIBS $LIBS"
+ CFLAGS="$CFLAGS $PTHREAD_CFLAGS"
+ CC="$PTHREAD_CC"
+ CXX="$PTHREAD_CXX"
+ fi
+fi
+
+if test "${CARES_THREADS}" = "yes" ; then
+ AC_DEFINE([CARES_THREADS], [ 1 ], [Threading enabled])
+fi
+
+CARES_PRIVATE_LIBS="$LIBS"
+AC_SUBST(CARES_PRIVATE_LIBS)
+
+BUILD_SUBDIRS="include src docs"
+
+
+dnl ******** TESTS *******
+
+if test "x$build_tests" != "xno" -a "x$HAVE_CXX14" = "0" ; then
+ if test "x$build_tests" = "xmaybe" ; then
+ AC_MSG_WARN([cannot build tests without a CXX14 compiler])
+ build_tests=no
+ else
+ AC_MSG_ERROR([*** Building tests requires a CXX14 compiler])
+ fi
+fi
+if test "x$build_tests" != "xno" -a "x$cross_compiling" = "xyes" ; then
+ if test "x$build_tests" = "xmaybe" ; then
+ AC_MSG_WARN([cannot build tests when cross compiling])
+ build_tests=no
+ else
+ AC_MSG_ERROR([*** Tests not supported when cross compiling])
+ fi
+fi
+if test "x$build_tests" != "xno" ; then
+ PKG_CHECK_MODULES([GMOCK], [gmock], [ have_gmock=yes ], [ have_gmock=no ])
+ if test "x$have_gmock" = "xno" ; then
+ if test "x$build_tests" = "xmaybe" ; then
+ AC_MSG_WARN([gmock could not be found, not building tests])
+ build_tests=no
+ else
+ AC_MSG_ERROR([tests require gmock])
+ fi
+ fi
+fi
+if test "x$build_tests" != "xno" ; then
+ build_tests=yes
+
+ AX_CXX_COMPILE_STDCXX_14([noext],[mandatory])
+ if test "$ac_cv_native_windows" != "yes" ; then
+ AX_PTHREAD([ CARES_TEST_PTHREADS="yes" ], [ AC_MSG_ERROR([threading required for tests]) ])
+ fi
+
+ BUILD_SUBDIRS="${BUILD_SUBDIRS} test"
+fi
+AC_MSG_CHECKING([whether to build tests])
+AC_MSG_RESULT([$build_tests])
+
+
+AM_CONDITIONAL(BUILD_TESTS, test "x$build_tests" = "xyes")
+
+AC_SUBST(BUILD_SUBDIRS)
+
+AC_CONFIG_FILES([Makefile \
+ include/Makefile \
+ src/Makefile \
+ src/lib/Makefile \
+ src/tools/Makefile \
+ docs/Makefile \
+ libcares.pc ])
+AM_COND_IF([BUILD_TESTS],
+ [AC_CONFIG_FILES([test/Makefile])])
+
+AC_OUTPUT
diff --git a/subprojects/c-ares/docs/CMakeLists.txt b/subprojects/c-ares/docs/CMakeLists.txt
@@ -0,0 +1,19 @@
+# Copyright (C) The c-ares project and its contributors
+# SPDX-License-Identifier: MIT
+# Headers and Man Pages installation target
+IF (CARES_INSTALL)
+ # ManPages
+ FILE (GLOB DevelManPages "." "*.3")
+ INSTALL (FILES ${DevelManPages}
+ DESTINATION ${CMAKE_INSTALL_MANDIR}/man3
+ COMPONENT Devel
+ )
+
+ IF (CARES_BUILD_TOOLS)
+ FILE (GLOB ToolManPages "." "*.1")
+ INSTALL (FILES ${ToolManPages}
+ DESTINATION ${CMAKE_INSTALL_MANDIR}/man1
+ COMPONENT Tools
+ )
+ ENDIF ()
+ENDIF ()
diff --git a/subprojects/c-ares/docs/Makefile.am b/subprojects/c-ares/docs/Makefile.am
@@ -0,0 +1,10 @@
+# Copyright (C) The c-ares project and its contributors
+# SPDX-License-Identifier: MIT
+
+AUTOMAKE_OPTIONS = foreign subdir-objects no-dependencies
+
+include Makefile.inc
+
+man_MANS = $(MANPAGES)
+
+EXTRA_DIST = $(MANPAGES) ahost.1 adig.1 Makefile.inc CMakeLists.txt
diff --git a/subprojects/c-ares/docs/Makefile.inc b/subprojects/c-ares/docs/Makefile.inc
@@ -0,0 +1,130 @@
+# Copyright (C) The c-ares project and its contributors
+# SPDX-License-Identifier: MIT
+MANPAGES = ares_cancel.3 \
+ ares_create_query.3 \
+ ares_destroy.3 \
+ ares_destroy_options.3 \
+ ares_dns_class_fromstr.3 \
+ ares_dns_class_t.3 \
+ ares_dns_class_tostr.3 \
+ ares_dns_datatype_t.3 \
+ ares_dns_flags_t.3 \
+ ares_dns_mapping.3 \
+ ares_dns_opcode_tostr.3 \
+ ares_dns_opt_datatype_t.3 \
+ ares_dns_opt_get_datatype.3 \
+ ares_dns_opt_get_name.3 \
+ ares_dns_opcode_t.3 \
+ ares_dns_parse.3 \
+ ares_dns_rcode_t.3 \
+ ares_dns_rcode_tostr.3 \
+ ares_dns_record.3 \
+ ares_dns_record_create.3 \
+ ares_dns_record_get_flags.3 \
+ ares_dns_record_get_id.3 \
+ ares_dns_record_get_opcode.3 \
+ ares_dns_record_get_rcode.3 \
+ ares_dns_record_destroy.3 \
+ ares_dns_record_query_add.3 \
+ ares_dns_record_query_cnt.3 \
+ ares_dns_record_query_get.3 \
+ ares_dns_record_rr_add.3 \
+ ares_dns_record_rr_cnt.3 \
+ ares_dns_record_rr_del.3 \
+ ares_dns_record_rr_get.3 \
+ ares_dns_rec_type_fromstr.3 \
+ ares_dns_rec_type_t.3 \
+ ares_dns_rr.3 \
+ ares_dns_rr_get_addr.3 \
+ ares_dns_rr_get_addr6.3 \
+ ares_dns_rr_get_bin.3 \
+ ares_dns_rr_get_class.3 \
+ ares_dns_rr_get_keys.3 \
+ ares_dns_rr_get_name.3 \
+ ares_dns_rr_get_opt.3 \
+ ares_dns_rr_get_opt_byid.3 \
+ ares_dns_rr_get_opt_cnt.3 \
+ ares_dns_rr_get_str.3 \
+ ares_dns_rr_get_type.3 \
+ ares_dns_rr_get_ttl.3 \
+ ares_dns_rr_get_u16.3 \
+ ares_dns_rr_get_u32.3 \
+ ares_dns_rr_get_u8.3 \
+ ares_dns_rr_key_datatype.3 \
+ ares_dns_rr_key_t.3 \
+ ares_dns_rr_key_to_rec_type.3 \
+ ares_dns_rr_key_tostr.3 \
+ ares_dns_rr_set_addr.3 \
+ ares_dns_rr_set_addr6.3 \
+ ares_dns_rr_set_bin.3 \
+ ares_dns_rr_set_opt.3 \
+ ares_dns_rr_set_str.3 \
+ ares_dns_rr_set_u16.3 \
+ ares_dns_rr_set_u32.3 \
+ ares_dns_rr_set_u8.3 \
+ ares_dns_section_t.3 \
+ ares_dns_section_tostr.3 \
+ ares_dns_write.3 \
+ ares_dup.3 \
+ ares_expand_name.3 \
+ ares_expand_string.3 \
+ ares_fds.3 \
+ ares_free_data.3 \
+ ares_free_hostent.3 \
+ ares_free_string.3 \
+ ares_freeaddrinfo.3 \
+ ares_get_servers.3 \
+ ares_get_servers_csv.3 \
+ ares_get_servers_ports.3 \
+ ares_getaddrinfo.3 \
+ ares_gethostbyaddr.3 \
+ ares_gethostbyname.3 \
+ ares_gethostbyname_file.3 \
+ ares_getnameinfo.3 \
+ ares_getsock.3 \
+ ares_inet_ntop.3 \
+ ares_inet_pton.3 \
+ ares_init.3 \
+ ares_init_options.3 \
+ ares_library_cleanup.3 \
+ ares_library_init.3 \
+ ares_library_init_android.3 \
+ ares_library_initialized.3 \
+ ares_mkquery.3 \
+ ares_opt_param_t.3 \
+ ares_parse_a_reply.3 \
+ ares_parse_aaaa_reply.3 \
+ ares_parse_caa_reply.3 \
+ ares_parse_mx_reply.3 \
+ ares_parse_naptr_reply.3 \
+ ares_parse_ns_reply.3 \
+ ares_parse_ptr_reply.3 \
+ ares_parse_soa_reply.3 \
+ ares_parse_srv_reply.3 \
+ ares_parse_txt_reply.3 \
+ ares_parse_uri_reply.3 \
+ ares_process.3 \
+ ares_query.3 \
+ ares_reinit.3 \
+ ares_save_options.3 \
+ ares_search.3 \
+ ares_send.3 \
+ ares_set_local_dev.3 \
+ ares_set_local_ip4.3 \
+ ares_set_local_ip6.3 \
+ ares_set_servers.3 \
+ ares_set_servers_csv.3 \
+ ares_set_servers_ports.3 \
+ ares_set_servers_ports_csv.3 \
+ ares_set_socket_callback.3 \
+ ares_set_socket_configure_callback.3 \
+ ares_set_socket_functions.3 \
+ ares_set_sortlist.3 \
+ ares_strerror.3 \
+ ares_svcb_param_t.3 \
+ ares_threadsafety.3 \
+ ares_timeout.3 \
+ ares_tlsa_match_t.3 \
+ ares_tlsa_selector_t.3 \
+ ares_tlsa_usage_t.3 \
+ ares_version.3
diff --git a/subprojects/c-ares/docs/acountry.1 b/subprojects/c-ares/docs/acountry.1
@@ -0,0 +1,72 @@
+.\"
+.\" Copyright (C) the Massachusetts Institute of Technology.
+.\" Copyright (C) Daniel Stenberg
+.\"
+.\" Permission to use, copy, modify, and distribute this
+.\" software and its documentation for any purpose and without
+.\" fee is hereby granted, provided that the above copyright
+.\" notice appear in all copies and that both that copyright
+.\" notice and this permission notice appear in supporting
+.\" documentation, and that the name of M.I.T. not be used in
+.\" advertising or publicity pertaining to distribution of the
+.\" software without specific, written prior permission.
+.\" M.I.T. makes no representations about the suitability of
+.\" this software for any purpose. It is provided "as is"
+.\" without express or implied warranty.
+.\"
+.\" SPDX-License-Identifier: MIT
+.\"
+.TH ACOUNTRY "1" "April 2011" "c-ares utilities"
+.SH NAME
+acountry \- print the country where an IPv4 address or host is located
+.SH SYNOPSIS
+.B acountry
+[\fIOPTION\fR]... \fIHOST\fR...
+.SH DESCRIPTION
+.PP
+.\" Add any additional description here
+.PP
+Print the country where HOST (an IPv4 address or hostname) is located,
+using the countries.nerd.dk DNS domain to identify the country.
+.PP
+This utility comes with the \fBc\-ares\fR asynchronous resolver library.
+.SH OPTIONS
+.TP
+\fB\-d\fR
+Print some extra debugging output.
+.TP
+\fB\-h\fR, \fB\-?\fR
+Display this help and exit.
+.TP
+\fB\-v\fR
+Be more verbose. Print extra information.
+.SH "REPORTING BUGS"
+Report bugs to the c-ares mailing list:
+.br
+\fBhttps://lists.haxx.se/listinfo/c-ares\fR
+.SH "SEE ALSO"
+.PP
+adig(1), ahost(1).
+.PP
+The DNSBL countries.nerd.dk
+.br
+\fBhttp://countries.nerd.dk/\fR
+.SH COPYRIGHT
+This utility is based on code/ideas contained in software written by Greg Hudson (ares)
+carrying the following notice:
+.br
+Copyright 1998 by the Massachusetts Institute of Technology.
+.br
+Permission to use, copy, modify, and distribute this software and its
+documentation for any purpose and without fee is hereby granted,
+provided that the above copyright notice appear in all copies and that
+both that copyright notice and this permission notice appear in
+supporting documentation, and that the name of M.I.T. not be used in
+advertising or publicity pertaining to distribution of the software
+without specific, written prior permission. M.I.T. makes no
+representations about the suitability of this software for any
+purpose. It is provided "as is" without express or implied warranty.
+.br
+No further copyright claims are being made by the author(s) of this utility.
+.SH AUTHOR
+Gisle Vanem
diff --git a/subprojects/c-ares/docs/adig.1 b/subprojects/c-ares/docs/adig.1
@@ -0,0 +1,97 @@
+.\"
+.\" Copyright (C) the Massachusetts Institute of Technology.
+.\" Copyright (C) Daniel Stenberg
+.\"
+.\" Permission to use, copy, modify, and distribute this
+.\" software and its documentation for any purpose and without
+.\" fee is hereby granted, provided that the above copyright
+.\" notice appear in all copies and that both that copyright
+.\" notice and this permission notice appear in supporting
+.\" documentation, and that the name of M.I.T. not be used in
+.\" advertising or publicity pertaining to distribution of the
+.\" software without specific, written prior permission.
+.\" M.I.T. makes no representations about the suitability of
+.\" this software for any purpose. It is provided "as is"
+.\" without express or implied warranty.
+.\"
+.\" SPDX-License-Identifier: MIT
+.\"
+.TH ADIG "1" "April 2011" "c-ares utilities"
+.SH NAME
+adig \- print information collected from Domain Name System (DNS) servers
+.SH SYNOPSIS
+.B adig
+[\fIOPTION\fR]... \fINAME\fR...
+.SH DESCRIPTION
+.PP
+.\" Add any additional description here
+.PP
+Send queries to DNS servers about \fINAME\fR and print received
+information, where \fINAME\fR is a valid DNS name (e.g. www.example.com,
+1.2.3.10.in-addr.arpa).
+.PP
+This utility comes with the \fBc\-ares\fR asynchronous resolver library.
+.SH OPTIONS
+.TP
+\fB\-c\fR class
+Set the query class.
+Possible values for class are
+ANY, CHAOS, HS and IN (default).
+.TP
+\fB\-d\fR
+Print some extra debugging output.
+.TP
+\fB\-f\fR flag
+Add a behavior control flag.
+Possible values for flag are
+ igntc - ignore query truncation, return answer as-is instead of retrying
+ via tcp.
+ noaliases - don't honor the HOSTALIASES environment variable,
+ norecurse - don't query upstream servers recursively,
+ primary - use the first server,
+ stayopen - don't close the communication sockets, and
+ usevc - always use TCP.
+.TP
+\fB\-h\fR, \fB\-?\fR
+Display this help and exit.
+.TP
+\fB\-s\fR server
+Connect to specified DNS server, instead of the system's default one(s).
+Servers are tried in round-robin, if the previous one failed.
+.TP
+\fB\-t\fR type
+Query records of specified type.
+Possible values for type are
+A (default), AAAA, ANY, AXFR, CNAME, HINFO, MX, NAPTR, NS, PTR, SOA, SRV, TXT,
+URI, CAA, SVCB, and HTTPS.
+.TP
+\fB\-T\fR port
+Connect to the specified TCP port of DNS server.
+.TP
+\fB\-U\fR port
+Connect to the specified UDP port of DNS server.
+
+.SH "REPORTING BUGS"
+Report bugs to the c-ares mailing list:
+.br
+\fBhttps://lists.haxx.se/listinfo/c-ares\fR
+.SH "SEE ALSO"
+.PP
+acountry(1), ahost(1).
+.SH COPYRIGHT
+This utility is based on code/ideas contained in software written by Greg Hudson (ares)
+carrying the following notice:
+.br
+Copyright 1998 by the Massachusetts Institute of Technology.
+.br
+Permission to use, copy, modify, and distribute this software and its
+documentation for any purpose and without fee is hereby granted,
+provided that the above copyright notice appear in all copies and that
+both that copyright notice and this permission notice appear in
+supporting documentation, and that the name of M.I.T. not be used in
+advertising or publicity pertaining to distribution of the software
+without specific, written prior permission. M.I.T. makes no
+representations about the suitability of this software for any
+purpose. It is provided "as is" without express or implied warranty.
+.br
+No further copyright claims are being made by the author(s) of this utility.
diff --git a/subprojects/c-ares/docs/ahost.1 b/subprojects/c-ares/docs/ahost.1
@@ -0,0 +1,80 @@
+.\"
+.\" Copyright (C) the Massachusetts Institute of Technology.
+.\" Copyright (C) Daniel Stenberg
+.\"
+.\" Permission to use, copy, modify, and distribute this
+.\" software and its documentation for any purpose and without
+.\" fee is hereby granted, provided that the above copyright
+.\" notice appear in all copies and that both that copyright
+.\" notice and this permission notice appear in supporting
+.\" documentation, and that the name of M.I.T. not be used in
+.\" advertising or publicity pertaining to distribution of the
+.\" software without specific, written prior permission.
+.\" M.I.T. makes no representations about the suitability of
+.\" this software for any purpose. It is provided "as is"
+.\" without express or implied warranty.
+.\"
+.\" SPDX-License-Identifier: MIT
+.\"
+.TH AHOST "1" "April 2011" "c-ares utilities"
+.SH NAME
+ahost \- print the A or AAAA record associated with a hostname or IP address
+.SH SYNOPSIS
+.B ahost
+[\fIOPTION\fR]... \fIHOST\fR...
+.SH DESCRIPTION
+.PP
+.\" Add any additional description here
+.PP
+Look up the DNS A or AAAA record associated with HOST (a hostname or an
+IP address).
+.PP
+This utility comes with the \fBc\-ares\fR asynchronous resolver library.
+.SH OPTIONS
+.TP
+\fB\-d\fR
+Print some extra debugging output.
+.TP
+\fB\-h\fR, \fB\-?\fR
+Display this help and exit.
+.TP
+\fB\-t\fR type
+If type is "a", print the A record.
+If type is "aaaa", print the AAAA record.
+If type is "u", look for both AAAA and A records (default).
+.TP
+\fB\-s\fR server
+Set the server list to use for DNS lookups.
+.TP
+\fB\-D\fR \fIdomain\fP
+Specify the \fIdomain\fP to search instead of using the default values from
+.br
+/etc/resolv.conf. This option only has an effect on platforms that use
+.br
+/etc/resolv.conf
+for DNS configuration; it has no effect on other platforms (such as Win32
+or Android).
+.SH "REPORTING BUGS"
+Report bugs to the c-ares mailing list:
+.br
+\fBhttps://lists.haxx.se/listinfo/c-ares\fR
+.SH "SEE ALSO"
+.PP
+acountry(1), adig(1).
+.SH COPYRIGHT
+This utility is based on code/ideas contained in software written by Greg Hudson (ares)
+carrying the following notice:
+.br
+Copyright 1998 by the Massachusetts Institute of Technology.
+.br
+Permission to use, copy, modify, and distribute this software and its
+documentation for any purpose and without fee is hereby granted,
+provided that the above copyright notice appear in all copies and that
+both that copyright notice and this permission notice appear in
+supporting documentation, and that the name of M.I.T. not be used in
+advertising or publicity pertaining to distribution of the software
+without specific, written prior permission. M.I.T. makes no
+representations about the suitability of this software for any
+purpose. It is provided "as is" without express or implied warranty.
+.br
+No further copyright claims are being made by the author(s) of this utility.
diff --git a/subprojects/c-ares/docs/ares_cancel.3 b/subprojects/c-ares/docs/ares_cancel.3
@@ -0,0 +1,48 @@
+.\"
+.\" Copyright 1998 by the Massachusetts Institute of Technology.
+.\"
+.\" Permission to use, copy, modify, and distribute this
+.\" software and its documentation for any purpose and without
+.\" fee is hereby granted, provided that the above copyright
+.\" notice appear in all copies and that both that copyright
+.\" notice and this permission notice appear in supporting
+.\" documentation, and that the name of M.I.T. not be used in
+.\" advertising or publicity pertaining to distribution of the
+.\" software without specific, written prior permission.
+.\" M.I.T. makes no representations about the suitability of
+.\" this software for any purpose. It is provided "as is"
+.\" without express or implied warranty.
+.\"
+.\" SPDX-License-Identifier: MIT
+.\"
+.TH ARES_CANCEL 3 "31 March 2004"
+.SH NAME
+ares_cancel \- Cancel a resolve
+.SH SYNOPSIS
+.nf
+#include <ares.h>
+
+void ares_cancel(ares_channel_t *\fIchannel\fP)
+.fi
+.SH DESCRIPTION
+The \fBares_cancel(3)\fP function cancels all lookups/requests made on the the
+name service channel identified by \fIchannel\fP. \fBares_cancel(3)\fP
+invokes the callbacks for each pending query on the channel, passing a status
+of
+.BR ARES_ECANCELLED .
+These calls give the callbacks a chance to clean up any state which might have
+been stored in their arguments. If such a callback invocation adds a new
+request to the channel, that request will \fInot\fP be cancelled by the
+current invocation of \fBares_cancel(3)\fP.
+.SH SEE ALSO
+.BR ares_init (3)
+.BR ares_destroy (3)
+.SH NOTES
+This function was added in c-ares 1.2.0
+
+c-ares 1.6.0 and earlier pass a status of
+.BR ARES_ETIMEOUT
+instead of
+.BR ARES_ECANCELLED .
+.SH AUTHOR
+Dirk Manske
diff --git a/subprojects/c-ares/docs/ares_create_query.3 b/subprojects/c-ares/docs/ares_create_query.3
@@ -0,0 +1,86 @@
+.\"
+.\" Copyright 1998 by the Massachusetts Institute of Technology.
+.\"
+.\" Permission to use, copy, modify, and distribute this
+.\" software and its documentation for any purpose and without
+.\" fee is hereby granted, provided that the above copyright
+.\" notice appear in all copies and that both that copyright
+.\" notice and this permission notice appear in supporting
+.\" documentation, and that the name of M.I.T. not be used in
+.\" advertising or publicity pertaining to distribution of the
+.\" software without specific, written prior permission.
+.\" M.I.T. makes no representations about the suitability of
+.\" this software for any purpose. It is provided "as is"
+.\" without express or implied warranty.
+.\"
+.\" SPDX-License-Identifier: MIT
+.\"
+.TH ARES_CREATE_QUERY 3 "17 Aug 2012"
+.SH NAME
+ares_create_query \- Compose a single-question DNS query buffer
+.SH SYNOPSIS
+.nf
+#include <ares.h>
+
+int ares_create_query(const char *\fIname\fP,
+ int \fIdnsclass\fP,
+ int \fItype\fP,
+ unsigned short \fIid\fP,
+ int \fIrd\fP,
+ unsigned char **\fIbuf\fP,
+ int *\fIbuflen\fP,
+ int \fImax_udp_size\fP)
+.fi
+.SH DESCRIPTION
+The \fIares_create_query(3)\fP function composes a DNS query with a single
+question. The parameter \fIname\fP gives the query name as a NUL-terminated C
+string of period-separated labels optionally ending with a period; periods and
+backslashes within a label must be escaped with a backlash.
+
+The parameters \fIdnsclass\fP and \fItype\fP give the class and type of the
+query using the values defined in \fB<arpa/nameser.h>\fP.
+
+The parameter \fIid\fP gives a 16-bit identifier for the query.
+
+The parameter \fIrd\fP should be nonzero if recursion is desired, zero if not.
+
+The query will be placed in an allocated buffer, a pointer to which will be
+stored in the variable pointed to by \fIbuf\fP, and the length of which will
+be stored in the variable pointed to by \fIbuflen\fP.
+
+It is the caller's responsibility to free this buffer using
+\fIares_free_string(3)\fP when it is no longer needed. The parameter
+\fImax_udp_size\fP should be nonzero to activate EDNS. Usage of
+\fIares_create_query(3)\fP\ with \fImax_udp_size\fP set to zero is equivalent
+to using \fIares_mkquery(3)\fP.
+.SH RETURN VALUES
+.B ares_create_query
+can return any of the following values:
+.TP 15
+.B ARES_SUCCESS
+Construction of the DNS query succeeded.
+.TP 15
+.B ARES_ENOTFOUND
+The query name
+.I name
+refers to a
+.I .onion
+domain name. See RFC 7686.
+.TP 15
+.B ARES_EBADNAME
+The query name
+.I name
+could not be encoded as a domain name, either because it contained a
+zero-length label or because it contained a label of more than 63
+characters.
+.TP 15
+.B ARES_ENOMEM
+Memory was exhausted.
+.SH AVAILABILITY
+Added in c-ares 1.10.0
+.SH SEE ALSO
+.BR ares_dns_record (3),
+.BR ares_expand_name (3),
+.BR ares_free_string (3),
+.BR ares_mkquery (3)
+.SH AUTHOR
diff --git a/subprojects/c-ares/docs/ares_destroy.3 b/subprojects/c-ares/docs/ares_destroy.3
@@ -0,0 +1,46 @@
+.\"
+.\" Copyright 1998 by the Massachusetts Institute of Technology.
+.\"
+.\" Permission to use, copy, modify, and distribute this
+.\" software and its documentation for any purpose and without
+.\" fee is hereby granted, provided that the above copyright
+.\" notice appear in all copies and that both that copyright
+.\" notice and this permission notice appear in supporting
+.\" documentation, and that the name of M.I.T. not be used in
+.\" advertising or publicity pertaining to distribution of the
+.\" software without specific, written prior permission.
+.\" M.I.T. makes no representations about the suitability of
+.\" this software for any purpose. It is provided "as is"
+.\" without express or implied warranty.
+.\"
+.\" SPDX-License-Identifier: MIT
+.\"
+.TH ARES_DESTROY 3 "7 December 2004"
+.SH NAME
+ares_destroy \- Destroy a resolver channel
+.SH SYNOPSIS
+.nf
+#include <ares.h>
+
+void ares_destroy(ares_channel_t *\fIchannel\fP)
+.fi
+.SH DESCRIPTION
+The \fBares_destroy(3)\fP function destroys the name service channel
+identified by \fIchannel\fP, freeing all memory and closing all sockets used
+by the channel.
+
+\fBares_destroy(3)\fP invokes the callbacks for each pending query on the
+channel, passing a status of \fIARES_EDESTRUCTION\fP. These calls give the
+callbacks a chance to clean up any state which might have been stored in their
+arguments. A callback must not add new requests to a channel being destroyed.
+
+There is no ability to make this function thread-safe. No additional calls
+using this channel may be made once this function is called.
+.SH SEE ALSO
+.BR ares_init (3),
+.BR ares_cancel (3),
+.BR ares_threadsafety (3)
+.SH AUTHOR
+Greg Hudson, MIT Information Systems
+.br
+Copyright 1998 by the Massachusetts Institute of Technology.
diff --git a/subprojects/c-ares/docs/ares_destroy_options.3 b/subprojects/c-ares/docs/ares_destroy_options.3
@@ -0,0 +1,37 @@
+.\"
+.\" Copyright 1998 by the Massachusetts Institute of Technology.
+.\"
+.\" Permission to use, copy, modify, and distribute this
+.\" software and its documentation for any purpose and without
+.\" fee is hereby granted, provided that the above copyright
+.\" notice appear in all copies and that both that copyright
+.\" notice and this permission notice appear in supporting
+.\" documentation, and that the name of M.I.T. not be used in
+.\" advertising or publicity pertaining to distribution of the
+.\" software without specific, written prior permission.
+.\" M.I.T. makes no representations about the suitability of
+.\" this software for any purpose. It is provided "as is"
+.\" without express or implied warranty.
+.\"
+.\" SPDX-License-Identifier: MIT
+.\"
+.TH ARES_DESTROY_OPTIONS 3 "1 June 2007"
+.SH NAME
+ares_destroy_options \- Destroy options initialized with ares_save_options
+.SH SYNOPSIS
+.nf
+#include <ares.h>
+
+void ares_destroy_options(struct ares_options *\fIoptions\fP)
+.fi
+.SH DESCRIPTION
+The \fBares_destroy_options(3)\fP function destroys the options struct
+identified by \Ioptions\fP, freeing all memory allocated by
+\fBares_save_options(3)\fP.
+.SH SEE ALSO
+.BR ares_save_options (3),
+.BR ares_init_options (3)
+.SH AUTHOR
+Brad House
+.br
+Copyright 1998 by the Massachusetts Institute of Technology.
diff --git a/subprojects/c-ares/docs/ares_dns_class_fromstr.3 b/subprojects/c-ares/docs/ares_dns_class_fromstr.3
@@ -0,0 +1,4 @@
+.\"
+.\" Copyright (C) Daniel Stenberg
+.\" SPDX-License-Identifier: MIT
+.so man3/ares_dns_mapping.3
diff --git a/subprojects/c-ares/docs/ares_dns_class_t.3 b/subprojects/c-ares/docs/ares_dns_class_t.3
@@ -0,0 +1,3 @@
+.\" Copyright (C) 2023 The c-ares project and its contributors.
+.\" SPDX-License-Identifier: MIT
+.so man3/ares_dns_record.3
diff --git a/subprojects/c-ares/docs/ares_dns_class_tostr.3 b/subprojects/c-ares/docs/ares_dns_class_tostr.3
@@ -0,0 +1,4 @@
+.\"
+.\" Copyright (C) Daniel Stenberg
+.\" SPDX-License-Identifier: MIT
+.so man3/ares_dns_mapping.3
diff --git a/subprojects/c-ares/docs/ares_dns_datatype_t.3 b/subprojects/c-ares/docs/ares_dns_datatype_t.3
@@ -0,0 +1,4 @@
+.\"
+.\" Copyright (C) Daniel Stenberg
+.\" SPDX-License-Identifier: MIT
+.so man3/ares_dns_mapping.3
diff --git a/subprojects/c-ares/docs/ares_dns_flags_t.3 b/subprojects/c-ares/docs/ares_dns_flags_t.3
@@ -0,0 +1,3 @@
+.\" Copyright (C) 2023 The c-ares project and its contributors.
+.\" SPDX-License-Identifier: MIT
+.so man3/ares_dns_record.3
diff --git a/subprojects/c-ares/docs/ares_dns_mapping.3 b/subprojects/c-ares/docs/ares_dns_mapping.3
@@ -0,0 +1,302 @@
+.\" Copyright (C) 2023 The c-ares project and its contributors.
+.\" SPDX-License-Identifier: MIT
+.\"
+.TH ARES_DNS_MAPPINGS 3 "12 November 2023"
+.SH NAME
+ares_dns_class_fromstr, ares_dns_class_tostr, ares_dns_datatype_t, ares_dns_opcode_tostr,
+ares_dns_opt_datatype_t, ares_dns_opt_get_datatype, ares_dns_opt_get_name,
+ares_dns_rcode_tostr, ares_dns_rec_type_fromstr, ares_dns_rr_get_keys,
+ares_dns_rr_key_datatype, ares_dns_rr_key_to_rec_type, ares_dns_rr_key_tostr,
+ares_dns_section_tostr, ares_opt_param_t, ares_svcb_param_t \-
+Helper functions for converting dns record identifiers to and from their
+respective types, as well identifying datatypes for various records.
+.SH SYNOPSIS
+.nf
+#include <ares.h>
+
+const char *ares_dns_rec_type_tostr(ares_dns_rec_type_t type);
+
+const char *ares_dns_class_tostr(ares_dns_class_t qclass);
+
+const char *ares_dns_opcode_tostr(ares_dns_opcode_t opcode);
+
+const char *ares_dns_rr_key_tostr(ares_dns_rr_key_t key);
+
+const char *ares_dns_section_tostr(ares_dns_section_t section);
+
+const char *ares_dns_rcode_tostr(ares_dns_rcode_t rcode);
+
+ares_bool_t ares_dns_class_fromstr(ares_dns_class_t *qclass, const char *str);
+
+ares_bool_t ares_dns_rec_type_fromstr(ares_dns_rec_type_t *qtype,
+ const char *str);
+
+const ares_dns_rr_key_t *ares_dns_rr_get_keys(ares_dns_rec_type_t type,
+ size_t *cnt);
+
+ares_dns_datatype_t ares_dns_rr_key_datatype(ares_dns_rr_key_t key);
+
+ares_dns_rec_type_t ares_dns_rr_key_to_rec_type(ares_dns_rr_key_t key);
+
+ares_dns_opt_datatype_t ares_dns_opt_get_datatype(ares_dns_rr_key_t key,
+ unsigned short opt);
+
+const char *ares_dns_opt_get_name(ares_dns_rr_key_t key, unsigned short opt);
+
+.fi
+.SH ENUMERATIONS
+.B ares_dns_datatype_t -
+Data types associated with \fIares_dns_rr_key_t\fP:
+.RS 4
+.B ARES_DATATYPE_INADDR
+- IPv4 address as \fIstruct in_addr *\fP. Use \fIares_dns_rr_set_addr(3)\fP to
+set and \fIares_dns_rr_get_addr(3)\fP to get.
+.br
+.B ARES_DATATYPE_INADDR6
+- IPv6 address as \fIstruct ares_in6_addr *\fP. Use \fIares_dns_rr_set_addr6(3)\fP to
+set and \fIares_dns_rr_get_addr6(3)\fP to get.
+.br
+.B ARES_DATATYPE_U8
+- 8bit unsigned integer. Use \fIares_dns_rr_set_u8(3)\fP to
+set and \fIares_dns_rr_get_u8(3)\fP to get.
+.br
+.B ARES_DATATYPE_U16
+- 16bit unsigned integer. Use \fIares_dns_rr_set_u16(3)\fP to
+set and \fIares_dns_rr_get_u16(3)\fP to get.
+.br
+.B ARES_DATATYPE_U32
+- 32bit unsigned integer. Use \fIares_dns_rr_set_u32(3)\fP to
+set and \fIares_dns_rr_get_u32(3)\fP to get.
+.br
+.B ARES_DATATYPE_NAME
+- Null-terminated string of a domain name (series of labels). Use \fIares_dns_rr_set_str(3)\fP to
+set and \fIares_dns_rr_get_str(3)\fP to get.
+.br
+.B ARES_DATATYPE_STR
+- Null-terminated string. Use \fIares_dns_rr_set_str(3)\fP to
+set and \fIares_dns_rr_get_str(3)\fP to get.
+.br
+.B ARES_DATATYPE_BIN
+- Binary Data. Use \fIares_dns_rr_set_bin(3)\fP to
+set and \fIares_dns_rr_get_bin(3)\fP to get.
+.br
+.B ARES_DATATYPE_BINP
+- Officially defined as binary data, but likely printable. Guaranteed to have
+a NULL terminator for convenience (not included in length). Use \fIares_dns_rr_set_bin(3)\fP to
+set and \fIares_dns_rr_get_bin(3)\fP to get.
+.br
+.B ARES_DATATYPE_OPT
+- Array of options. 16bit identifier, Binary data. Use \fIares_dns_rr_set_opt(3)\fP to
+set and \fIares_dns_rr_get_opt(3)\fP to get.
+.br
+.RE
+
+.B ares_dns_opt_datatype_t -
+Data types associated with \fIARES_DATATYPE_OPT\fP parameters if known as returned
+by \fIares_dns_opt_get_datatype(3)\fP:
+.RS 4
+.B ARES_OPT_DATATYPE_NONE
+- No value allowed for this parameter
+.br
+.B ARES_OPT_DATATYPE_STR_LIST
+- List of strings, each prefixed with a single octet representing the length as
+defined by RFC 1035. Can use \fIares_expand_string(3)\fP until buffer is consumed.
+.br
+.B ARES_OPT_DATATYPE_U8_LIST
+- List of 8bit unsigned integers, concatenated
+.br
+.B ARES_OPT_DATATYPE_U16
+- 16bit unsigned integer in network byte order
+.br
+.B ARES_OPT_DATATYPE_U16_LIST
+- list of 16bit unsigned integers in network byte order, concatenated.
+.br
+.B ARES_OPT_DATATYPE_U32
+- 32bit unsigned integer in network byte order
+.br
+.B ARES_OPT_DATATYPE_U32_LIST
+- list of 16bit unsigned integers in network byte order, concatenated.
+.br
+.B ARES_OPT_DATATYPE_INADDR4_LIST
+- List of ipv4 addresses in network byte order, concatenated
+.br
+.B ARES_OPT_DATATYPE_INADDR6_LIST
+- List of ipv6 addresses in network byte order, concatenated
+.br
+.B ARES_OPT_DATATYPE_BIN
+- Binary Data
+.br
+.B ARES_OPT_DATATYPE_NAME
+- DNS Domain Name binary format as defined in RFC1035, can use \fIares_expand_name(3)\fP
+.br
+.RE
+
+.B ares_svcb_param_t -
+SVCB (and HTTPS) RR known parameters as returned by \fIares_dns_opt_get_datatype(3)\fP
+with \fIARES_RR_SVCB_PARAMS\fP or \fIARES_RR_HTTPS_PARAMS\fP:
+.RS 4
+.B ARES_SVCB_PARAM_MANDATORY
+- Mandatory keys in this RR (RFC 9460 Section 8). Datatype: \fIARES_OPT_DATATYPE_U16_LIST\fP
+.br
+.B ARES_SVCB_PARAM_ALPN
+- Additional supported protocols (RFC 9460 Section 7.1). Datatype: \fIARES_OPT_DATATYPE_STR_LIST\fP
+.br
+.B ARES_SVCB_PARAM_NO_DEFAULT_ALPN
+- No support for default protocol (RFC 9460 Section 7.1). Datatype: \fIARES_OPT_DATATYPE_NONE\fP
+.br
+.B ARES_SVCB_PARAM_PORT
+- Port for alternative endpoint (RFC 9460 Section 7.2). Datatype: \fIARES_OPT_DATATYPE_U16\fP
+.br
+.B ARES_SVCB_PARAM_IPV4HINT
+- IPv4 address hints (RFC 9460 Section 7.3). Datatype: \fIARES_OPT_DATATYPE_INADDR4_LIST\fP
+.br
+.B ARES_SVCB_PARAM_ECH
+- RESERVED (held for Encrypted ClientHello)
+.br
+.B ARES_SVCB_PARAM_IPV6HINT
+- IPv6 address hints (RFC 9460 Section 7.3). Datatype: \fIARES_OPT_DATATYPE_INADDR6_LIST\fP
+.br
+
+.RE
+
+.B ares_opt_param_t -
+OPT RR known parameters as returned by \fIares_dns_opt_get_datatype(3)\fP
+with \fIARES_RR_OPT_OPTIONS\fB:
+.RS 4
+.B ARES_OPT_PARAM_LLQ
+- RFC 8764. Apple's DNS Long-Lived Queries Protocol. Datatype: \fIARES_OPT_DATATYPE_BIN\fP
+.br
+.B ARES_OPT_PARAM_UL
+- http://files.dns-sd.org/draft-sekar-dns-ul.txt: Update Lease. Datatype: \fIARES_OPT_DATATYPE_U32\fP
+.br
+.B ARES_OPT_PARAM_NSID
+- RFC 5001. Name Server Identification. Datatype: \fIARES_OPT_DATATYPE_BIN\fP
+.br
+.B ARES_OPT_PARAM_DAU
+- RFC 6975. DNSSEC Algorithm Understood. Datatype: \fIARES_OPT_DATATYPE_U8_LIST\fP
+.br
+.B ARES_OPT_PARAM_DHU
+- RFC 6975. DS Hash Understood. Datatype: \fIARES_OPT_DATATYPE_U8_LIST\fP
+.br
+.B ARES_OPT_PARAM_N3U
+- RFC 6975. NSEC3 Hash Understood. Datatype: \fIARES_OPT_DATATYPE_U8_LIST\fP
+.br
+.B ARES_OPT_PARAM_EDNS_CLIENT_SUBNET
+- RFC 7871. Client Subnet. Datatype: \fIARES_OPT_DATATYPE_BIN\fP
+.br
+.B ARES_OPT_PARAM_EDNS_EXPIRE
+- RFC 7314. Expire Timer. Datatype: \fIARES_OPT_DATATYPE_U32\fP
+.br
+.B ARES_OPT_PARAM_COOKIE
+- RFC 7873. Client and Server Cookies. Datatype: \fIARES_OPT_DATATYPE_BIN\fP
+.br
+.B ARES_OPT_PARAM_EDNS_TCP_KEEPALIVE
+- RFC 7828. TCP Keepalive timeout. Datatype: \fIARES_OPT_DATATYPE_U16\fP
+.br
+.B ARES_OPT_PARAM_PADDING
+- RFC 7830. Padding. Datatype: \fIARES_OPT_DATATYPE_BIN\fP
+.br
+.B ARES_OPT_PARAM_CHAIN
+- RFC 7901. Chain query requests. Datatype: \fIARES_OPT_DATATYPE_NAME\fP
+.br
+.B ARES_OPT_PARAM_EDNS_KEY_TAG
+- RFC 8145. Signaling Trust Anchor Knowledge in DNSSEC. Datatype: \fIARES_OPT_DATATYPE_U16_LIST\fP
+.br
+.B ARES_OPT_PARAM_EXTENDED_DNS_ERROR
+- RFC 8914. Extended ERROR code and message. Datatype: \fIARES_OPT_DATATYPE_BIN\fP
+.br
+.RE
+
+.SH DESCRIPTION
+The \fIares_dns_rec_type_tostr(3)\fP function outputs a human readable DNS record
+type from its numeric form passed in
+.IR type .
+
+The \fIares_dns_class_tostr(3)\fP function outputs a human readable DNS class
+from its numeric form passed in
+.IR qclass .
+
+The \fIares_dns_opcode_tostr(3)\fP function outputs a human readable DNS opcode
+from its numeric form in
+.IR opcode .
+
+The \fIares_dns_rr_key_tostr(3)\fP function outputs a human readable DNS Resource
+Record parameter name from its numeric form in
+.IR key .
+
+The \fIares_dns_section_tostr(3)\fP function outputs a human readable DNS
+message section from its numeric form in
+.IR section .
+
+The \fIares_dns_rcode_tostr(3)\fP function outputs a human readable DNS
+response code from its numeric form in
+.IR rcode .
+
+The \fIares_dns_class_fromstr(3)\fP function outputs the DNS class in numeric
+from from its string representation in
+.IR str .
+The result is stored into the variable pointed to by
+.IR qclass .
+
+The \fIares_dns_rec_type_fromstr(3)\fP function outputs the DNS record type in
+numeric from from its string representation in
+.IR str .
+The result is stored into the variable pointed to by
+.IR qtype .
+
+The \fIares_dns_rr_get_keys(3)\fP function retrieves a list of parameters that
+may be set or retrieved for the provided
+.IR type .
+The count of returned keys is stored into the variable pointed to by
+.IR cnt .
+
+The \fIares_dns_rr_key_datatype(3)\fP function retrieves the associated datatype
+for an RR parameter specified by
+.IR key .
+
+The \fIares_dns_rr_key_to_rec_type(3)\fP function dereferences the provided RR
+parameter specified by
+.IR key
+to the DNS Record Type it belongs.
+
+The \fIares_dns_opt_get_datatype(3)\fP function is used in association with
+\fIares_dns_rr_set_opt(3)\fP and \fIares_dns_rr_get_opt(3)\fP to retrieve the
+datatype of an option record contained within an RR as specified in
+.IR key
+if it is known. The raw option record identifier is provided by
+.IR opt .
+
+The \fIares_dns_opt_get_name(3)\fP function is used in association with
+\fIares_dns_rr_set_opt(3)\fP and \fIares_dns_rr_get_opt(3)\fP to retrieve human
+readable parameter name of an option record contained within an RR as specified
+in
+.IR key
+if it is known. The raw option record identifier is provided by
+.IR opt .
+
+.SH RETURN VALUES
+\fIares_dns_rec_type_tostr(3)\fP, \fIares_dns_class_tostr(3)\fP,
+\fIares_dns_opcode_tostr(3)\fP, \fIares_dns_rr_key_tostr(3)\fP,
+\fIares_dns_section_tostr(3)\fP, \fIares_dns_rcode_tostr(3)\fP, and
+\fIares_dns_opt_get_name(3)\fP all return a human printable ASCII string, or
+NULL on error.
+
+\fIares_dns_class_fromstr(3)\fP and \fIares_dns_rec_type_fromstr(3)\fP return
+.B ARES_TRUE
+on successful conversion, otherwise
+.B ARES_FALSE.
+
+\fIares_dns_rr_get_keys(3)\fP returns an array of keys or NULL on failure.
+
+\fIares_dns_rr_key_datatype(3)\fP, \fIares_dns_rr_key_to_rec_type(3)\fP, and
+\fIares_dns_opt_get_datatype(3)\fP return their respective integer values, or
+0 on failure.
+
+.SH AVAILABILITY
+These functions were first introduced in c-ares version 1.22.0.
+.SH SEE ALSO
+.BR ares_dns_record (3),
+.BR ares_dns_rr (3),
+.BR ares_init (3)
+.SH AUTHOR
+Copyright (C) 2023 The c-ares project and its members.
diff --git a/subprojects/c-ares/docs/ares_dns_opcode_t.3 b/subprojects/c-ares/docs/ares_dns_opcode_t.3
@@ -0,0 +1,3 @@
+.\" Copyright (C) 2023 The c-ares project and its contributors.
+.\" SPDX-License-Identifier: MIT
+.so man3/ares_dns_record.3
diff --git a/subprojects/c-ares/docs/ares_dns_opcode_tostr.3 b/subprojects/c-ares/docs/ares_dns_opcode_tostr.3
@@ -0,0 +1,4 @@
+.\"
+.\" Copyright (C) Daniel Stenberg
+.\" SPDX-License-Identifier: MIT
+.so man3/ares_dns_mapping.3
diff --git a/subprojects/c-ares/docs/ares_dns_opt_datatype_t.3 b/subprojects/c-ares/docs/ares_dns_opt_datatype_t.3
@@ -0,0 +1,4 @@
+.\"
+.\" Copyright (C) Daniel Stenberg
+.\" SPDX-License-Identifier: MIT
+.so man3/ares_dns_mapping.3
diff --git a/subprojects/c-ares/docs/ares_dns_opt_get_datatype.3 b/subprojects/c-ares/docs/ares_dns_opt_get_datatype.3
@@ -0,0 +1,4 @@
+.\"
+.\" Copyright (C) Daniel Stenberg
+.\" SPDX-License-Identifier: MIT
+.so man3/ares_dns_mapping.3
diff --git a/subprojects/c-ares/docs/ares_dns_opt_get_name.3 b/subprojects/c-ares/docs/ares_dns_opt_get_name.3
@@ -0,0 +1,4 @@
+.\"
+.\" Copyright (C) Daniel Stenberg
+.\" SPDX-License-Identifier: MIT
+.so man3/ares_dns_mapping.3
diff --git a/subprojects/c-ares/docs/ares_dns_parse.3 b/subprojects/c-ares/docs/ares_dns_parse.3
@@ -0,0 +1,3 @@
+.\" Copyright (C) 2023 The c-ares project and its contributors.
+.\" SPDX-License-Identifier: MIT
+.so man3/ares_dns_record.3
diff --git a/subprojects/c-ares/docs/ares_dns_rcode_t.3 b/subprojects/c-ares/docs/ares_dns_rcode_t.3
@@ -0,0 +1,3 @@
+.\" Copyright (C) 2023 The c-ares project and its contributors.
+.\" SPDX-License-Identifier: MIT
+.so man3/ares_dns_record.3
diff --git a/subprojects/c-ares/docs/ares_dns_rcode_tostr.3 b/subprojects/c-ares/docs/ares_dns_rcode_tostr.3
@@ -0,0 +1,4 @@
+.\"
+.\" Copyright (C) Daniel Stenberg
+.\" SPDX-License-Identifier: MIT
+.so man3/ares_dns_mapping.3
diff --git a/subprojects/c-ares/docs/ares_dns_rec_type_fromstr.3 b/subprojects/c-ares/docs/ares_dns_rec_type_fromstr.3
@@ -0,0 +1,4 @@
+.\"
+.\" Copyright (C) Daniel Stenberg
+.\" SPDX-License-Identifier: MIT
+.so man3/ares_dns_mapping.3
diff --git a/subprojects/c-ares/docs/ares_dns_rec_type_t.3 b/subprojects/c-ares/docs/ares_dns_rec_type_t.3
@@ -0,0 +1,3 @@
+.\" Copyright (C) 2023 The c-ares project and its contributors.
+.\" SPDX-License-Identifier: MIT
+.so man3/ares_dns_record.3
diff --git a/subprojects/c-ares/docs/ares_dns_rec_type_tostr.3 b/subprojects/c-ares/docs/ares_dns_rec_type_tostr.3
@@ -0,0 +1,4 @@
+.\"
+.\" Copyright (C) Daniel Stenberg
+.\" SPDX-License-Identifier: MIT
+.so man3/ares_dns_mapping.3
diff --git a/subprojects/c-ares/docs/ares_dns_record.3 b/subprojects/c-ares/docs/ares_dns_record.3
@@ -0,0 +1,380 @@
+.\" Copyright (C) 2023 The c-ares project and its contributors.
+.\" SPDX-License-Identifier: MIT
+.\"
+.TH ARES_DNS_RECORD 3 "12 November 2023"
+.SH NAME
+ares_dns_class_t, ares_dns_flags_t, ares_dns_opcode_t, ares_dns_parse,
+ares_dns_rcode_t, ares_dns_record_create, ares_dns_record_destroy,
+ares_dns_record_get_flags, ares_dns_record_get_id, ares_dns_record_get_opcode,
+ares_dns_record_get_rcode, ares_dns_record_query_add, ares_dns_record_query_cnt,
+ares_dns_record_query_get, ares_dns_rec_type_t, ares_dns_write \-
+DNS Record parsing, writing, creating and destroying functions.
+.SH SYNOPSIS
+.nf
+#include <ares.h>
+
+void ares_dns_record_destroy(ares_dns_record_t *dnsrec);
+
+ares_status_t ares_dns_parse(const unsigned char *buf,
+ size_t buf_len, unsigned int flags,
+ ares_dns_record_t **dnsrec);
+
+ares_status_t ares_dns_write(ares_dns_record_t *dnsrec,
+ unsigned char **buf, size_t *buf_len);
+
+ares_status_t ares_dns_record_create(ares_dns_record_t **dnsrec,
+ unsigned short id,
+ unsigned short flags,
+ ares_dns_opcode_t opcode,
+ ares_dns_rcode_t rcode);
+
+unsigned short ares_dns_record_get_id(const ares_dns_record_t *dnsrec);
+
+unsigned short ares_dns_record_get_flags(const ares_dns_record_t *dnsrec);
+
+ares_dns_opcode_t ares_dns_record_get_opcode(const ares_dns_record_t *dnsrec);
+
+ares_dns_rcode_t ares_dns_record_get_rcode(const ares_dns_record_t *dnsrec);
+
+ares_status_t ares_dns_record_query_add(ares_dns_record_t *dnsrec,
+ const char *name,
+ ares_dns_rec_type_t qtype,
+ ares_dns_class_t qclass);
+
+size_t ares_dns_record_query_cnt(const ares_dns_record_t *dnsrec);
+
+ares_status_t ares_dns_record_query_get(const ares_dns_record_t *dnsrec,
+ size_t idx, const char **name,
+ ares_dns_rec_type_t *qtype,
+ ares_dns_class_t *qclass);
+
+.fi
+.SH ENUMERATIONS
+
+.B ares_dns_rec_type_t -
+DNS Record types handled by c-ares. Some record types may only be valid
+on requests, and some may only be valid on responses:
+.RS 4
+.B ARES_REC_TYPE_A
+- Host address
+.br
+.B ARES_REC_TYPE_NS
+- Authoritative server
+.br
+.B ARES_REC_TYPE_CNAME
+- Canonical name
+.br
+.B ARES_REC_TYPE_SOA
+- Start of authority zone
+.br
+.B ARES_REC_TYPE_PTR
+- Domain name pointer
+.br
+.B ARES_REC_TYPE_HINFO
+- Host information
+.br
+.B ARES_REC_TYPE_MX
+- Mail routing information
+.br
+.B ARES_REC_TYPE_TXT
+- Text strings
+.br
+.B ARES_REC_TYPE_AAAA
+- RFC 3596. Ip6 Address
+.br
+.B ARES_REC_TYPE_SRV
+- RFC 2782. Server Selection
+.br
+.B ARES_REC_TYPE_NAPTR
+- RFC 3403. Naming Authority Pointer
+.br
+.B ARES_REC_TYPE_OPT
+- RFC 6891. EDNS0 option (meta-RR). Pseudo Record.
+.br
+.B ARES_REC_TYPE_TLSA
+- RFC 6698. DNS-Based Authentication of Named Entities (DANE) Transport Layer Security (TLS) Protocol: TLSA
+.br
+.B ARES_REC_TYPE_SVCB
+- RFC 9460. General Purpose Service Binding
+.br
+.B ARES_REC_TYPE_HTTPS -
+- RFC 9460. Service Binding type for use with HTTPS
+.br
+.B ARES_REC_TYPE_ANY
+- Wildcard match. Not response RR
+.br
+.B ARES_REC_TYPE_URI
+- RFC 7553. Uniform Resource Identifier
+.br
+.B ARES_REC_TYPE_CAA
+- RFC 6844. Certification Authority Authorization
+.br
+.B ARES_REC_TYPE_RAW_RR
+- Used as an indicator that the RR record is not parsed, but provided in wire
+format
+.br
+.RE
+
+.B ares_dns_class_t -
+DNS Classes for requests and responses:
+.RS 4
+.B ARES_CLASS_IN
+- Internet
+.br
+.B ARES_CLASS_CHAOS
+- CHAOS
+.br
+.B ARES_CLASS_HESOID
+- Hesoid [Dyer 87]
+.br
+.B ARES_CLASS_NONE
+- RFC 2136
+.br
+.B ARES_CLASS_ANY
+- Any class (requests only)
+.br
+.RE
+
+.B ares_dns_opcode_t -
+DNS Header Opcodes:
+.RS 4
+.B ARES_OPCODE_QUERY
+- Standard query
+.br
+.B ARES_OPCODE_IQUERY
+- Inverse query. Obsolete
+.br
+.B ARES_OPCODE_STATUS
+- Name server status query
+.br
+.B ARES_OPCODE_NOTIFY
+- Zone change notification (RFC 1996)
+.br
+.B ARES_OPCODE_UPDATE
+- Zone update message (RFC2136)
+.br
+.RE
+
+.B ares_dns_flags_t -
+DNS Header Flags:
+.RS 4
+.B ARES_FLAG_QR
+- QR. If set, is a response
+.br
+.B ARES_FLAG_AA
+- Authoritative Answer. If set, is authoritative
+.br
+.B ARES_FLAG_TC
+- Truncation. If set, is truncated response
+.br
+.B ARES_FLAG_RD
+- Recursion Desired. If set, recursion is desired
+.br
+.B ARES_FLAG_RA
+- Recursion Available. If set, server supports recursion
+.br
+.B ARES_FLAG_AD
+- RFC 2065. Authentic Data bit indicates in a response that the data included
+has been verified by the server providing it
+.br
+.B ARES_FLAG_CD
+- RFC 2065. Checking Disabled bit indicates in a query that non-verified data
+is acceptable to the resolver sending the query
+.br
+.RE
+
+.B ares_dns_rcode_t -
+DNS Response codes from server:
+.RS 4
+.B ARES_RCODE_NOERROR
+- Success
+.br
+.B ARES_RCODE_FORMERR
+- Format error. The name server was unable to interpret the query
+.br
+.B ARES_RCODE_SERVFAIL
+- Server Failure. The name server was unable to process this query due to a
+problem with the nameserver
+.br
+.B ARES_RCODE_NXDOMAIN
+- Name Error. Meaningful only for responses from an authoritative name server,
+this code signifies that the domain name referenced in the query does not exist.
+.br
+.B ARES_RCODE_NOTIMP
+- Not implemented. The name server does not support the requested kind of query
+.br
+.B ARES_RCODE_REFUSED
+- Refused. The name server refuses to perform the specified operation for policy
+reasons.
+.br
+.B ARES_RCODE_YXDOMAIN
+- RFC 2136. Some name that ought not to exist, does exist
+.br
+.B ARES_RCODE_YXRRSET
+- RFC 2136. Some RRset that ought to not exist, does exist
+.br
+.B ARES_RCODE_NXRRSET
+- RFC 2136. Some RRset that ought to exist, does not exist
+.br
+.B ARES_RCODE_NOTAUTH
+- RFC 2136. The server is not authoritative for the zone named in the Zone section.
+.br
+.B ARES_RCODE_NOTZONE
+- RFC 2136. A name used in the Prerequisite or Update Section is not within the
+zone denoted by the Zone Section.
+.br
+.B ARES_RCODE_DSOTYPEI
+- RFC 8409. DSO-TYPE Not implemented
+.br
+.B ARES_RCODE_BADSIG
+- RFC 8945. TSIG Signature Failure
+.br
+.B ARES_RCODE_BADKEY
+- RFC 8945. Key not recognized
+.br
+.B ARES_RCODE_BADTIME
+- RFC 8945. Signature out of time window
+.br
+.B ARES_RCODE_BADMODE
+- RFC 2930. Bad TKEY Mode
+.br
+.B ARES_RCODE_BADNAME
+- RFC 2930. Duplicate Key Name
+.br
+.B ARES_RCODE_BADALG
+- RFC 2930. Algorithm not supported
+.br
+.B ARES_RCODE_BADTRUNC
+- RFC 8945. Bad Truncation
+.br
+.B ARES_RCODE_BADCOOKIE
+- RFC 7973. Bad/missing Server Cookie
+.br
+.RE
+
+
+.SH DESCRIPTION
+
+The \fIares_dns_record_destroy(3)\fP function destroys the memory associated
+with the dns record created by either \fIares_dns_record_create(3)\fP or
+\fIares_dns_parse(3)\fP passed in via
+.IR dnsrec .
+
+The \fIares_dns_parse(3)\fP function parses the buffer provided in
+.IR buf
+with length provided in
+.IR buf_len.
+The
+.IR flags
+parameter can be one or more \fIares_dns_parse_flags_t\fP, or zero if no
+flags are needed. The resulting dns record data structure is stored into the
+variable pointed to by
+.IR dnsrec
+and must be destroyed using \fIares_dns_record_destroy(3)\fP.
+
+The \fIares_dns_write(3)\fP function takes a populated DNS record structure in
+.IR dnsrec
+and writes a wire-format DNS message into the variable pointed to by
+.IR buf
+and writes the length of the buffer into the variable pointed to by
+.IR buf_len.
+The buffer must be destroyed using \fIares_free_string(3)\fP.
+
+The \fIares_dns_record_create(3)\fP function creates an empty DNS record structure
+in the variable pointed to by
+.IR dnsrec.
+The
+.IR id
+parameter is the DNS message id, however if passing to \fIares_send(3)\fP this
+identifier will be overwritten, so should typically be 0. The
+.IR flags
+parameter is one or more \fIares_dns_flags_t\fP. The opcode is passed in the
+.IR opcode
+parameter and should typically be \fIARES_OPCODE_QUERY\fP. The response code
+is meant mostly for responses and is passed in the
+.IR rcode
+parameter and is typically \fPARES_RCODE_NOERROR\fP.
+
+
+The \fIares_dns_record_get_id(3)\fP function is used to retrieve the DNS
+message id from the DNS record provided in the
+.IR dnsrec
+parameter.
+
+The \fIares_dns_record_get_flags(3)\fP function is used to retrieve the DNS
+message flags from the DNS record provided in the
+.IR dnsrec
+parameter.
+
+The \fIares_dns_record_get_opcode(3)\fP function is used to retrieve the DNS
+message flags from the DNS record provided in the
+.IR dnsrec
+parameter.
+
+The \fIares_dns_record_get_rcode(3)\fP function is used to retrieve the DNS
+message response code from the DNS record provided in the
+.IR dnsrec
+parameter.
+
+
+The \fIares_dns_record_query_add(3)\fP function is used to add a question to
+the DNS record provided in the
+.IR dnsrec
+parameter. The domain name specified for the question is provided in the
+.IR name
+parameter, along with the question type in the
+.IR qtype
+parameter and the question class (typically \fIARES_CLASS_IN\fP) in the
+.IR qclass
+parameter.
+
+The \fIares_dns_record_query_cnt(3)\fP function is used to retrieve the number
+of DNS questions in the DNS record provided in the
+.IR dnsrec
+parameter.
+
+The \fIares_dns_record_query_get(3)\fP function is used to retrieve the details
+of a single DNS question in the provided
+.IR dnsrec
+parameter. The index provided in the
+.IR idx
+parameter must be less than the value returned from \fIares_dns_record_query_cnt(3)\fP.
+The DNS question name will be returned in the variable pointed to by the
+.IR name
+parameter, this may be provided as NULL if the name is not needed.
+The DNS question type will be returned in the variable pointed to by the
+.IR qtype
+parameter, this may be provided as NULL if the type is not needed.
+The DNS question class will be returned in the variable pointed to by the
+.IR qclass
+parameter, this may be provided as NULL if the class is not needed.
+
+
+.SH RETURN VALUES
+
+\fIares_dns_parse(3)\fP, \fIares_dns_write(3)\fP, \fIares_dns_record_create(3)\fP,
+\fIares_dns_record_query_add(3)\fP, and \fIares_dns_record_query_get(3)\fP all
+return an \fIares_status_t\fP error code.
+.B ARES_SUCCESS
+is returned on success,
+.B ARES_ENOMEM
+is returned on out of memory,
+.B ARES_EFORMERR
+is returned on misuse.
+
+\fIares_dns_record_get_id(3)\fP, \fIares_dns_record_get_flags(3)\fP,
+\fIares_dns_record_get_opcode(3)\fP, \fIares_dns_record_get_rcode(3)\fP, and
+\fIares_dns_record_query_cnt(3)\fP all returned their prescribed datatype
+values and in general can't fail except for misuse cases, in which a 0 may
+be returned, however 0 can also be a valid return value for most of these
+functions.
+
+
+.SH AVAILABILITY
+These functions were first introduced in c-ares version 1.22.0.
+.SH SEE ALSO
+.BR ares_dns_mapping (3),
+.BR ares_dns_rr (3),
+.BR ares_free_string (3)
+.SH AUTHOR
+Copyright (C) 2023 The c-ares project and its members.
diff --git a/subprojects/c-ares/docs/ares_dns_record_create.3 b/subprojects/c-ares/docs/ares_dns_record_create.3
@@ -0,0 +1,3 @@
+.\" Copyright (C) 2023 The c-ares project and its contributors.
+.\" SPDX-License-Identifier: MIT
+.so man3/ares_dns_record.3
diff --git a/subprojects/c-ares/docs/ares_dns_record_destroy.3 b/subprojects/c-ares/docs/ares_dns_record_destroy.3
@@ -0,0 +1,3 @@
+.\" Copyright (C) 2023 The c-ares project and its contributors.
+.\" SPDX-License-Identifier: MIT
+.so man3/ares_dns_record.3
diff --git a/subprojects/c-ares/docs/ares_dns_record_get_flags.3 b/subprojects/c-ares/docs/ares_dns_record_get_flags.3
@@ -0,0 +1,3 @@
+.\" Copyright (C) 2023 The c-ares project and its contributors.
+.\" SPDX-License-Identifier: MIT
+.so man3/ares_dns_record.3
diff --git a/subprojects/c-ares/docs/ares_dns_record_get_id.3 b/subprojects/c-ares/docs/ares_dns_record_get_id.3
@@ -0,0 +1,3 @@
+.\" Copyright (C) 2023 The c-ares project and its contributors.
+.\" SPDX-License-Identifier: MIT
+.so man3/ares_dns_record.3
diff --git a/subprojects/c-ares/docs/ares_dns_record_get_opcode.3 b/subprojects/c-ares/docs/ares_dns_record_get_opcode.3
@@ -0,0 +1,3 @@
+.\" Copyright (C) 2023 The c-ares project and its contributors.
+.\" SPDX-License-Identifier: MIT
+.so man3/ares_dns_record.3
diff --git a/subprojects/c-ares/docs/ares_dns_record_get_rcode.3 b/subprojects/c-ares/docs/ares_dns_record_get_rcode.3
@@ -0,0 +1,3 @@
+.\" Copyright (C) 2023 The c-ares project and its contributors.
+.\" SPDX-License-Identifier: MIT
+.so man3/ares_dns_record.3
diff --git a/subprojects/c-ares/docs/ares_dns_record_query_add.3 b/subprojects/c-ares/docs/ares_dns_record_query_add.3
@@ -0,0 +1,3 @@
+.\" Copyright (C) 2023 The c-ares project and its contributors.
+.\" SPDX-License-Identifier: MIT
+.so man3/ares_dns_record.3
diff --git a/subprojects/c-ares/docs/ares_dns_record_query_cnt.3 b/subprojects/c-ares/docs/ares_dns_record_query_cnt.3
@@ -0,0 +1,3 @@
+.\" Copyright (C) 2023 The c-ares project and its contributors.
+.\" SPDX-License-Identifier: MIT
+.so man3/ares_dns_record.3
diff --git a/subprojects/c-ares/docs/ares_dns_record_query_get.3 b/subprojects/c-ares/docs/ares_dns_record_query_get.3
@@ -0,0 +1,3 @@
+.\" Copyright (C) 2023 The c-ares project and its contributors.
+.\" SPDX-License-Identifier: MIT
+.so man3/ares_dns_record.3
diff --git a/subprojects/c-ares/docs/ares_dns_record_rr_add.3 b/subprojects/c-ares/docs/ares_dns_record_rr_add.3
@@ -0,0 +1,3 @@
+.\" Copyright (C) 2023 The c-ares project and its contributors.
+.\" SPDX-License-Identifier: MIT
+.so man3/ares_dns_rr.3
diff --git a/subprojects/c-ares/docs/ares_dns_record_rr_cnt.3 b/subprojects/c-ares/docs/ares_dns_record_rr_cnt.3
@@ -0,0 +1,3 @@
+.\" Copyright (C) 2023 The c-ares project and its contributors.
+.\" SPDX-License-Identifier: MIT
+.so man3/ares_dns_rr.3
diff --git a/subprojects/c-ares/docs/ares_dns_record_rr_del.3 b/subprojects/c-ares/docs/ares_dns_record_rr_del.3
@@ -0,0 +1,3 @@
+.\" Copyright (C) 2023 The c-ares project and its contributors.
+.\" SPDX-License-Identifier: MIT
+.so man3/ares_dns_rr.3
diff --git a/subprojects/c-ares/docs/ares_dns_record_rr_get.3 b/subprojects/c-ares/docs/ares_dns_record_rr_get.3
@@ -0,0 +1,3 @@
+.\" Copyright (C) 2023 The c-ares project and its contributors.
+.\" SPDX-License-Identifier: MIT
+.so man3/ares_dns_rr.3
diff --git a/subprojects/c-ares/docs/ares_dns_rr.3 b/subprojects/c-ares/docs/ares_dns_rr.3
@@ -0,0 +1,631 @@
+.\" Copyright (C) 2023 The c-ares project and its contributors.
+.\" SPDX-License-Identifier: MIT
+.\"
+.TH ARES_DNS_RR 3 "12 November 2023"
+.SH NAME
+ares_dns_record_rr_add, ares_dns_record_rr_cnt, ares_dns_record_rr_del,
+ares_dns_record_rr_get, ares_dns_rr_get_addr, ares_dns_rr_get_addr6,
+ares_dns_rr_get_bin, ares_dns_rr_get_class, ares_dns_rr_get_name,
+ares_dns_rr_get_opt, ares_dns_rr_get_opt_byid, ares_dns_rr_get_opt_cnt,
+ares_dns_rr_get_str, ares_dns_rr_get_ttl, ares_dns_rr_get_type,
+ares_dns_rr_get_u16, ares_dns_rr_get_u32, ares_dns_rr_get_u8, ares_dns_rr_key_t,
+ares_dns_rr_set_addr, ares_dns_rr_set_addr6, ares_dns_rr_set_bin,
+ares_dns_rr_set_opt, ares_dns_rr_set_str, ares_dns_rr_set_u16,
+ares_dns_rr_set_u32, ares_dns_rr_set_u8, ares_dns_section_t, ares_tlsa_match_t,
+ares_tlsa_selector_t, ares_tlsa_usage_t \-
+DNS Resource Record creating, reading, and writing functions.
+.SH SYNOPSIS
+.nf
+#include <ares.h>
+
+size_t ares_dns_record_rr_cnt(const ares_dns_record_t *dnsrec,
+ ares_dns_section_t sect);
+
+ares_status_t ares_dns_record_rr_add(ares_dns_rr_t **rr_out,
+ ares_dns_record_t *dnsrec,
+ ares_dns_section_t sect,
+ const char *name,
+ ares_dns_rec_type_t type,
+ ares_dns_class_t rclass,
+ unsigned int ttl);
+
+ares_dns_rr_t *ares_dns_record_rr_get(ares_dns_record_t *dnsrec,
+ ares_dns_section_t sect,
+ size_t idx);
+
+ares_status_t ares_dns_record_rr_del(ares_dns_record_t *dnsrec,
+ ares_dns_section_t sect,
+ size_t idx);
+
+const char *ares_dns_rr_get_name(const ares_dns_rr_t *rr);
+
+ares_dns_rec_type_t ares_dns_rr_get_type(const ares_dns_rr_t *rr);
+
+ares_dns_class_t ares_dns_rr_get_class(const ares_dns_rr_t *rr);
+
+unsigned int ares_dns_rr_get_ttl(const ares_dns_rr_t *rr);
+
+ares_status_t ares_dns_rr_set_addr(ares_dns_rr_t *dns_rr,
+ ares_dns_rr_key_t key,
+ const struct in_addr *addr);
+
+ares_status_t ares_dns_rr_set_addr6(ares_dns_rr_t *dns_rr,
+ ares_dns_rr_key_t key,
+ const struct ares_in6_addr *addr);
+
+ares_status_t ares_dns_rr_set_str(ares_dns_rr_t *dns_rr,
+ ares_dns_rr_key_t key,
+ const char *val);
+
+ares_status_t ares_dns_rr_set_u8(ares_dns_rr_t *dns_rr,
+ ares_dns_rr_key_t key,
+ unsigned char val);
+
+ares_status_t ares_dns_rr_set_u16(ares_dns_rr_t *dns_rr,
+ ares_dns_rr_key_t key,
+ unsigned short val);
+
+ares_status_t ares_dns_rr_set_u32(ares_dns_rr_t *dns_rr,
+ ares_dns_rr_key_t key,
+ unsigned int val);
+
+ares_status_t ares_dns_rr_set_bin(ares_dns_rr_t *dns_rr,
+ ares_dns_rr_key_t key,
+ const unsigned char *val,
+ size_t len);
+
+ares_status_t ares_dns_rr_set_opt(ares_dns_rr_t *dns_rr,
+ ares_dns_rr_key_t key,
+ unsigned short opt,
+ const unsigned char *val,
+ size_t val_len);
+
+const struct in_addr *ares_dns_rr_get_addr(const ares_dns_rr_t *dns_rr,
+ ares_dns_rr_key_t key);
+
+const struct ares_in6_addr *ares_dns_rr_get_addr6(const ares_dns_rr_t *dns_rr,
+ ares_dns_rr_key_t key);
+
+const char *ares_dns_rr_get_str(const ares_dns_rr_t *dns_rr,
+ ares_dns_rr_key_t key);
+
+unsigned char ares_dns_rr_get_u8(const ares_dns_rr_t *dns_rr,
+ ares_dns_rr_key_t key);
+
+unsigned short ares_dns_rr_get_u16(const ares_dns_rr_t *dns_rr,
+ ares_dns_rr_key_t key);
+
+unsigned int ares_dns_rr_get_u32(const ares_dns_rr_t *dns_rr,
+ ares_dns_rr_key_t key);
+
+const unsigned char *ares_dns_rr_get_bin(const ares_dns_rr_t *dns_rr,
+ ares_dns_rr_key_t key,
+ size_t *len);
+
+size_t ares_dns_rr_get_opt_cnt(const ares_dns_rr_t *dns_rr,
+ ares_dns_rr_key_t key);
+
+unsigned short ares_dns_rr_get_opt(const ares_dns_rr_t *dns_rr,
+ ares_dns_rr_key_t key,
+ size_t idx,
+ const unsigned char **val,
+ size_t *val_len);
+
+ares_bool_t ares_dns_rr_get_opt_byid(const ares_dns_rr_t *dns_rr,
+ ares_dns_rr_key_t key,
+ unsigned short opt,
+ const unsigned char **val,
+ size_t *val_len);
+
+.fi
+.SH ENUMERATIONS
+
+.B ares_dns_section_t -
+DNS RR section types:
+.RS 4
+.B ARES_SECTION_ANSWER
+- Answer section
+.br
+.B ARES_SECTION_AUTHORITY
+- Authority section
+.br
+.B ARES_SECTION_ADDITIONAL
+- Additional Information section
+.br
+.RE
+
+.B ares_dns_rr_key_t -
+Keys used for handling RR record parameters:
+.RS 4
+.B ARES_RR_A_ADDR
+- A Record. Address. Datatype: \fIARES_DATATYPE_INADDR\fP
+.br
+.B ARES_RR_NS_NSDNAME
+- NS Record. Name. Datatype: \fIARES_DATATYPE_NAME\fP
+.br
+.B ARES_RR_CNAME_CNAME
+- CNAME Record. CName. Datatype: \fIARES_DATATYPE_NAME\fP
+.br
+.B ARES_RR_SOA_MNAME
+- SOA Record. MNAME, Primary Source of Data. Datatype: \fIARES_DATATYPE_NAME\fP
+.br
+.B ARES_RR_SOA_RNAME
+- SOA Record. RNAME, Mailbox of person responsible. Datatype: \fIARES_DATATYPE_NAME\fP
+.br
+.B ARES_RR_SOA_SERIAL
+- SOA Record. Serial, version. Datatype: \fIARES_DATATYPE_U32\fP
+.br
+.B ARES_RR_SOA_REFRESH
+- SOA Record. Refresh, zone refersh interval. Datatype: \fIARES_DATATYPE_U32\fP
+.br
+.B ARES_RR_SOA_RETRY
+- SOA Record. Retry, failed refresh retry interval. Datatype: \fIARES_DATATYPE_U32\fP
+.br
+.B ARES_RR_SOA_EXPIRE
+- SOA Record. Expire, upper limit on authority. Datatype: \fIARES_DATATYPE_U32\fP
+.br
+.B ARES_RR_SOA_MINIMUM
+- SOA Record. Minimum, RR TTL. Datatype: \fIARES_DATATYPE_U32\fP
+.br
+.B ARES_RR_PTR_DNAME
+- PTR Record. DNAME, pointer domain. Datatype: \fIARES_DATATYPE_NAME\fP
+.br
+.B ARES_RR_HINFO_CPU
+- HINFO Record. CPU. Datatype: \fIARES_DATATYPE_STR\fP
+.br
+.B ARES_RR_HINFO_OS
+- HINFO Record. OS. Datatype: \fIARES_DATATYPE_STR\fP
+.br
+.B ARES_RR_MX_PREFERENCE
+- MX Record. Preference. Datatype: \fIARES_DATATYPE_U16\fP
+.br
+.B ARES_RR_MX_EXCHANGE
+- MX Record. Exchange, domain. Datatype: \fIARES_DATATYPE_NAME\fP
+.br
+.B ARES_RR_TXT_DATA
+- TXT Record. Data. Datatype: \fIARES_DATATYPE_BINP\fP
+.br
+.B ARES_RR_AAAA_ADDR
+- AAAA Record. Address. Datatype: \fIARES_DATATYPE_INADDR6\fP
+.br
+.B ARES_RR_SRV_PRIORITY
+- SRV Record. Priority. Datatype: \fIARES_DATATYPE_U16\fP
+.br
+.B ARES_RR_SRV_WEIGHT
+- SRV Record. Weight. Datatype: \fIARES_DATATYPE_U16\fP
+.br
+.B ARES_RR_SRV_PORT
+- SRV Record. Port. Datatype: \fIARES_DATATYPE_U16\fP
+.br
+.B ARES_RR_SRV_TARGET
+- SRV Record. Target domain. Datatype: \fIARES_DATATYPE_NAME\fP
+.br
+.B ARES_RR_NAPTR_ORDER
+- NAPTR Record. Order. Datatype: \fIARES_DATATYPE_U16\fP
+.br
+.B ARES_RR_NAPTR_PREFERENCE
+- NAPTR Record. Preference. Datatype: \fIARES_DATATYPE_U16\fP
+.br
+.B ARES_RR_NAPTR_FLAGS
+- NAPTR Record. Flags. Datatype: \fIARES_DATATYPE_STR\fP
+.br
+.B ARES_RR_NAPTR_SERVICES
+- NAPTR Record. Services. Datatype: \fIARES_DATATYPE_STR\fP
+.br
+.B ARES_RR_NAPTR_REGEXP
+- NAPTR Record. Regexp. Datatype: \fIARES_DATATYPE_STR\fP
+.br
+.B ARES_RR_NAPTR_REPLACEMENT
+- NAPTR Record. Replacement. Datatype: \fIARES_DATATYPE_NAME\fP
+.br
+.B ARES_RR_OPT_UDP_SIZE
+- OPT Record. UDP Size. Datatype: \fIARES_DATATYPE_U16\fP
+.br
+.B ARES_RR_OPT_VERSION
+- OPT Record. Version. Datatype: \fIARES_DATATYPE_U8\fP
+.br
+.B ARES_RR_OPT_FLAGS
+- OPT Record. Flags. Datatype: \fIARES_DATATYPE_U16\fP
+.br
+.B ARES_RR_OPT_OPTIONS
+- OPT Record. Options. See \fIares_opt_param_t\fP. Datatype: \fIARES_DATATYPE_OPT\fP
+.br
+.B ARES_RR_TLSA_CERT_USAGE
+- TLSA Record. Certificate Usage. See \fIares_tlsa_usage_t\fP. Datatype: \fIARES_DATATYPE_U8\fP
+.br
+.B ARES_RR_TLSA_SELECTOR
+- TLSA Record. Selector. See \fIares_tlsa_selector_t\fP. Datatype: \fIARES_DATATYPE_U8\fP
+.br
+.B ARES_RR_TLSA_MATCH
+- TLSA Record. Matching Type. See \fIares_tlsa_match_t\fP. Datatype: \fIARES_DATATYPE_U8\fP
+.br
+.B ARES_RR_TLSA_DATA
+- TLSA Record. Certificate Association Data. Datatype: \fIARES_DATATYPE_BIN\fP
+.br
+.B ARES_RR_SVCB_PRIORITY
+- SVCB Record. SvcPriority. Datatype: \fIARES_DATATYPE_U16\fP
+.br
+.B ARES_RR_SVCB_TARGET
+- SVCB Record. TargetName. Datatype: \fIARES_DATATYPE_NAME\fP
+.br
+.B ARES_RR_SVCB_PARAMS
+- SVCB Record. SvcParams. See \fIares_svcb_param_t\fP. Datatype: \fIARES_DATATYPE_OPT\fP
+.br
+.B ARES_RR_HTTPS_PRIORITY
+- HTTPS Record. SvcPriority. Datatype: \fIARES_DATATYPE_U16\fP
+.br
+.B ARES_RR_HTTPS_TARGET
+- HTTPS Record. TargetName. Datatype: \fIARES_DATATYPE_NAME\fP
+.br
+.B ARES_RR_HTTPS_PARAMS
+- HTTPS Record. SvcParams. See \fIares_svcb_param_t\fP. Datatype: \fIARES_DATATYPE_OPT\fP
+.br
+.B ARES_RR_URI_PRIORITY
+- URI Record. Priority. Datatype: \fIARES_DATATYPE_U16\fP
+.br
+.B ARES_RR_URI_WEIGHT
+- URI Record. Weight. Datatype: \fIARES_DATATYPE_U16\fP
+.br
+.B ARES_RR_URI_TARGET
+- URI Record. Target domain. Datatype: \fIARES_DATATYPE_NAME\fP
+.br
+.B ARES_RR_CAA_CRITICAL
+- CAA Record. Critical flag. Datatype: \fIARES_DATATYPE_U8\fP
+.br
+.B ARES_RR_CAA_TAG
+- CAA Record. Tag/Property. Datatype: \fIARES_DATATYPE_STR\fP
+.br
+.B ARES_RR_CAA_VALUE
+- CAA Record. Value. Datatype: \fIARES_DATATYPE_BINP\fP
+.br
+.B ARES_RR_RAW_RR_TYPE
+- RAW Record. RR Type. Datatype: \fIARES_DATATYPE_U16\fP
+.br
+.B ARES_RR_RAW_RR_DATA
+- RAW Record. RR Data. Datatype: \fIARES_DATATYPE_BIN\fP
+.br
+.RE
+
+.B ares_tlsa_usage_t -
+TLSA Record \fIARES_RR_TLSA_CERT_USAGE\fP known values
+.RS 4
+.B ARES_TLSA_USAGE_CA
+- Certificate Usage 0. CA Constraint
+.br
+.B ARES_TLSA_USAGE_SERVICE
+- Certificate Usage 1. Service Certificate Constraint
+.br
+.B ARES_TLSA_USAGE_TRUSTANCHOR
+- Certificate Usage 2. Trust Anchor Assertion
+.br
+.B ARES_TLSA_USAGE_DOMAIN
+- Certificate Usage 3. Domain-issued certificate
+.br
+.RE
+
+.B ares_tlsa_selector_t -
+TLSA Record \fIARES_RR_TLSA_SELECTOR\fP known values:
+.RS 4
+.B ARES_TLSA_SELECTOR_FULL
+- Full Certificate
+.br
+.B ARES_TLSA_SELECTOR_SUBJPUBKEYINFO
+- DER-encoded SubjectPublicKeyInfo
+.br
+.RE
+
+.B ares_tlsa_match_t -
+TLSA Record \fIARES_RR_TLSA_MATCH\fP known values:
+.RS 4
+.B ARES_TLSA_MATCH_EXACT
+- Exact match
+.br
+.B ARES_TLSA_MATCH_SHA256
+- Sha256 match
+.br
+.B ARES_TLSA_MATCH_SHA512
+- Sha512 match
+.br
+.RE
+
+
+.SH DESCRIPTION
+
+The \fIares_dns_record_rr_cnt(3)\fP function returns the number of resource
+records in the DNS record provided by the
+.IR dnsrec
+parameter for the section provided in the
+.IR sect
+parameter.
+
+The \fIares_dns_record_rr_add(3)\fP function adds a new resource record entry
+the the DNS record provided by the
+.IR dnsrec
+parameter. The resulting resource record is stored into the variable pointed to by
+.IR rr_out.
+The DNS section the resource record belongs to is specified by the
+.IR sect
+parameter. The domain name associated with the resource record is specified by the
+.IR name
+parameter, which can not be NULL but may be an empty string, or ".". The resource
+record type is specified in the
+.IR type
+parameter, along with the DNS record class in the
+.IR rclass
+parameter, and the Time To Live (TTL) in the
+.IR ttl
+parameter.
+
+
+The \fIares_dns_record_rr_get(3)\fP function is used to retrieve the resource
+record pointer from the DNS record provided in the
+.IR dnsrec
+parameter, for the resource record section provided in the
+.IR sect
+parameter, for the specified index in the
+.IR idx
+parameter. The index must be less than \fIares_dns_record_rr_cnt(3)\fP.
+
+
+The \fIares_dns_record_rr_del(3)\fP is used to delete a resource record from
+the DNS record specified in the
+.IR dnsrec
+parameter. Its primary use is to remove a \fIARES_REC_TYPE_OPT\fP record when
+needing to retry a query without EDNS support. The DNS RR section is specified
+via the
+.IR sect
+parameter, and the index to remove is specified in the
+.IR idx
+parameter. The index must be less than \fIares_dns_record_rr_cnt(3)\fP.
+
+
+The \fIares_dns_rr_get_name(3)\fP function is used to retrieve the resource
+record domain name from the Resource Record pointer provided in the
+.IR rr
+parameter.
+
+The \fIares_dns_rr_get_type(3)\fP function is used to retrieve the resource
+record type from the Resource Record pointer provided in the
+.IR rr
+parameter.
+
+The \fIares_dns_rr_get_class(3)\fP function is used to retrieve the resource
+record class from the Resource Record pointer provided in the
+.IR rr
+parameter.
+
+The \fIares_dns_rr_get_ttl(3)\fP function is used to retrieve the resource
+record class Time to Live (TTL) from the Resource Record pointer provided in the
+.IR rr
+parameter.
+
+The \fIares_dns_rr_set_addr(3)\fP function is used to set an IPv4 address for the
+associated resource record key/parameter when the datatype is \fIARES_DATATYPE_INADDR\fP.
+The resource record to be modified is provided in the
+.IR dns_rr
+parameter, the key/parameter is provided in the
+.IR key
+parameter, and the value is provided in the
+.IR addr
+parameter.
+
+The \fIares_dns_rr_set_addr6(3)\fP function is used to set an IPv6 address for the
+associated resource record key/parameter when the datatype is \fIARES_DATATYPE_INADDR6\fP.
+The resource record to be modified is provided in the
+.IR dns_rr
+parameter, the key/parameter is provided in the
+.IR key
+parameter, and the value is provided in the
+.IR addr
+parameter.
+
+The \fIares_dns_rr_set_str(3)\fP function is used to set a string for the
+associated resource record key/parameter when the datatype is \fIARES_DATATYPE_STR\fP
+or \fIARES_DATATYPE_NAME\fP. Most strings are limited to 255 bytes,
+however some records, such as a TXT record may allow longer as they are output
+as multiple strings. The resource record to be modified is
+provided in the
+.IR dns_rr
+parameter, the key/parameter is provided in the
+.IR key
+parameter, and the value is provided in the
+.IR val
+parameter.
+
+The \fIares_dns_rr_set_u8(3)\fP function is used to set an 8bit unsigned value for the
+associated resource record key/parameter when the datatype is \fIARES_DATATYPE_U8\fP.
+The resource record to be modified is provided in the
+.IR dns_rr
+parameter, the key/parameter is provided in the
+.IR key
+parameter, and the value is provided in the
+.IR val
+parameter.
+
+The \fIares_dns_rr_set_u16(3)\fP function is used to set an 16bit unsigned value for the
+associated resource record key/parameter when the datatype is \fIARES_DATATYPE_U16\fP.
+The resource record to be modified is provided in the
+.IR dns_rr
+parameter, the key/parameter is provided in the
+.IR key
+parameter, and the value is provided in the
+.IR val
+parameter.
+
+The \fIares_dns_rr_set_u32(3)\fP function is used to set an 32bit unsigned value for the
+associated resource record key/parameter when the datatype is \fIARES_DATATYPE_U32\fP.
+The resource record to be modified is provided in the
+.IR dns_rr
+parameter, the key/parameter is provided in the
+.IR key
+parameter, and the value is provided in the
+.IR val
+parameter.
+
+The \fIares_dns_rr_set_bin(3)\fP function is used to set an binary value for the
+associated resource record key/parameter when the datatype is \fIARES_DATATYPE_BIN\fP
+or \fIARES_DATATYPE_BINP\fP.
+The resource record to be modified is provided in the
+.IR dns_rr
+parameter, the key/parameter is provided in the
+.IR key
+parameter, and the value is provided in the
+.IR val
+parameter. And the associated value length is provided in the
+.IR len
+parameter.
+
+The \fIares_dns_rr_set_opt(3)\fP function is used to set option/parameter keys and
+values for the resource record when the datatype if \fIARES_DATATYPE_OPT\fP. The
+resource record to be modified is provided in the
+.IR dns_rr
+parameter. They key/parameter is provided in the
+.IR key
+parameter. The option/parameter value specific to the resource record is provided
+in the
+.IR opt
+parameter, and this is left to the user to determine the appropriate value to
+use. Some known values may be provided by \fIares_svcb_param_t\fP and \fIares_opt_param_t\fP
+enumerations. The value for the option is always provided in binary form in
+.IR val
+with length provided in
+.IR val_len.
+
+The \fIares_dns_rr_get_addr(3)\fP function is used to retrieve the IPv4 address
+from the resource record when the datatype is \fIARES_DATATYPE_INADDR\fP. The
+resource record is provided in the
+.IR dns_rr
+parameter and the key/parameter to retrieve is provided in the
+.IR key
+parameter.
+
+The \fIares_dns_rr_get_addr6(3)\fP function is used to retrieve the IPv6 address
+from the resource record when the datatype is \fIARES_DATATYPE_INADDR6\fP. The
+resource record is provided in the
+.IR dns_rr
+parameter and the key/parameter to retrieve is provided in the
+.IR key
+parameter.
+
+The \fIares_dns_rr_get_str(3)\fP function is used to retrieve a string
+from the resource record when the datatype is \fIARES_DATATYPE_STR\fP or
+\fIARES_DATATYPE_NAME\fP. The resource record is provided in the
+.IR dns_rr
+parameter and the key/parameter to retrieve is provided in the
+.IR key
+parameter.
+
+The \fIares_dns_rr_get_u8(3)\fP function is used to retrieve an 8bit integer
+from the resource record when the datatype is \fIARES_DATATYPE_U8\fP.
+The resource record is provided in the
+.IR dns_rr
+parameter and the key/parameter to retrieve is provided in the
+.IR key
+parameter.
+
+The \fIares_dns_rr_get_u16(3)\fP function is used to retrieve a 16bit integer
+from the resource record when the datatype is \fIARES_DATATYPE_U16\fP.
+The resource record is provided in the
+.IR dns_rr
+parameter and the key/parameter to retrieve is provided in the
+.IR key
+parameter.
+
+The \fIares_dns_rr_get_u32(3)\fP function is used to retrieve a 32bit integer
+from the resource record when the datatype is \fIARES_DATATYPE_U32\fP.
+The resource record is provided in the
+.IR dns_rr
+parameter and the key/parameter to retrieve is provided in the
+.IR key
+parameter.
+
+The \fIares_dns_rr_get_bin(3)\fP function is used to retrieve binary data
+from the resource record when the datatype is \fIARES_DATATYPE_BIN\fP or
+\fIARES_DATATYPE_BINP\fP.
+The resource record is provided in the
+.IR dns_rr
+parameter and the key/parameter to retrieve is provided in the
+.IR key
+parameter, and length is stored into the variable pointed to by
+.IR len.
+
+The \fIares_dns_rr_get_opt_cnt(3)\fP function is used to retrieve the count
+of options/parameters associated with the resource record when the datatype
+is \fIARES_DATATYPE_OPT\fP.
+The resource record is provided in the
+.IR dns_rr
+parameter and the key/parameter to retrieve is provided in the
+.IR key.
+
+The \fIares_dns_rr_get_opt(3)\fP function is used to retrieve binary option data
+from the resource record when the datatype is \fIARES_DATATYPE_OPT\fP for the
+specified index.
+The resource record is provided in the
+.IR dns_rr
+parameter and the key/parameter to retrieve is provided in the
+.IR key
+parameter, the index to retrieve the option data from is provided in the
+.IR idx
+parameter. The value is stored into the variable pointed to by
+.IR val
+and length is stored into the variable pointed to by
+.IR val_len.
+
+The \fIares_dns_rr_get_opt_byid(3)\fP function is used to retrieve binary option data
+from the resource record when the datatype is \fIARES_DATATYPE_OPT\fP for the
+specified option identifier, if it exists.
+The resource record is provided in the
+.IR dns_rr
+parameter and the key/parameter to retrieve is provided in the
+.IR key
+parameter, the identifier to retrieve the option data from is provided in the
+.IR opt
+parameter. The value is stored into the variable pointed to by
+.IR val
+and length is stored into the variable pointed to by
+.IR val_len.
+
+
+.SH RETURN VALUES
+
+\fIares_dns_record_rr_cnt(3)\fP and \fIares_dns_rr_get_opt_cnt(3)\fP return the
+respective counts.
+
+\fIares_dns_record_rr_add(3)\fP, \fIares_dns_record_rr_del(3)\fP,
+\fIares_dns_rr_set_addr(3)\fP, \fIares_dns_rr_set_addr6(3)\fP,
+\fIares_dns_rr_set_str(3)\fP, \fIares_dns_rr_set_u8(3)\fP,
+\fIares_dns_rr_set_u16(3)\fP, \fIares_dns_rr_set_u32(3)\fP,
+\fIares_dns_rr_set_bin(3)\fP, and \fIares_dns_rr_set_opt(3)\fP all
+return an \fIares_status_t\fP error code.
+.B ARES_SUCCESS
+is returned on success,
+.B ARES_ENOMEM
+is returned on out of memory,
+.B ARES_EFORMERR
+is returned on misuse.
+
+
+\fIares_dns_rr_get_name(3)\fP, \fIares_dns_rr_get_type(3)\fP,
+\fIares_dns_rr_get_class(3)\fP, \fIares_dns_rr_get_ttl(3)\fP,
+\fIares_dns_rr_get_addr(3)\fP, \fIares_dns_rr_get_addr6(3)\fP,
+\fIares_dns_rr_get_str(3)\fP, \fIares_dns_rr_get_u8(3)\fP,
+\fIares_dns_rr_get_u16(3)\fP, \fIares_dns_rr_get_u32(3)\fP,
+\fIares_dns_rr_get_bin(3)\fP, \fIares_dns_rr_get_opt(3)\fP all return their
+prescribed datatype values and in general can't fail except for misuse cases,
+in which a 0 (or NULL) may be returned, however 0 can also be a valid return
+value for most of these functions.
+
+\fIares_dns_record_rr_get(3)\fP will return the requested resource record
+pointer or NULL on failure (misuse).
+
+\fIares_dns_rr_get_opt_byid(3)\fP will return ARES_TRUE if the option was
+found, otherwise ARES_FALSE if not found (or misuse).
+
+.SH AVAILABILITY
+These functions were first introduced in c-ares version 1.22.0.
+.SH SEE ALSO
+.BR ares_dns_mapping (3),
+.BR ares_dns_record (3),
+.BR ares_free_string (3)
+.SH AUTHOR
+Copyright (C) 2023 The c-ares project and its members.
diff --git a/subprojects/c-ares/docs/ares_dns_rr_get_addr.3 b/subprojects/c-ares/docs/ares_dns_rr_get_addr.3
@@ -0,0 +1,3 @@
+.\" Copyright (C) 2023 The c-ares project and its contributors.
+.\" SPDX-License-Identifier: MIT
+.so man3/ares_dns_rr.3
diff --git a/subprojects/c-ares/docs/ares_dns_rr_get_addr6.3 b/subprojects/c-ares/docs/ares_dns_rr_get_addr6.3
@@ -0,0 +1,3 @@
+.\" Copyright (C) 2023 The c-ares project and its contributors.
+.\" SPDX-License-Identifier: MIT
+.so man3/ares_dns_rr.3
diff --git a/subprojects/c-ares/docs/ares_dns_rr_get_bin.3 b/subprojects/c-ares/docs/ares_dns_rr_get_bin.3
@@ -0,0 +1,3 @@
+.\" Copyright (C) 2023 The c-ares project and its contributors.
+.\" SPDX-License-Identifier: MIT
+.so man3/ares_dns_rr.3
diff --git a/subprojects/c-ares/docs/ares_dns_rr_get_class.3 b/subprojects/c-ares/docs/ares_dns_rr_get_class.3
@@ -0,0 +1,3 @@
+.\" Copyright (C) 2023 The c-ares project and its contributors.
+.\" SPDX-License-Identifier: MIT
+.so man3/ares_dns_rr.3
diff --git a/subprojects/c-ares/docs/ares_dns_rr_get_keys.3 b/subprojects/c-ares/docs/ares_dns_rr_get_keys.3
@@ -0,0 +1,3 @@
+.\" Copyright (C) 2023 The c-ares project and its contributors.
+.\" SPDX-License-Identifier: MIT
+.so man3/ares_dns_mapping.3
diff --git a/subprojects/c-ares/docs/ares_dns_rr_get_name.3 b/subprojects/c-ares/docs/ares_dns_rr_get_name.3
@@ -0,0 +1,3 @@
+.\" Copyright (C) 2023 The c-ares project and its contributors.
+.\" SPDX-License-Identifier: MIT
+.so man3/ares_dns_rr.3
diff --git a/subprojects/c-ares/docs/ares_dns_rr_get_opt.3 b/subprojects/c-ares/docs/ares_dns_rr_get_opt.3
@@ -0,0 +1,3 @@
+.\" Copyright (C) 2023 The c-ares project and its contributors.
+.\" SPDX-License-Identifier: MIT
+.so man3/ares_dns_rr.3
diff --git a/subprojects/c-ares/docs/ares_dns_rr_get_opt_byid.3 b/subprojects/c-ares/docs/ares_dns_rr_get_opt_byid.3
@@ -0,0 +1,3 @@
+.\" Copyright (C) 2023 The c-ares project and its contributors.
+.\" SPDX-License-Identifier: MIT
+.so man3/ares_dns_rr.3
diff --git a/subprojects/c-ares/docs/ares_dns_rr_get_opt_cnt.3 b/subprojects/c-ares/docs/ares_dns_rr_get_opt_cnt.3
@@ -0,0 +1,3 @@
+.\" Copyright (C) 2023 The c-ares project and its contributors.
+.\" SPDX-License-Identifier: MIT
+.so man3/ares_dns_rr.3
diff --git a/subprojects/c-ares/docs/ares_dns_rr_get_str.3 b/subprojects/c-ares/docs/ares_dns_rr_get_str.3
@@ -0,0 +1,3 @@
+.\" Copyright (C) 2023 The c-ares project and its contributors.
+.\" SPDX-License-Identifier: MIT
+.so man3/ares_dns_rr.3
diff --git a/subprojects/c-ares/docs/ares_dns_rr_get_ttl.3 b/subprojects/c-ares/docs/ares_dns_rr_get_ttl.3
@@ -0,0 +1,3 @@
+.\" Copyright (C) 2023 The c-ares project and its contributors.
+.\" SPDX-License-Identifier: MIT
+.so man3/ares_dns_rr.3
diff --git a/subprojects/c-ares/docs/ares_dns_rr_get_type.3 b/subprojects/c-ares/docs/ares_dns_rr_get_type.3
@@ -0,0 +1,3 @@
+.\" Copyright (C) 2023 The c-ares project and its contributors.
+.\" SPDX-License-Identifier: MIT
+.so man3/ares_dns_rr.3
diff --git a/subprojects/c-ares/docs/ares_dns_rr_get_u16.3 b/subprojects/c-ares/docs/ares_dns_rr_get_u16.3
@@ -0,0 +1,3 @@
+.\" Copyright (C) 2023 The c-ares project and its contributors.
+.\" SPDX-License-Identifier: MIT
+.so man3/ares_dns_rr.3
diff --git a/subprojects/c-ares/docs/ares_dns_rr_get_u32.3 b/subprojects/c-ares/docs/ares_dns_rr_get_u32.3
@@ -0,0 +1,3 @@
+.\" Copyright (C) 2023 The c-ares project and its contributors.
+.\" SPDX-License-Identifier: MIT
+.so man3/ares_dns_rr.3
diff --git a/subprojects/c-ares/docs/ares_dns_rr_get_u8.3 b/subprojects/c-ares/docs/ares_dns_rr_get_u8.3
@@ -0,0 +1,3 @@
+.\" Copyright (C) 2023 The c-ares project and its contributors.
+.\" SPDX-License-Identifier: MIT
+.so man3/ares_dns_rr.3
diff --git a/subprojects/c-ares/docs/ares_dns_rr_key_datatype.3 b/subprojects/c-ares/docs/ares_dns_rr_key_datatype.3
@@ -0,0 +1,4 @@
+.\"
+.\" Copyright (C) Daniel Stenberg
+.\" SPDX-License-Identifier: MIT
+.so man3/ares_dns_mapping.3
diff --git a/subprojects/c-ares/docs/ares_dns_rr_key_t.3 b/subprojects/c-ares/docs/ares_dns_rr_key_t.3
@@ -0,0 +1,3 @@
+.\" Copyright (C) 2023 The c-ares project and its contributors.
+.\" SPDX-License-Identifier: MIT
+.so man3/ares_dns_rr.3
diff --git a/subprojects/c-ares/docs/ares_dns_rr_key_to_rec_type.3 b/subprojects/c-ares/docs/ares_dns_rr_key_to_rec_type.3
@@ -0,0 +1,4 @@
+.\"
+.\" Copyright (C) Daniel Stenberg
+.\" SPDX-License-Identifier: MIT
+.so man3/ares_dns_mapping.3
diff --git a/subprojects/c-ares/docs/ares_dns_rr_key_tostr.3 b/subprojects/c-ares/docs/ares_dns_rr_key_tostr.3
@@ -0,0 +1,4 @@
+.\"
+.\" Copyright (C) Daniel Stenberg
+.\" SPDX-License-Identifier: MIT
+.so man3/ares_dns_mapping.3
diff --git a/subprojects/c-ares/docs/ares_dns_rr_set_addr.3 b/subprojects/c-ares/docs/ares_dns_rr_set_addr.3
@@ -0,0 +1,3 @@
+.\" Copyright (C) 2023 The c-ares project and its contributors.
+.\" SPDX-License-Identifier: MIT
+.so man3/ares_dns_rr.3
diff --git a/subprojects/c-ares/docs/ares_dns_rr_set_addr6.3 b/subprojects/c-ares/docs/ares_dns_rr_set_addr6.3
@@ -0,0 +1,3 @@
+.\" Copyright (C) 2023 The c-ares project and its contributors.
+.\" SPDX-License-Identifier: MIT
+.so man3/ares_dns_rr.3
diff --git a/subprojects/c-ares/docs/ares_dns_rr_set_bin.3 b/subprojects/c-ares/docs/ares_dns_rr_set_bin.3
@@ -0,0 +1,3 @@
+.\" Copyright (C) 2023 The c-ares project and its contributors.
+.\" SPDX-License-Identifier: MIT
+.so man3/ares_dns_rr.3
diff --git a/subprojects/c-ares/docs/ares_dns_rr_set_opt.3 b/subprojects/c-ares/docs/ares_dns_rr_set_opt.3
@@ -0,0 +1,3 @@
+.\" Copyright (C) 2023 The c-ares project and its contributors.
+.\" SPDX-License-Identifier: MIT
+.so man3/ares_dns_rr.3
diff --git a/subprojects/c-ares/docs/ares_dns_rr_set_str.3 b/subprojects/c-ares/docs/ares_dns_rr_set_str.3
@@ -0,0 +1,3 @@
+.\" Copyright (C) 2023 The c-ares project and its contributors.
+.\" SPDX-License-Identifier: MIT
+.so man3/ares_dns_rr.3
diff --git a/subprojects/c-ares/docs/ares_dns_rr_set_u16.3 b/subprojects/c-ares/docs/ares_dns_rr_set_u16.3
@@ -0,0 +1,3 @@
+.\" Copyright (C) 2023 The c-ares project and its contributors.
+.\" SPDX-License-Identifier: MIT
+.so man3/ares_dns_rr.3
diff --git a/subprojects/c-ares/docs/ares_dns_rr_set_u32.3 b/subprojects/c-ares/docs/ares_dns_rr_set_u32.3
@@ -0,0 +1,3 @@
+.\" Copyright (C) 2023 The c-ares project and its contributors.
+.\" SPDX-License-Identifier: MIT
+.so man3/ares_dns_rr.3
diff --git a/subprojects/c-ares/docs/ares_dns_rr_set_u8.3 b/subprojects/c-ares/docs/ares_dns_rr_set_u8.3
@@ -0,0 +1,3 @@
+.\" Copyright (C) 2023 The c-ares project and its contributors.
+.\" SPDX-License-Identifier: MIT
+.so man3/ares_dns_rr.3
diff --git a/subprojects/c-ares/docs/ares_dns_section_t.3 b/subprojects/c-ares/docs/ares_dns_section_t.3
@@ -0,0 +1,3 @@
+.\" Copyright (C) 2023 The c-ares project and its contributors.
+.\" SPDX-License-Identifier: MIT
+.so man3/ares_dns_rr.3
diff --git a/subprojects/c-ares/docs/ares_dns_section_tostr.3 b/subprojects/c-ares/docs/ares_dns_section_tostr.3
@@ -0,0 +1,4 @@
+.\"
+.\" Copyright (C) Daniel Stenberg
+.\" SPDX-License-Identifier: MIT
+.so man3/ares_dns_mapping.3
diff --git a/subprojects/c-ares/docs/ares_dns_write.3 b/subprojects/c-ares/docs/ares_dns_write.3
@@ -0,0 +1,3 @@
+.\" Copyright (C) 2023 The c-ares project and its contributors.
+.\" SPDX-License-Identifier: MIT
+.so man3/ares_dns_record.3
diff --git a/subprojects/c-ares/docs/ares_dup.3 b/subprojects/c-ares/docs/ares_dup.3
@@ -0,0 +1,41 @@
+.\"
+.\" Copyright (C) 2004-2009 by Daniel Stenberg
+.\"
+.\" Permission to use, copy, modify, and distribute this
+.\" software and its documentation for any purpose and without
+.\" fee is hereby granted, provided that the above copyright
+.\" notice appear in all copies and that both that copyright
+.\" notice and this permission notice appear in supporting
+.\" documentation, and that the name of M.I.T. not be used in
+.\" advertising or publicity pertaining to distribution of the
+.\" software without specific, written prior permission.
+.\" M.I.T. makes no representations about the suitability of
+.\" this software for any purpose. It is provided "as is"
+.\" without express or implied warranty.
+.\"
+.\" SPDX-License-Identifier: MIT
+.\"
+.TH ARES_DUP 3 "26 May 2009"
+.SH NAME
+ares_dup \- Duplicate a resolver channel
+.SH SYNOPSIS
+.nf
+#include <ares.h>
+
+int ares_dup(ares_channel_t **\fIdest\fP, ares_channel_t *\fIsource\fP)
+.fi
+.SH DESCRIPTION
+The \fBares_dup(3)\fP function duplicates an existing communications channel
+for name service lookups. If it returns successfully, \fBares_dup(3)\fP will
+set the variable pointed to by \fIdest\fP to a handle used to identify the
+name service channel. The caller should invoke \fIares_destroy(3)\fP on the
+handle when the channel is no longer needed.
+.SH SEE ALSO
+.BR ares_destroy (3),
+.BR ares_init (3),
+.BR ares_library_init (3)
+.SH AVAILABILITY
+\fIares_dup(3)\fP was added in c-ares 1.6.0
+.SH AUTHOR
+Daniel Stenberg
+
diff --git a/subprojects/c-ares/docs/ares_expand_name.3 b/subprojects/c-ares/docs/ares_expand_name.3
@@ -0,0 +1,68 @@
+.\"
+.\" Copyright 1998 by the Massachusetts Institute of Technology.
+.\"
+.\" Permission to use, copy, modify, and distribute this
+.\" software and its documentation for any purpose and without
+.\" fee is hereby granted, provided that the above copyright
+.\" notice appear in all copies and that both that copyright
+.\" notice and this permission notice appear in supporting
+.\" documentation, and that the name of M.I.T. not be used in
+.\" advertising or publicity pertaining to distribution of the
+.\" software without specific, written prior permission.
+.\" M.I.T. makes no representations about the suitability of
+.\" this software for any purpose. It is provided "as is"
+.\" without express or implied warranty.
+.\"
+.\" SPDX-License-Identifier: MIT
+.\"
+.TH ARES_EXPAND_NAME 3 "20 Nov 2009"
+.SH NAME
+ares_expand_name \- Expand a DNS-encoded domain name
+.SH SYNOPSIS
+.nf
+#include <ares.h>
+
+int ares_expand_name(const unsigned char *\fIencoded\fP,
+ const unsigned char *\fIabuf\fP, int \fIalen\fP,
+ char **\fIs\fP, long *\fIenclen\fP)
+.fi
+.SH DESCRIPTION
+The
+.B ares_expand_name
+function converts a DNS-encoded domain name to a dot-separated C
+string. The argument
+.I encoded
+gives the beginning of the encoded domain name, and the arguments
+.I abuf
+and
+.I alen
+give the containing message buffer (necessary for the processing of
+indirection pointers within the encoded domain name). The result is
+placed in a NUL-terminated allocated buffer, a pointer to which is
+stored in the variable pointed to by
+.IR s .
+The length of the encoded name is stored in the variable pointed to by
+.I enclen
+so that the caller can advance past the encoded domain name to read
+further data in the message.
+
+Use \fIares_free_string(3)\fP to free the allocated hostname.
+.SH RETURN VALUES
+.B ares_expand_name
+can return any of the following values:
+.TP 15
+.B ARES_SUCCESS
+Expansion of the encoded name succeeded.
+.TP 15
+.B ARES_EBADNAME
+The encoded domain name was malformed and could not be expanded.
+.TP 15
+.B ARES_ENOMEM
+Memory was exhausted.
+.SH SEE ALSO
+.BR ares_mkquery (3),
+.BR ares_free_string (3)
+.SH AUTHOR
+Greg Hudson, MIT Information Systems
+.br
+Copyright 1998 by the Massachusetts Institute of Technology.
diff --git a/subprojects/c-ares/docs/ares_expand_string.3 b/subprojects/c-ares/docs/ares_expand_string.3
@@ -0,0 +1,63 @@
+.\"
+.\" Copyright 1998 by the Massachusetts Institute of Technology.
+.\"
+.\" Permission to use, copy, modify, and distribute this
+.\" software and its documentation for any purpose and without
+.\" fee is hereby granted, provided that the above copyright
+.\" notice appear in all copies and that both that copyright
+.\" notice and this permission notice appear in supporting
+.\" documentation, and that the name of M.I.T. not be used in
+.\" advertising or publicity pertaining to distribution of the
+.\" software without specific, written prior permission.
+.\" M.I.T. makes no representations about the suitability of
+.\" this software for any purpose. It is provided "as is"
+.\" without express or implied warranty.
+.\"
+.\" SPDX-License-Identifier: MIT
+.\"
+.TH ARES_EXPAND_NAME 3 "20 Nov 2009"
+.SH NAME
+ares_expand_string \- Expand a length encoded string
+.SH SYNOPSIS
+.nf
+#include <ares.h>
+
+int ares_expand_string(const unsigned char *\fIencoded\fP,
+ const unsigned char *\fIabuf\fP, int \fIalen\fP,
+ unsigned char **\fIs\fP, long *\fIenclen\fP)
+.fi
+.SH DESCRIPTION
+The
+.B ares_expand_string
+function converts a length encoded string to a NUL-terminated C
+string. The argument
+.I encoded
+gives the beginning of the encoded string, and the arguments
+.I abuf
+and
+.I alen
+give the containing message buffer (necessary for the processing of
+indirection pointers within the encoded domain name). The result is
+placed in a NUL-terminated allocated buffer, a pointer to which is
+stored in the variable pointed to by
+.IR s .
+The length of the encoded string is stored in the variable pointed to by
+.I enclen
+so that the caller can advance past the encoded string to read
+further data in the message.
+.SH RETURN VALUES
+.B ares_expand_string
+can return any of the following values:
+.TP 15
+.B ARES_SUCCESS
+Expansion of the encoded string succeeded.
+.TP 15
+.B ARES_EBADSTR
+The encoded string was malformed and could not be expanded.
+.TP 15
+.B ARES_ENOMEM
+Memory was exhausted.
+.SH SEE ALSO
+.BR ares_free_string (3)
+.SH AUTHOR
+Dominick Meglio
diff --git a/subprojects/c-ares/docs/ares_fds.3 b/subprojects/c-ares/docs/ares_fds.3
@@ -0,0 +1,50 @@
+.\"
+.\" Copyright 1998 by the Massachusetts Institute of Technology.
+.\"
+.\" Permission to use, copy, modify, and distribute this
+.\" software and its documentation for any purpose and without
+.\" fee is hereby granted, provided that the above copyright
+.\" notice appear in all copies and that both that copyright
+.\" notice and this permission notice appear in supporting
+.\" documentation, and that the name of M.I.T. not be used in
+.\" advertising or publicity pertaining to distribution of the
+.\" software without specific, written prior permission.
+.\" M.I.T. makes no representations about the suitability of
+.\" this software for any purpose. It is provided "as is"
+.\" without express or implied warranty.
+.\"
+.\" SPDX-License-Identifier: MIT
+.\"
+.TH ARES_FDS 3 "23 July 1998"
+.SH NAME
+ares_fds \- return file descriptors to select on
+.SH SYNOPSIS
+.nf
+#include <ares.h>
+
+int ares_fds(ares_channel_t *\fIchannel\fP,
+ fd_set *\fIread_fds\fP,
+ fd_set *\fIwrite_fds\fP)
+.fi
+.SH DESCRIPTION
+The \fBares_fds(3)\fP function retrieves the set of file descriptors which the
+calling application should select on for reading and writing for the
+processing of name service queries pending on the name service channel
+identified by \fIchannel\fP.
+
+File descriptors will be set in the file descriptor sets pointed to by
+\fIread_fds\fP and \fIwrite_fds\fP as appropriate. File descriptors already
+set in \fIread_fds\fP and \fIwrite_fds\fP will remain set; initialization of
+the file descriptor sets (using \fBFD_ZERO\fP) is the responsibility of the
+caller.
+.SH RETURN VALUES
+\fBares_fds(3)\fP returns a value that is one greater than the number of the
+highest socket set in either \fIread_fds\fP or \fIwrite_fds\fP. If no queries
+are active, \fBares_fds(3)\fP returns 0.
+.SH SEE ALSO
+.BR ares_timeout (3),
+.BR ares_process (3)
+.SH AUTHOR
+Greg Hudson, MIT Information Systems
+.br
+Copyright 1998 by the Massachusetts Institute of Technology.
diff --git a/subprojects/c-ares/docs/ares_free_data.3 b/subprojects/c-ares/docs/ares_free_data.3
@@ -0,0 +1,81 @@
+.\"
+.\" Copyright 1998 by the Massachusetts Institute of Technology.
+.\" Copyright (C) 2004-2010 by Daniel Stenberg
+.\"
+.\" Permission to use, copy, modify, and distribute this
+.\" software and its documentation for any purpose and without
+.\" fee is hereby granted, provided that the above copyright
+.\" notice appear in all copies and that both that copyright
+.\" notice and this permission notice appear in supporting
+.\" documentation, and that the name of M.I.T. not be used in
+.\" advertising or publicity pertaining to distribution of the
+.\" software without specific, written prior permission.
+.\" M.I.T. makes no representations about the suitability of
+.\" this software for any purpose. It is provided "as is"
+.\" without express or implied warranty.
+.\"
+.\" SPDX-License-Identifier: MIT
+.\"
+.TH ARES_FREE_DATA 3 "5 March 2010"
+.SH NAME
+ares_free_data \- Free data allocated by several c-ares functions
+.SH SYNOPSIS
+.nf
+#include <ares.h>
+
+void ares_free_data(void *\fIdataptr\fP)
+.fi
+.SH DESCRIPTION
+.PP
+The \fBares_free_data(3)\fP function frees one or more data structures
+allocated and returned by several c-ares functions. Specifically the data
+returned by the following list of functions must be deallocated using this
+function.
+.TP 5
+.B ares_get_servers(3)
+When used to free the data returned by \fIares_get_servers(3)\fP this will
+free the whole linked list of ares_addr_node structures returned by
+\fIares_get_servers(3)\fP.
+.TP
+.B ares_parse_srv_reply(3)
+When used to free the data returned by \fIares_parse_srv_reply(3)\fP this will
+free the whole linked list of ares_srv_reply structures returned by
+\fIares_parse_srv_reply(3)\fP, along with any additional storage associated
+with those structures.
+.TP
+.B ares_parse_mx_reply(3)
+When used to free the data returned by \fIares_parse_mx_reply(3)\fP this will
+free the whole linked list of ares_mx_reply structures returned by
+\fIares_parse_mx_reply(3)\fP, along with any additional storage associated
+with those structures.
+.TP
+.B ares_parse_txt_reply(3)
+When used to free the data returned by \fIares_parse_txt_reply(3)\fP this will
+free the whole linked list of ares_txt_reply structures returned by
+\fIares_parse_txt_reply(3)\fP, along with any additional storage associated
+with those structures.
+.TP
+.B ares_parse_soa_reply(3)
+When used to free the data returned by \fIares_parse_soa_reply(3)\fP this will
+free the ares_soa_reply structure, along with any additional storage
+associated with those structure.
+.B ares_parse_uri_reply(3)
+When used to free the data returned by \fIares_parse_uri_reply(3)\fP this will
+free list of ares_uri_reply structures, along with any additional storage
+associated with those structure.
+.SH RETURN VALUE
+The \fIares_free_data(3)\fP function does not return a value.
+.SH AVAILABILITY
+This function was first introduced in c-ares version 1.7.0.
+.SH SEE ALSO
+.BR ares_get_servers (3),
+.BR ares_parse_srv_reply (3),
+.BR ares_parse_mx_reply (3),
+.BR ares_parse_txt_reply (3),
+.BR ares_parse_soa_reply (3)
+.SH AUTHOR
+Yang Tse
+.PP
+Copyright 1998 by the Massachusetts Institute of Technology.
+.br
+Copyright (C) 2004-2010 by Daniel Stenberg.
diff --git a/subprojects/c-ares/docs/ares_free_hostent.3 b/subprojects/c-ares/docs/ares_free_hostent.3
@@ -0,0 +1,47 @@
+.\"
+.\" Copyright 1998 by the Massachusetts Institute of Technology.
+.\"
+.\" Permission to use, copy, modify, and distribute this
+.\" software and its documentation for any purpose and without
+.\" fee is hereby granted, provided that the above copyright
+.\" notice appear in all copies and that both that copyright
+.\" notice and this permission notice appear in supporting
+.\" documentation, and that the name of M.I.T. not be used in
+.\" advertising or publicity pertaining to distribution of the
+.\" software without specific, written prior permission.
+.\" M.I.T. makes no representations about the suitability of
+.\" this software for any purpose. It is provided "as is"
+.\" without express or implied warranty.
+.\"
+.\" SPDX-License-Identifier: MIT
+.\"
+.TH ARES_FREE_HOSTENT 3 "23 July 1998"
+.SH NAME
+ares_free_hostent \- Free host structure allocated by ares functions
+.SH SYNOPSIS
+.nf
+#include <ares.h>
+
+void ares_free_hostent(struct hostent *\fIhost\fP)
+.fi
+.SH DESCRIPTION
+The
+.I ares_free_hostent
+function frees a
+.B struct hostent
+allocated by one of the functions \fIares_parse_a_reply(3)\fP,
+\fIares_parse_aaaa_reply(3)\fP, or \fIares_parse_ptr_reply(3)\fP.
+.SH NOTES
+It is not necessary (and is not correct) to free the host structure passed to
+the callback functions for \fIares_gethostbyname(3)\fP or
+\fIares_gethostbyaddr(3)\fP. c-ares will automatically free such host
+structures when the callback returns.
+.SH SEE ALSO
+.BR ares_parse_a_reply (3),
+.BR ares_parse_aaaa_reply (3),
+.BR ares_parse_ptr_reply (3),
+.BR ares_parse_ns_reply (3)
+.SH AUTHOR
+Greg Hudson, MIT Information Systems
+.br
+Copyright 1998 by the Massachusetts Institute of Technology.
diff --git a/subprojects/c-ares/docs/ares_free_string.3 b/subprojects/c-ares/docs/ares_free_string.3
@@ -0,0 +1,36 @@
+.\"
+.\" Copyright 2000 by the Massachusetts Institute of Technology.
+.\"
+.\" Permission to use, copy, modify, and distribute this
+.\" software and its documentation for any purpose and without
+.\" fee is hereby granted, provided that the above copyright
+.\" notice appear in all copies and that both that copyright
+.\" notice and this permission notice appear in supporting
+.\" documentation, and that the name of M.I.T. not be used in
+.\" advertising or publicity pertaining to distribution of the
+.\" software without specific, written prior permission.
+.\" M.I.T. makes no representations about the suitability of
+.\" this software for any purpose. It is provided "as is"
+.\" without express or implied warranty.
+.\"
+.\" SPDX-License-Identifier: MIT
+.\"
+.TH ARES_FREE_STRING 3 "4 February 2004"
+.SH NAME
+ares_free_string \- Free strings allocated by ares functions
+.SH SYNOPSIS
+.nf
+#include <ares.h>
+
+void ares_free_string(void *\fIstr\fP)
+.fi
+.SH DESCRIPTION
+The \fIares_free_string(3)\fP function frees a string allocated by an ares
+function.
+.SH SEE ALSO
+.BR ares_mkquery (3)
+.BR ares_expand_string (3)
+.SH AUTHOR
+Greg Hudson, MIT Information Systems
+.br
+Copyright 2000 by the Massachusetts Institute of Technology.
diff --git a/subprojects/c-ares/docs/ares_freeaddrinfo.3 b/subprojects/c-ares/docs/ares_freeaddrinfo.3
@@ -0,0 +1,39 @@
+.\"
+.\" Copyright 1998 by the Massachusetts Institute of Technology.
+.\"
+.\" Permission to use, copy, modify, and distribute this
+.\" software and its documentation for any purpose and without
+.\" fee is hereby granted, provided that the above copyright
+.\" notice appear in all copies and that both that copyright
+.\" notice and this permission notice appear in supporting
+.\" documentation, and that the name of M.I.T. not be used in
+.\" advertising or publicity pertaining to distribution of the
+.\" software without specific, written prior permission.
+.\" M.I.T. makes no representations about the suitability of
+.\" this software for any purpose. It is provided "as is"
+.\" without express or implied warranty.
+.\"
+.\" SPDX-License-Identifier: MIT
+.\"
+.TH ARES_FREEADDRINFO 3 "31 October 2018"
+.SH NAME
+ares_freeaddrinfo \- Free addrinfo structure allocated by ares functions
+.SH SYNOPSIS
+.nf
+#include <ares.h>
+
+void ares_freeaddrinfo(struct ares_addrinfo *\fIai\fP)
+.fi
+.SH DESCRIPTION
+The
+.B ares_freeaddrinfo
+function frees a
+.B struct ares_addrinfo
+returned in \fIresult\fP of
+.B ares_addrinfo_callback
+.SH SEE ALSO
+.BR ares_getaddrinfo (3),
+.SH AUTHOR
+Christian Ammer
+.BR
+Andrew Selivanov <andrew.selivanov@gmail.com>
diff --git a/subprojects/c-ares/docs/ares_get_servers.3 b/subprojects/c-ares/docs/ares_get_servers.3
@@ -0,0 +1,92 @@
+.\"
+.\" Copyright 1998 by the Massachusetts Institute of Technology.
+.\" Copyright (C) 2008-2010 by Daniel Stenberg
+.\"
+.\" Permission to use, copy, modify, and distribute this
+.\" software and its documentation for any purpose and without
+.\" fee is hereby granted, provided that the above copyright
+.\" notice appear in all copies and that both that copyright
+.\" notice and this permission notice appear in supporting
+.\" documentation, and that the name of M.I.T. not be used in
+.\" advertising or publicity pertaining to distribution of the
+.\" software without specific, written prior permission.
+.\" M.I.T. makes no representations about the suitability of
+.\" this software for any purpose. It is provided "as is"
+.\" without express or implied warranty.
+.\"
+.\" SPDX-License-Identifier: MIT
+.\"
+.TH ARES_GET_SERVERS 3 "5 March 2010"
+.SH NAME
+ares_get_servers, ares_get_servers_ports \- Retrieve name servers from an initialized ares_channel (deprecated)
+.SH SYNOPSIS
+.nf
+#include <ares.h>
+
+int ares_get_servers(ares_channel_t *\fIchannel\fP,
+ struct ares_addr_node **\fIservers\fP)
+
+int ares_get_servers_ports(ares_channel_t *\fIchannel\fP,
+ struct ares_addr_port_node **\fIservers\fP)
+.fi
+.SH DESCRIPTION
+The \fBares_get_servers(3)\fP function retrieves name servers configuration
+from the
+channel data identified by
+.IR channel ,
+as a linked list of ares_addr_node structs storing a pointer to the first
+node at the address specified by
+.IR servers .
+
+The \fBares_get_servers_ports(3)\fP function also retrieves any per-server
+port information that may have been previously configured, returning a linked
+list of ares_addr_port structures.
+
+Function caller may traverse the returned name server linked list, or may use
+it directly as suitable input for the \fBares_set_servers(3)\fP /
+\fBares_set_servers_ports(3)\fP functions, but
+shall not shrink or extend the list on its own.
+
+Each node of the name server linked list is stored in memory dynamically
+allocated and managed by c-ares. It is the caller's responsibility to free
+the resulting linked list, using \fBares_free_data(3)\fP , once the caller
+does not need it any longer.
+
+This function is capable of handling IPv4 and IPv6 name server
+addresses simultaneously, rendering \fBares_save_options(3)\fP with
+optmask \fBARES_OPT_SERVERS\fP functionally obsolete except for
+IPv4-only name server usage.
+
+.SH RETURN VALUES
+This function may return any of the following values:
+.TP 15
+.B ARES_SUCCESS
+The name servers configuration was successfully retrieved
+.TP 15
+.B ARES_ENOMEM
+The memory was exhausted
+.TP 15
+.B ARES_ENODATA
+The channel data identified by
+.IR channel
+was invalid.
+.SH SEE ALSO
+.BR ares_set_servers (3),
+.BR ares_init_options (3),
+.BR ares_save_options(3)
+.SH AVAILABILITY
+\fBares_get_servers(3)\fP was added in c-ares 1.7.1;
+\fBares_get_servers_ports(3)\fP was added in c-ares 1.11.0.
+.SH NOTES
+As of c-ares 1.24, these functions are deprecated due to their lack of ability
+to store the entire server configuration. Use \fBares_get_servers_csv(3)\fP.
+.SH AUTHOR
+Implementation of this function and associated library internals are based
+on code, comments and feedback provided in November and December of 2008 by
+Daniel Stenberg, Gregor Jasny, Phil Blundell and Yang Tse, December 2009
+by Cedric Bail, February 2010 by Jakub Hrozek. On March 2010 Yang Tse
+shuffled all the bits and this function popped out.
+.br
+Copyright 1998 by the Massachusetts Institute of Technology.
+.br
+Copyright (C) 2008-2010 by Daniel Stenberg
diff --git a/subprojects/c-ares/docs/ares_get_servers_csv.3 b/subprojects/c-ares/docs/ares_get_servers_csv.3
@@ -0,0 +1,4 @@
+.\"
+.\" Copyright (C) Daniel Stenberg
+.\" SPDX-License-Identifier: MIT
+.so man3/ares_set_servers_csv.3
diff --git a/subprojects/c-ares/docs/ares_get_servers_ports.3 b/subprojects/c-ares/docs/ares_get_servers_ports.3
@@ -0,0 +1,4 @@
+.\"
+.\" Copyright (C) Daniel Stenberg
+.\" SPDX-License-Identifier: MIT
+.so man3/ares_get_servers.3
diff --git a/subprojects/c-ares/docs/ares_getaddrinfo.3 b/subprojects/c-ares/docs/ares_getaddrinfo.3
@@ -0,0 +1,207 @@
+.\"
+.\" Copyright 1998 by the Massachusetts Institute of Technology.
+.\"
+.\" Permission to use, copy, modify, and distribute this
+.\" software and its documentation for any purpose and without
+.\" fee is hereby granted, provided that the above copyright
+.\" notice appear in all copies and that both that copyright
+.\" notice and this permission notice appear in supporting
+.\" documentation, and that the name of M.I.T. not be used in
+.\" advertising or publicity pertaining to distribution of the
+.\" software without specific, written prior permission.
+.\" M.I.T. makes no representations about the suitability of
+.\" this software for any purpose. It is provided "as is"
+.\" without express or implied warranty.
+.\"
+.\" SPDX-License-Identifier: MIT
+.\"
+.TH ARES_GETADDRINFO 3 "4 November 2018"
+.SH NAME
+ares_getaddrinfo \- Initiate a host query by name and service
+.SH SYNOPSIS
+.nf
+#include <ares.h>
+
+typedef void (*ares_addrinfo_callback)(void *\fIarg\fP, int \fIstatus\fP,
+ int \fItimeouts\fP,
+ struct ares_addrinfo *\fIresult\fP)
+
+void ares_getaddrinfo(ares_channel_t *\fIchannel\fP, const char *\fIname\fP,
+ const char* \fIservice\fP,
+ const struct ares_addrinfo_hints *\fIhints\fP,
+ ares_addrinfo_callback \fIcallback\fP, void *\fIarg\fP)
+.fi
+.SH DESCRIPTION
+The \fBares_getaddrinfo(3)\fP function initiates a host query by name on the
+name service channel identified by
+.IR channel .
+The
+.I name
+and
+.I service
+parameters give the hostname and service as NULL-terminated C strings.
+The
+.I hints
+parameter is an
+.BR ares_addrinfo_hints
+structure:
+.PP
+.RS
+.EX
+struct ares_addrinfo_hints {
+ int ai_flags;
+ int ai_family;
+ int ai_socktype;
+ int ai_protocol;
+};
+.EE
+.RE
+.TP
+.I ai_family
+Specifies desired address family. AF_UNSPEC means return both AF_INET and AF_INET6.
+.TP
+.I ai_socktype
+Specifies desired socket type, for example SOCK_STREAM or SOCK_DGRAM.
+Setting this to 0 means any type.
+.TP
+.I ai_protocol
+Setting this to 0 means any protocol.
+.TP
+.I ai_flags
+Specifies additional options, see below.
+.PP
+.TP 19
+.B ARES_AI_NUMERICSERV
+If this option is set
+.I service
+field will be treated as a numeric value.
+.TP 19
+.B ARES_AI_CANONNAME
+The ares_addrinfo structure will return a canonical names list.
+.TP 19
+.B ARES_AI_NOSORT
+Result addresses will not be sorted and no connections to resolved addresses will be attempted.
+.TP 19
+.B ARES_AI_ENVHOSTS
+Read hosts file path from the environment variable
+.I CARES_HOSTS .
+.PP
+When the query is complete or has failed, the ares library will invoke \fIcallback\fP.
+Completion or failure of the query may happen immediately, or may happen
+during a later call to \fIares_process(3)\fP, \fIares_destroy(3)\fP or
+\fIares_cancel(3)\fP.
+.PP
+If this is called from a thread other than which the main program event loop is
+running, care needs to be taken to ensure any file descriptor lists are updated
+immediately within the eventloop. When the associated callback is called,
+it is called with a channel lock so care must be taken to ensure any processing
+is minimal to prevent DNS channel stalls.
+.PP
+The callback argument
+.I arg
+is copied from the \fBares_getaddrinfo(3)\fP argument
+.IR arg .
+The callback argument
+.I status
+indicates whether the query succeeded and, if not, how it failed. It
+may have any of the following values:
+.TP 19
+.B ARES_SUCCESS
+The host lookup completed successfully.
+.TP 19
+.B ARES_ENOTIMP
+The ares library does not know how to find addresses of type
+.IR family .
+.TP 19
+.B ARES_ENOTFOUND
+The
+.I name
+was not found.
+.TP 19
+.B ARES_ENOMEM
+Memory was exhausted.
+.TP 19
+.B ARES_ESERVICE
+The textual service name provided could not be dereferenced into a port.
+.TP 19
+.B ARES_ECANCELLED
+The query was cancelled.
+.TP 19
+.B ARES_EDESTRUCTION
+The name service channel
+.I channel
+is being destroyed; the query will not be completed.
+.PP
+On successful completion of the query, the callback argument
+.I result
+points to a
+.B struct ares_addrinfo
+which contains two linked lists, one with resolved addresses and another with canonical names.
+Also included is the official name of the host (analogous to gethostbyname() h_name).
+.PP
+.RS
+.EX
+struct ares_addrinfo {
+ struct ares_addrinfo_cname *cnames;
+ struct ares_addrinfo_node *nodes;
+ char *name;
+};
+.EE
+.RE
+.PP
+.I ares_addrinfo_node
+structure is similar to RFC3493 addrinfo, but without canonname and with extra ttl field.
+.RS
+.PP
+.EX
+struct ares_addrinfo_node {
+ int ai_ttl;
+ int ai_flags;
+ int ai_family;
+ int ai_socktype;
+ int ai_protocol;
+ ares_socklen_t ai_addrlen;
+ struct sockaddr *ai_addr;
+ struct ares_addrinfo_node *ai_next;
+};
+.EE
+.RE
+.PP
+.I ares_addrinfo_cname
+structure is a linked list of CNAME records where
+.I ttl
+is a time to live
+.I alias
+is a label of the resource record and
+.I name
+is a value (canonical name) of the resource record.
+See RFC2181 10.1.1. CNAME terminology.
+.RS
+.PP
+.EX
+struct ares_addrinfo_cname {
+ int ttl;
+ char *alias;
+ char *name;
+ struct ares_addrinfo_cname *next;
+};
+.EE
+.RE
+.PP
+The reserved memory has to be deleted by \fBares_freeaddrinfo(3)\fP.
+
+The result is sorted according to RFC6724 except:
+ - Rule 3 (Avoid deprecated addresses)
+ - Rule 4 (Prefer home addresses)
+ - Rule 7 (Prefer native transport)
+
+Please note that the function will attempt a connection
+on each of the resolved addresses as per RFC6724.
+.SH AVAILABILITY
+This function was added in c-ares 1.16.0, released in March 2020.
+.SH SEE ALSO
+.BR ares_freeaddrinfo (3)
+.SH AUTHOR
+Christian Ammer
+.br
+Andrew Selivanov <andrew.selivanov@gmail.com>
diff --git a/subprojects/c-ares/docs/ares_gethostbyaddr.3 b/subprojects/c-ares/docs/ares_gethostbyaddr.3
@@ -0,0 +1,113 @@
+.\"
+.\" Copyright 1998 by the Massachusetts Institute of Technology.
+.\"
+.\" Permission to use, copy, modify, and distribute this
+.\" software and its documentation for any purpose and without
+.\" fee is hereby granted, provided that the above copyright
+.\" notice appear in all copies and that both that copyright
+.\" notice and this permission notice appear in supporting
+.\" documentation, and that the name of M.I.T. not be used in
+.\" advertising or publicity pertaining to distribution of the
+.\" software without specific, written prior permission.
+.\" M.I.T. makes no representations about the suitability of
+.\" this software for any purpose. It is provided "as is"
+.\" without express or implied warranty.
+.\"
+.\" SPDX-License-Identifier: MIT
+.\"
+.TH ARES_GETHOSTBYADDR 3 "24 July 1998"
+.SH NAME
+ares_gethostbyaddr \- Initiate a host query by address
+.SH SYNOPSIS
+.nf
+#include <ares.h>
+
+typedef void (*ares_host_callback)(void *\fIarg\fP, int \fIstatus\fP,
+ int \fItimeouts\fP,
+ struct hostent *\fIhostent\fP)
+
+void ares_gethostbyaddr(ares_channel_t *\fIchannel\fP, const void *\fIaddr\fP,
+ int \fIaddrlen\fP, int \fIfamily\fP,
+ ares_host_callback \fIcallback\fP, void *\fIarg\fP)
+.fi
+.SH DESCRIPTION
+The
+.B ares_gethostbyaddr
+function initiates a host query by address on the name service channel
+identified by
+.IR channel .
+The parameters
+.I addr
+and
+.I addrlen
+give the address as a series of bytes, and
+.I family
+gives the type of address. When the query is complete or has failed, the ares
+library will invoke \fIcallback\fP. Completion or failure of the query may
+happen immediately, or may happen during a later call to
+\fIares_process(3)\fP, \fIares_destroy(3)\fP or \fIares_cancel(3)\fP.
+.PP
+The callback argument
+.I arg
+is copied from the
+.B ares_gethostbyaddr
+argument
+.IR arg .
+The callback argument
+.I status
+indicates whether the query succeeded and, if not, how it failed. It
+may have any of the following values:
+.TP 19
+.B ARES_SUCCESS
+The host lookup completed successfully.
+.TP 19
+.B ARES_ENOTIMP
+The ares library does not know how to look up addresses of type
+.IR family .
+.TP 19
+.B ARES_ENOTFOUND
+The address
+.I addr
+was not found.
+.TP 19
+.B ARES_ENOMEM
+Memory was exhausted.
+.TP 19
+.B ARES_ECANCELLED
+The query was cancelled.
+.TP 19
+.B ARES_EDESTRUCTION
+The name service channel
+.I channel
+is being destroyed; the query will not be completed.
+.PP
+The callback argument
+.I timeouts
+reports how many times a query timed out during the execution of the
+given request.
+.PP
+On successful completion of the query, the callback argument
+.I hostent
+points to a
+.B struct hostent
+containing the name of the host returned by the query. The callback
+need not and should not attempt to free the memory pointed to by
+.IR hostent ;
+the ares library will free it when the callback returns. If the query
+did not complete successfully,
+.I hostent
+will be
+.BR NULL .
+.PP
+If this is called from a thread other than which the main program event loop is
+running, care needs to be taken to ensure any file descriptor lists are updated
+immediately within the eventloop. When the associated callback is called,
+it is called with a channel lock so care must be taken to ensure any processing
+is minimal to prevent DNS channel stalls.
+.SH SEE ALSO
+.BR ares_process (3),
+.BR ares_gethostbyname (3)
+.SH AUTHOR
+Greg Hudson, MIT Information Systems
+.br
+Copyright 1998 by the Massachusetts Institute of Technology.
diff --git a/subprojects/c-ares/docs/ares_gethostbyname.3 b/subprojects/c-ares/docs/ares_gethostbyname.3
@@ -0,0 +1,121 @@
+.\"
+.\" Copyright 1998 by the Massachusetts Institute of Technology.
+.\"
+.\" Permission to use, copy, modify, and distribute this
+.\" software and its documentation for any purpose and without
+.\" fee is hereby granted, provided that the above copyright
+.\" notice appear in all copies and that both that copyright
+.\" notice and this permission notice appear in supporting
+.\" documentation, and that the name of M.I.T. not be used in
+.\" advertising or publicity pertaining to distribution of the
+.\" software without specific, written prior permission.
+.\" M.I.T. makes no representations about the suitability of
+.\" this software for any purpose. It is provided "as is"
+.\" without express or implied warranty.
+.\"
+.\" SPDX-License-Identifier: MIT
+.\"
+.TH ARES_GETHOSTBYNAME 3 "25 July 1998"
+.SH NAME
+ares_gethostbyname \- Initiate a host query by name
+.SH SYNOPSIS
+.nf
+#include <ares.h>
+
+typedef void (*ares_host_callback)(void *\fIarg\fP, int \fIstatus\fP,
+ int \fItimeouts\fP,
+ struct hostent *\fIhostent\fP)
+
+void ares_gethostbyname(ares_channel_t *\fIchannel\fP, const char *\fIname\fP,
+ int \fIfamily\fP, ares_host_callback \fIcallback\fP,
+ void *\fIarg\fP)
+.fi
+.SH DESCRIPTION
+The
+.B ares_gethostbyname
+function initiates a host query by name on the name service channel
+identified by
+.IR channel .
+The parameter
+.I name
+gives the hostname as a NUL-terminated C string, and
+.I family
+gives the desired type of address for the resulting host entry. When the
+query is complete or has failed, the ares library will invoke \fIcallback\fP.
+Completion or failure of the query may happen immediately, or may happen
+during a later call to \fIares_process(3)\fP, \fIares_destroy(3)\fP or
+\fIares_cancel(3)\fP.
+.PP
+The callback argument
+.I arg
+is copied from the
+.B ares_gethostbyname
+argument
+.IR arg .
+The callback argument
+.I status
+indicates whether the query succeeded and, if not, how it failed. It
+may have any of the following values:
+.TP 19
+.B ARES_SUCCESS
+The host lookup completed successfully.
+.TP 19
+.B ARES_ENOTIMP
+The ares library does not know how to find addresses of type
+.IR family .
+.TP 19
+.B ARES_EBADNAME
+The hostname
+.B name
+is composed entirely of numbers and periods, but is not a valid
+representation of an Internet address.
+.TP 19
+.B ARES_ENODATA
+There was no data returned to extract a result from.
+.TP 19
+.B ARES_ENOTFOUND
+The name
+.I name
+was not found.
+.TP 19
+.B ARES_ENOMEM
+Memory was exhausted.
+.TP 19
+.B ARES_ECANCELLED
+The query was cancelled.
+.TP 19
+.B ARES_EDESTRUCTION
+The name service channel
+.I channel
+is being destroyed; the query will not be completed.
+.PP
+The callback argument
+.I timeouts
+reports how many times a query timed out during the execution of the
+given request.
+.PP
+On successful completion of the query, the callback argument
+.I hostent
+points to a
+.B struct hostent
+containing the name of the host returned by the query. The callback
+need not and should not attempt to free the memory pointed to by
+.IR hostent ;
+the ares library will free it when the callback returns. If the query
+did not complete successfully,
+.I hostent
+will be
+.BR NULL .
+.PP
+If this is called from a thread other than which the main program event loop is
+running, care needs to be taken to ensure any file descriptor lists are updated
+immediately within the eventloop. When the associated callback is called,
+it is called with a channel lock so care must be taken to ensure any processing
+is minimal to prevent DNS channel stalls.
+.SH SEE ALSO
+.BR ares_process (3),
+.BR ares_gethostbyaddr (3)
+.SH AUTHOR
+Greg Hudson, MIT Information Systems
+.br
+Copyright 1998 by the Massachusetts Institute of Technology.
diff --git a/subprojects/c-ares/docs/ares_gethostbyname_file.3 b/subprojects/c-ares/docs/ares_gethostbyname_file.3
@@ -0,0 +1,85 @@
+.\"
+.\" Copyright 1998 by the Massachusetts Institute of Technology.
+.\"
+.\" Permission to use, copy, modify, and distribute this
+.\" software and its documentation for any purpose and without
+.\" fee is hereby granted, provided that the above copyright
+.\" notice appear in all copies and that both that copyright
+.\" notice and this permission notice appear in supporting
+.\" documentation, and that the name of M.I.T. not be used in
+.\" advertising or publicity pertaining to distribution of the
+.\" software without specific, written prior permission.
+.\" M.I.T. makes no representations about the suitability of
+.\" this software for any purpose. It is provided "as is"
+.\" without express or implied warranty.
+.\"
+.\" SPDX-License-Identifier: MIT
+.\"
+.TH ARES_GETHOSTBYNAME 3 "25 July 1998"
+.SH NAME
+ares_gethostbyname_file \- Lookup a name in the system's hosts file
+.SH SYNOPSIS
+.nf
+#include <ares.h>
+
+int ares_gethostbyname_file(ares_channel_t *\fIchannel\fP, const char *\fIname\fP,
+ int \fIfamily\fP, struct hostent **host)
+.fi
+.SH DESCRIPTION
+The
+.B ares_gethostbyname_file
+function performs a host lookup by name against the system's hosts file (or equivalent local hostname database).
+The
+.IR channel
+parameter is required, but no asynchronous queries are performed. Instead, the
+lookup is done via the same mechanism used to perform 'f' lookups
+(see the
+.I lookups
+options field in \fIares_init_options(3)\fP).
+The parameter
+.I name
+gives the hostname as a NUL-terminated C string, and
+.I family
+gives the desired type of address for the resulting host entry.
+.PP
+The return value indicates whether the query succeeded and, if not, how it
+failed. It may have any of the following values:
+.TP 19
+.B ARES_SUCCESS
+The host lookup completed successfully and
+.I host
+now points to the result (and must be freed with \fIares_free_hostent(3)\fP).
+.TP 19
+.B ARES_ENOTFOUND
+The hostname
+.I name
+was not found.
+.TP 19
+.B ARES_EFILE
+There was a file I/O error while performing the lookup.
+.TP 19
+.B ARES_ENOMEM
+Memory was exhausted.
+.PP
+On successful completion of the query, the pointer pointed to by
+.I host
+points to a
+.B struct hostent
+containing the address of the host returned by the lookup. The user must
+free the memory pointed to by
+.IR host
+when finished with it by calling \fIares_free_hostent(3)\fP. If the lookup did
+not complete successfully,
+.I host
+will be
+.BR NULL .
+.SH AVAILABILITY
+Added in c-ares 1.5.4
+.SH SEE ALSO
+.BR ares_gethostbyname (3),
+.BR ares_free_hostent (3),
+.BR ares_init_options (3)
+.SH AUTHOR
+Brad Spencer
+.br
+Copyright 1998 by the Massachusetts Institute of Technology.
diff --git a/subprojects/c-ares/docs/ares_getnameinfo.3 b/subprojects/c-ares/docs/ares_getnameinfo.3
@@ -0,0 +1,160 @@
+.\"
+.\" Copyright 2005 by Dominick Meglio.
+.\"
+.\" Permission to use, copy, modify, and distribute this
+.\" software and its documentation for any purpose and without
+.\" fee is hereby granted, provided that the above copyright
+.\" notice appear in all copies and that both that copyright
+.\" notice and this permission notice appear in supporting
+.\" documentation, and that the name of M.I.T. not be used in
+.\" advertising or publicity pertaining to distribution of the
+.\" software without specific, written prior permission.
+.\" M.I.T. makes no representations about the suitability of
+.\" this software for any purpose. It is provided "as is"
+.\" without express or implied warranty.
+.\"
+.\" SPDX-License-Identifier: MIT
+.\"
+.TH ARES_GETNAMEINFO 3 "1 May 2009"
+.SH NAME
+ares_getnameinfo \- Address-to-nodename translation in protocol-independent manner
+.SH SYNOPSIS
+.nf
+#include <ares.h>
+
+typedef void (*ares_nameinfo_callback)(void *\fIarg\fP, int \fIstatus\fP,
+ int \fItimeouts\fP, char *\fInode\fP,
+ char *\fIservice\fP)
+
+void ares_getnameinfo(ares_channel_t *\fIchannel\fP, const struct sockaddr *\fIsa\fP,
+ ares_socklen_t \fIsalen\fP, int \fIflags\fP,
+ ares_nameinfo_callback \fIcallback\fP, void *\fIarg\fP)
+.fi
+.SH DESCRIPTION
+The
+.B ares_getnameinfo
+function is defined for protocol-independent address translation. The function
+is a combination of \fIares_gethostbyaddr(3)\fP and \fIgetservbyport(3)\fP. The function will
+translate the address either by executing a host query on the name service channel
+identified by
+.IR channel
+or it will attempt to resolve it locally if possible.
+The parameters
+.I sa
+and
+.I len
+give the address as a sockaddr structure, and
+.I flags
+gives the options that the function will use. Valid flags are listed below:
+.TP 19
+.B ARES_NI_NOFQDN
+Only the nodename portion of the FQDN is returned for local hosts.
+.TP 19
+.B ARES_NI_NUMERICHOST
+The numeric form of the hostname is returned rather than the name.
+.TP 19
+.B ARES_NI_NAMEREQD
+An error is returned if the hostname cannot be found in the DNS.
+.TP 19
+.B ARES_NI_NUMERICSERV
+The numeric form of the service is returned rather than the name.
+.TP 19
+.B ARES_NI_TCP
+The service name is to be looked up for the TCP protocol.
+.TP 19
+.B ARES_NI_UDP
+The service name is to be looked up for the UDP protocol.
+.TP 19
+.B ARES_NI_SCTP
+The service name is to be looked up for the SCTP protocol.
+.TP 19
+.B ARES_NI_DCCP
+The service name is to be looked up for the DCCP protocol.
+.TP 19
+.B ARES_NI_NUMERICSCOPE
+The numeric form of the scope ID is returned rather than the name.
+.TP 19
+.B ARES_NI_LOOKUPHOST
+A hostname lookup is being requested.
+.TP 19
+.B ARES_NI_LOOKUPSERVICE
+A service name lookup is being requested.
+.PP
+When the query
+is complete or has
+failed, the ares library will invoke \fIcallback\fP. Completion or failure of
+the query may happen immediately, or may happen during a later call to
+\fIares_process(3)\fP, \fIares_destroy(3)\fP or \fIares_cancel(3)\fP.
+.PP
+If this is called from a thread other than which the main program event loop is
+running, care needs to be taken to ensure any file descriptor lists are updated
+immediately within the eventloop. When the associated callback is called,
+it is called with a channel lock so care must be taken to ensure any processing
+is minimal to prevent DNS channel stalls.
+.PP
+The callback argument
+.I arg
+is copied from the
+.B ares_getnameinfo
+argument
+.IR arg .
+The callback argument
+.I status
+indicates whether the query succeeded and, if not, how it failed. It
+may have any of the following values:
+.TP 19
+.B ARES_SUCCESS
+The host lookup completed successfully.
+.TP 19
+.B ARES_ENOTIMP
+The ares library does not know how to look up addresses of type
+.IR family .
+.TP 19
+.B ARES_ENOTFOUND
+The address
+.I addr
+was not found.
+.TP 19
+.B ARES_ENOMEM
+Memory was exhausted.
+.TP 19
+.B ARES_ECANCELLED
+The query was cancelled.
+.TP 19
+.B ARES_EDESTRUCTION
+The name service channel
+.I channel
+is being destroyed; the query will not be completed.
+.TP 19
+.B ARES_EBADFLAGS
+The
+.I flags
+parameter contains an illegal value.
+.PP
+The callback argument
+.I timeouts
+reports how many times a query timed out during the execution of the
+given request.
+.PP
+On successful completion of the query, the callback argument
+.I node
+contains a string representing the hostname (assuming
+.B ARES_NI_LOOKUPHOST
+was specified). Additionally,
+.I service
+contains a string representing the service name (assuming
+.B ARES_NI_LOOKUPSERVICE
+was specified).
+If the query did not complete successfully, or one of the values
+was not requested,
+.I node
+or
+.I service
+will be
+.BR NULL .
+.SH SEE ALSO
+.BR ares_process (3),
+.SH AUTHOR
+Dominick Meglio
+.br
+Copyright 2005 by Dominick Meglio.
diff --git a/subprojects/c-ares/docs/ares_getsock.3 b/subprojects/c-ares/docs/ares_getsock.3
@@ -0,0 +1,64 @@
+.\"
+.\" Copyright 1998 by Daniel Stenberg
+.\"
+.\" Permission to use, copy, modify, and distribute this
+.\" software and its documentation for any purpose and without
+.\" fee is hereby granted, provided that the above copyright
+.\" notice appear in all copies and that both that copyright
+.\" notice and this permission notice appear in supporting
+.\" documentation, and that the name of M.I.T. not be used in
+.\" advertising or publicity pertaining to distribution of the
+.\" software without specific, written prior permission.
+.\" M.I.T. makes no representations about the suitability of
+.\" this software for any purpose. It is provided "as is"
+.\" without express or implied warranty.
+.\"
+.\" SPDX-License-Identifier: MIT
+.\"
+.TH ARES_GETSOCK 3 "11 March 2010"
+.SH NAME
+ares_getsock \- get socket descriptors to wait on (deprecated)
+.SH SYNOPSIS
+.nf
+#include <ares.h>
+
+int ares_getsock(ares_channel_t *\fIchannel\fP, ares_socket_t *\fIsocks\fP,
+ int \fInumsocks\fP);
+.fi
+.SH DESCRIPTION
+The
+.B ares_getsock
+function retrieves the set of socket descriptors which the calling
+application should wait on for reading and/or writing for the
+processing of name service queries pending on the name service channel
+identified by
+.IR channel .
+Socket descriptors will be set in the socket descriptor array pointed to by
+\fIsocks\fP.
+\fInumsocks\fP is the size of the given array in number of ints.
+
+This function can only return information up to 16 sockets. If more are
+in use, they are simply not reported back.
+.SH RETURN VALUES
+\fBares_getsock\fP returns a bitmask for what actions to wait for on the
+different sockets. The ares.h header file provides these convenience macros to
+extract the information appropriately:
+
+.nf
+#define ARES_GETSOCK_MAXNUM 16 /* ares_getsock() can return info about
+ this many sockets */
+#define ARES_GETSOCK_READABLE(bits,num) (bits & (1<< (num)))
+#define ARES_GETSOCK_WRITABLE(bits,num) (bits & (1 << ((num) + \
+ ARES_GETSOCK_MAXNUM)))
+.fi
+.SH NOTES
+This function was added in c-ares 1.3.1 and deprecated in c-ares 1.20.0 due to
+the implementation of \fBARES_OPT_MAX_UDP_QUERIES\fP which makes it likely to
+exceed 16 open file descriptors.
+
+It is recommended to use socket state callbacks (\fBARES_OPT_SOCK_STATE_CB\fP)
+registered via \fBares_init_options(3)\fP.
+.SH SEE ALSO
+.BR ares_timeout (3),
+.BR ares_fds (3),
+.BR ares_process (3)
diff --git a/subprojects/c-ares/docs/ares_inet_ntop.3 b/subprojects/c-ares/docs/ares_inet_ntop.3
@@ -0,0 +1,49 @@
+.\"
+.\" Copyright (C) 2013 by Daniel Stenberg
+.\"
+.\" Permission to use, copy, modify, and distribute this
+.\" software and its documentation for any purpose and without
+.\" fee is hereby granted, provided that the above copyright
+.\" notice appear in all copies and that both that copyright
+.\" notice and this permission notice appear in supporting
+.\" documentation, and that the name of M.I.T. not be used in
+.\" advertising or publicity pertaining to distribution of the
+.\" software without specific, written prior permission.
+.\" M.I.T. makes no representations about the suitability of
+.\" this software for any purpose. It is provided "as is"
+.\" without express or implied warranty.
+.\"
+.\" SPDX-License-Identifier: MIT
+.\"
+.TH ARES_INET_NTOP 3 "17 Feb 2013"
+.SH NAME
+ares_inet_ntop \- convert a network format address to presentation format
+.SH SYNOPSIS
+.nf
+#include <ares.h>
+
+const char *ares_inet_ntop(int \fIaf\fP, const void *\fIsrc\fP, char *\fIdst\fP,
+ ares_socklen_t \fIsize\fP);
+.fi
+.SH DESCRIPTION
+This is a portable version with the identical functionality of the commonly
+available \fIinet_ntop\fP.
+
+The ares_inet_ntop() function converts a numeric address into a text string
+suitable for presentation. The \fBaf\fP argument shall specify the family of
+the address. This can be AF_INET or AF_INET6. The \fBsrc\fP argument points
+to a buffer holding an IPv4 address if the af argument is AF_INET, or an IPv6
+address if the af argument is AF_INET6; the address must be in network byte
+order. The \fBdst\fP argument points to a buffer where the function stores the
+resulting text string; it shall not be NULL. The \fBsize\fP argument specifies
+the size of this buffer, which shall be large enough to hold the text string
+(INET_ADDRSTRLEN (16) characters for IPv4, INET6_ADDRSTRLEN (46) characters
+for IPv6).
+.SH SEE ALSO
+.BR ares_init (3),
+.BR ares_inet_pton (3)
+.SH AVAILABILITY
+made properly publicly available in c-ares for real in version 1.10.0
+.SH AUTHOR
+Daniel Stenberg
+
diff --git a/subprojects/c-ares/docs/ares_inet_pton.3 b/subprojects/c-ares/docs/ares_inet_pton.3
@@ -0,0 +1,45 @@
+.\"
+.\" Copyright (C) 2013 by Daniel Stenberg
+.\"
+.\" Permission to use, copy, modify, and distribute this
+.\" software and its documentation for any purpose and without
+.\" fee is hereby granted, provided that the above copyright
+.\" notice appear in all copies and that both that copyright
+.\" notice and this permission notice appear in supporting
+.\" documentation, and that the name of M.I.T. not be used in
+.\" advertising or publicity pertaining to distribution of the
+.\" software without specific, written prior permission.
+.\" M.I.T. makes no representations about the suitability of
+.\" this software for any purpose. It is provided "as is"
+.\" without express or implied warranty.
+.\"
+.\" SPDX-License-Identifier: MIT
+.\"
+.TH ARES_INET_PTON 3 "17 Feb 2013"
+.SH NAME
+ares_inet_pton \- convert an IPv4 or IPv6 address from text to binary form
+.SH SYNOPSIS
+.nf
+#include <ares.h>
+
+const char *ares_inet_pton(int \fIaf\fP, const char *\fIsrc\fP, void *\fIdst\fP);
+.fi
+.SH DESCRIPTION
+This is a portable version with the identical functionality of the commonly
+available \fIinet_pton\fP.
+
+The ares_inet_pton() function converts the address in its standard text
+presentation form into its numeric binary form. The \fBaf\fP argument shall
+specify the family of the address. The AF_INET and AF_INET6 address families
+shall be supported. The \fBsrc\fP argument points to the string being passed
+in. The \fBdst\fP argument points to a buffer into which the function stores
+the numeric address; this shall be large enough to hold the numeric address
+(32 bits for AF_INET, 128 bits for AF_INET6).
+.SH SEE ALSO
+.BR ares_init (3),
+.BR ares_inet_ntop (3)
+.SH AVAILABILITY
+made properly publicly available in c-ares for real in version 1.10.0
+.SH AUTHOR
+Daniel Stenberg
+
diff --git a/subprojects/c-ares/docs/ares_init.3 b/subprojects/c-ares/docs/ares_init.3
@@ -0,0 +1,3 @@
+.\" Copyright (C) 2023 The c-ares project and its contributors.
+.\" SPDX-License-Identifier: MIT
+.so man3/ares_init_options.3
diff --git a/subprojects/c-ares/docs/ares_init_options.3 b/subprojects/c-ares/docs/ares_init_options.3
@@ -0,0 +1,346 @@
+.\"
+.\" Copyright 1998 by the Massachusetts Institute of Technology.
+.\" Copyright (C) 2004-2010 by Daniel Stenberg
+.\"
+.\" SPDX-License-Identifier: MIT
+.\"
+.TH ARES_INIT_OPTIONS 3 "5 March 2010"
+.SH NAME
+ares_init_options, ares_init \- Initialize a resolver channel
+.SH SYNOPSIS
+.nf
+#include <ares.h>
+
+struct ares_options {
+ int flags;
+ int timeout; /* in seconds or milliseconds, depending on options */
+ int tries;
+ int ndots;
+ unsigned short udp_port;
+ unsigned short tcp_port;
+ int socket_send_buffer_size;
+ int socket_receive_buffer_size;
+ struct in_addr *servers;
+ int nservers;
+ char **domains;
+ int ndomains;
+ char *lookups;
+ ares_sock_state_cb sock_state_cb;
+ void *sock_state_cb_data;
+ struct apattern *sortlist;
+ int nsort;
+ int ednspsz;
+ char *resolvconf_path;
+ char *hosts_path;
+ int udp_max_queries;
+ int maxtimeout; /* in milliseconds */
+ unsigned int qcache_max_ttl; /* in seconds */
+};
+
+int ares_init_options(ares_channel_t **\fIchannelptr\fP,
+ const struct ares_options *\fIoptions\fP,
+ int \fIoptmask\fP);
+
+int ares_init(ares_channel_t **\fIchannelptr\fP);
+
+.fi
+.SH DESCRIPTION
+The \fBares_init(3)\fP function is equivalent to calling
+\fBares_init_options(NULL, 0)\fP. It is recommended to use
+\fBares_init_options(3)\fP instead and to set or make configurable the
+appropriate options for your application.
+
+The \fBares_init_options(3)\fP function initializes a communications channel
+for name service lookups. If it returns successfully,
+\fBares_init_options(3)\fP will set the variable pointed to by
+\fIchannelptr\fP to a handle used to identify the name service channel. The
+caller should invoke \fIares_destroy(3)\fP on the handle when the channel is
+no longer needed.
+
+It is recommended for an application to have at most one ares channel and use
+this for all DNS queries for the life of the application. When system
+configuration changes, \fIares_reinit(3)\fP can be called to reload the
+configuration if necessary. The recommended concurrent query limit is about
+32k queries, but remembering that when specifying AF_UNSPEC for
+\fBares_getaddrinfo(3)\fP or \fBares_gethostbyname(3)\fP, they may spawn
+2 queries internally. The reason for the limit is c-ares does not allow
+duplicate DNS query ids (which have a maximum of 64k) to be oustanding at a
+given time, and it must randomly search for an available id thus 32k will limit
+the number of searches. This limitation should not be a concern for most
+implementations and c-ares may implement queuing in future releases to lift this
+limitation.
+
+The \fIoptmask\fP parameter generally specifies which fields in the structure pointed to
+by \fIoptions\fP are set, as follows:
+.TP 18
+.B ARES_OPT_FLAGS
+.B int \fIflags\fP;
+.br
+Flags controlling the behavior of the resolver:
+.RS 4
+.TP 23
+.B ARES_FLAG_USEVC
+Always use TCP queries (the "virtual circuit") instead of UDP
+queries. Normally, TCP is only used if a UDP query yields a truncated
+result.
+.TP 23
+.B ARES_FLAG_PRIMARY
+Only query the first server in the list of servers to query.
+.TP 23
+.B ARES_FLAG_IGNTC
+If a truncated response to a UDP query is received, do not fall back
+to TCP; simply continue on with the truncated response.
+.TP 23
+.B ARES_FLAG_NORECURSE
+Do not set the "recursion desired" bit on outgoing queries, so that the name
+server being contacted will not try to fetch the answer from other servers if
+it doesn't know the answer locally. Be aware that ares will not do the
+recursion for you. Recursion must be handled by the application calling ares
+if \fIARES_FLAG_NORECURSE\fP is set.
+.TP 23
+.B ARES_FLAG_STAYOPEN
+Do not close communications sockets when the number of active queries
+drops to zero.
+.TP 23
+.B ARES_FLAG_NOSEARCH
+Do not use the default search domains; only query hostnames as-is or
+as aliases.
+.TP 23
+.B ARES_FLAG_NOALIASES
+Do not honor the HOSTALIASES environment variable, which normally
+specifies a file of hostname translations.
+.TP 23
+.B ARES_FLAG_NOCHECKRESP
+Do not discard responses with the SERVFAIL, NOTIMP, or REFUSED
+response code or responses whose questions don't match the questions
+in the request. Primarily useful for writing clients which might be
+used to test or debug name servers.
+.TP 23
+.B ARES_FLAG_EDNS
+Include an EDNS pseudo-resource record (RFC 2671) in generated requests. As of
+v1.22, this is on by default if flags are otherwise not set.
+.RE
+.TP 18
+.B ARES_OPT_TIMEOUT
+.B int \fItimeout\fP;
+.br
+The number of seconds each name server is given to respond to a query on the
+first try. (After the first try, the timeout algorithm becomes more
+complicated, but scales linearly with the value of \fItimeout\fP.) The
+default is two seconds. This option is being deprecated by
+\fIARES_OPT_TIMEOUTMS\fP starting in c-ares 1.5.2.
+.TP 18
+.B ARES_OPT_TIMEOUTMS
+.B int \fItimeout\fP;
+.br
+The number of milliseconds each name server is given to respond to a query on
+the first try. (After the first try, the timeout algorithm becomes more
+complicated, but scales linearly with the value of \fItimeout\fP.) The
+default is two seconds. Note that this option is specified with the same
+struct field as the former \fIARES_OPT_TIMEOUT\fP, it is but the option bits
+that tell c-ares how to interpret the number. This option was added in c-ares
+1.5.2.
+.TP 18
+.B ARES_OPT_TRIES
+.B int \fItries\fP;
+.br
+The number of tries the resolver will try contacting each name server
+before giving up. The default is three tries.
+.TP 18
+.B ARES_OPT_NDOTS
+.B int \fIndots\fP;
+.br
+The number of dots which must be present in a domain name for it to be
+queried for "as is" prior to querying for it with the default domain
+extensions appended. The default value is 1 unless set otherwise by
+resolv.conf or the RES_OPTIONS environment variable.
+.TP 18
+.B ARES_OPT_MAXTIMEOUTMS
+.B int \fImaxtimeout\fP;
+.br
+The upper bound for timeout between sequential retry attempts. When retrying
+queries, the timeout is increased from the requested timeout parameter, this
+caps the value.
+.TP 18
+.B ARES_OPT_UDP_PORT
+.B unsigned short \fIudp_port\fP;
+.br
+The port to use for queries over UDP, in host byte order.
+The default value is 53, the standard name service port.
+.TP 18
+.B ARES_OPT_TCP_PORT
+.B unsigned short \fItcp_port\fP;
+.br
+The port to use for queries over TCP, in host byte order.
+The default value is 53, the standard name service port.
+.TP 18
+.B ARES_OPT_SERVERS
+.B struct in_addr *\fIservers\fP;
+.br
+.B int \fInservers\fP;
+.br
+The list of IPv4 servers to contact, instead of the servers specified in
+resolv.conf or the local named. In order to allow specification of either IPv4
+or IPv6 name servers, the \Bares_set_servers(3)\fP function must be used
+instead.
+.TP 18
+.B ARES_OPT_DOMAINS
+.B char **\fIdomains\fP;
+.br
+.B int \fIndomains\fP;
+.br
+The domains to search, instead of the domains specified in resolv.conf
+or the domain derived from the kernel hostname variable.
+.TP 18
+.B ARES_OPT_LOOKUPS
+.B char *\fIlookups\fP;
+.br
+The lookups to perform for host queries.
+.I lookups
+should be set to a string of the characters "b" or "f", where "b"
+indicates a DNS lookup and "f" indicates a lookup in the hosts file.
+.TP 18
+.B ARES_OPT_SOCK_STATE_CB
+.B void (*\fIsock_state_cb\fP)(void *data, ares_socket_t socket_fd, int readable, int writable);
+.br
+.B void *\fIsock_state_cb_data\fP;
+.br
+A callback function to be invoked when a socket changes state.
+.I socket_fd
+will be passed the socket whose state has changed;
+.I readable
+will be set to true if the socket should listen for read events, and
+.I writable
+will be set to true if the socket should listen for write events.
+The value of
+.I sock_state_cb_data
+will be passed as the
+.I data
+argument.
+.TP 18
+.B ARES_OPT_SORTLIST
+.B struct apattern *\fIsortlist\fP;
+.br
+.B int \fInsort\fP;
+.br
+A list of IP address ranges that specifies the order of preference that
+results from \fIares_gethostbyname\fP should be returned in. Note that
+this can only be used with a sortlist retrieved via
+\fBares_save_options(3)\fP (because
+.B struct apattern
+is opaque); to set a fresh sort list, use \fBares_set_sortlist(3)\fP.
+.TP 18
+.B ARES_OPT_SOCK_SNDBUF
+.B int \fIsocket_send_buffer_size\fP;
+.br
+The send buffer size to set for the socket.
+.TP 18
+.B ARES_OPT_SOCK_RCVBUF
+.B int \fIsocket_receive_buffer_size\fP;
+.br
+The receive buffer size to set for the socket.
+.TP 18
+.B ARES_OPT_EDNSPSZ
+.B int \fIednspsz\fP;
+.br
+The message size to be advertised in EDNS; only takes effect if the
+.B ARES_FLAG_EDNS
+flag is set. Defaults to 1280, the recommended size.
+.TP 18
+.B ARES_OPT_RESOLVCONF
+.B char *\fIresolvconf_path\fP;
+.br
+The path to use for reading the resolv.conf file. The
+.I resolvconf_path
+should be set to a path string, and will be honoured on *nix like systems. The
+default is
+.B /etc/resolv.conf
+.br
+.TP 18
+.B ARES_OPT_HOSTS_FILE
+.B char *\fIhosts_path\fP;
+.br
+The path to use for reading the hosts file. The
+.I hosts_path
+should be set to a path string, and will be honoured on *nix like systems. The
+default is
+.B /etc/hosts
+.br
+.TP 18
+.B ARES_OPT_UDP_MAX_QUERIES
+.B int \fIudp_max_queries\fP;
+.br
+The maximum number of udp queries that can be sent on a single ephemeral port
+to a given DNS server before a new ephemeral port is assigned. Any value of 0
+or less will be considered unlimited, and is the default.
+.br
+.TP 18
+.B ARES_OPT_QUERY_CACHE
+.B unsigned int \fIqcache_max_ttl\fP;
+.br
+Enable the built-in query cache. Will cache queries based on the returned TTL
+in the DNS message. Only fully successful and NXDOMAIN query results will be
+cached. Fill in the \fIqcache_max_ttl\fP with the maximum number of seconds
+a query result may be cached which will override a larger TTL in the response
+message. This must be a non-zero value otherwise the cache will be disabled.
+Choose a reasonable value for your application such as 300 (5 minutes) or
+3600 (1 hour).
+.br
+.PP
+The \fIoptmask\fP parameter also includes options without a corresponding
+field in the
+.B ares_options
+structure, as follows:
+.TP 23
+.B ARES_OPT_ROTATE
+Perform round-robin selection of the nameservers configured for the channel
+for each resolution.
+.TP 23
+.B ARES_OPT_NOROTATE
+Do not perform round-robin nameserver selection; always use the list of
+nameservers in the same order.
+.PP
+
+.SH RETURN VALUES
+\fBares_init_options(3)\fP and \fBares_init(3)\fP can return any of the
+following values:
+.TP 14
+.B ARES_SUCCESS
+Initialization succeeded.
+.TP 14
+.B ARES_EFILE
+A configuration file could not be read.
+.TP 14
+.B ARES_ENOMEM
+The process's available memory was exhausted.
+.TP 14
+.B ARES_ENOTINITIALIZED
+c-ares library initialization not yet performed.
+.SH NOTES
+When initializing from
+.B /etc/resolv.conf,
+(or, alternatively when specified by the
+.I resolvconf_path
+path location)
+\fBares_init_options(3)\fP and \fBares_init(3)\fP reads the \fIdomain\fP and
+\fIsearch\fP directives to allow lookups of short names relative to the domains
+specified. The \fIdomain\fP and \fIsearch\fP directives override one another.
+If more than one instance of either \fIdomain\fP or \fIsearch\fP directives is
+specified, the last occurrence wins. For more information, please see the
+.BR resolv.conf (5)
+manual page.
+.SH SEE ALSO
+.BR ares_reinit (3),
+.BR ares_destroy (3),
+.BR ares_dup (3),
+.BR ares_library_init (3),
+.BR ares_save_options (3),
+.BR ares_set_servers (3),
+.BR ares_set_sortlist (3),
+.BR ares_threadsafety (3)
+.SH AUTHOR
+Greg Hudson, MIT Information Systems
+.br
+Copyright 1998 by the Massachusetts Institute of Technology.
+.br
+Copyright (C) 2004-2010 by Daniel Stenberg.
diff --git a/subprojects/c-ares/docs/ares_library_cleanup.3 b/subprojects/c-ares/docs/ares_library_cleanup.3
@@ -0,0 +1,85 @@
+.\"
+.\" Copyright 1998 by the Massachusetts Institute of Technology.
+.\" Copyright (C) 2004-2009 by Daniel Stenberg
+.\"
+.\" Permission to use, copy, modify, and distribute this
+.\" software and its documentation for any purpose and without
+.\" fee is hereby granted, provided that the above copyright
+.\" notice appear in all copies and that both that copyright
+.\" notice and this permission notice appear in supporting
+.\" documentation, and that the name of M.I.T. not be used in
+.\" advertising or publicity pertaining to distribution of the
+.\" software without specific, written prior permission.
+.\" M.I.T. makes no representations about the suitability of
+.\" this software for any purpose. It is provided "as is"
+.\" without express or implied warranty.
+.\"
+.\" SPDX-License-Identifier: MIT
+.\"
+.TH ARES_LIBRARY_CLEANUP 3 "19 May 2009"
+.SH NAME
+ares_library_cleanup \- c-ares library deinitialization
+.SH SYNOPSIS
+.nf
+#include <ares.h>
+
+void ares_library_cleanup(void)
+.fi
+.SH DESCRIPTION
+.PP
+The
+.B ares_library_cleanup
+function uninitializes the c-ares library, freeing all resources
+previously acquired by \fIares_library_init(3)\fP when the library
+was initialized, provided there was only one single previous call to
+\fIares_library_init(3)\fP. If there was more than one previous call to
+\fIares_library_init(3)\fP, this function uninitializes the c-ares
+library only if it is the call matching the call to
+\fIares_library_init(3)\fP which initialized the library
+(usually the very first call to \fIares_library_init(3)\fP).
+Other calls to \fIares_library_cleanup(3)\fP have no effect other than
+decrementing an internal counter.
+.PP
+This function must be called when the program using c-ares will
+no longer need any c-ares function. Once the program has called
+\fIares_library_cleanup(3)\fP sufficiently often such that the
+library is uninitialised, it shall not make any further call to any
+c-ares function.
+.PP
+This function does not cancel any pending c-ares lookups or requests
+previously done. Program must use \fIares_cancel(3)\fP for this purpose.
+.PP
+.B This function is not thread safe.
+You have to call it once the program is about to terminate, but this call must
+be done once the program has terminated every single thread that it could have
+initiated. This is required to avoid potential race conditions in library
+deinitialization, and also due to the fact that \fIares_library_cleanup(3)\fP
+might call functions from other libraries that are thread unsafe, and could
+conflict with any other thread that is already using these other libraries.
+.PP
+Win32/64 application DLLs shall not call \fIares_library_cleanup(3)\fP from
+the DllMain function. Doing so will produce deadlocks and other problems.
+.SH AVAILABILITY
+This function was first introduced in c-ares version 1.7.0 along with the
+definition of preprocessor symbol \fICARES_HAVE_ARES_LIBRARY_CLEANUP\fP as an
+indication of the availability of this function. Reference counting in
+\fIares_library_init(3)\fP and \fIares_library_cleanup(3)\fP, which requires
+calls to the former function to match calls to the latter, is present since
+c-ares version 1.10.0. Earlier versions would deinitialize the library on the
+first call to \fIares_library_cleanup(3)\fP.
+.PP
+Since the introduction of this function, it is absolutely mandatory to call it
+for any Win32/64 program using c-ares.
+.PP
+Non-Win32/64 systems can still use c-ares version 1.7.0 without calling
+\fIares_library_cleanup(3)\fP due to the fact that \fIcurrently\fP it is nearly
+a do-nothing function on non-Win32/64 platforms.
+.SH SEE ALSO
+.BR ares_library_init (3),
+.BR ares_cancel (3)
+.SH AUTHOR
+Yang Tse
+.PP
+Copyright 1998 by the Massachusetts Institute of Technology.
+.br
+Copyright (C) 2004-2009 by Daniel Stenberg.
diff --git a/subprojects/c-ares/docs/ares_library_init.3 b/subprojects/c-ares/docs/ares_library_init.3
@@ -0,0 +1,117 @@
+.\"
+.\" Copyright 1998 by the Massachusetts Institute of Technology.
+.\" Copyright (C) 2004-2009 by Daniel Stenberg
+.\"
+.\" Permission to use, copy, modify, and distribute this
+.\" software and its documentation for any purpose and without
+.\" fee is hereby granted, provided that the above copyright
+.\" notice appear in all copies and that both that copyright
+.\" notice and this permission notice appear in supporting
+.\" documentation, and that the name of M.I.T. not be used in
+.\" advertising or publicity pertaining to distribution of the
+.\" software without specific, written prior permission.
+.\" M.I.T. makes no representations about the suitability of
+.\" this software for any purpose. It is provided "as is"
+.\" without express or implied warranty.
+.\"
+.\" SPDX-License-Identifier: MIT
+.\"
+.TH ARES_LIBRARY_INIT 3 "19 May 2009"
+.SH NAME
+ares_library_init \- c-ares library initialization
+.SH SYNOPSIS
+.nf
+#include <ares.h>
+
+int ares_library_init(int \fIflags\fP)
+
+int ares_library_init_mem(int \fIflags\fP,
+ void *(*\fIamalloc\fP)(size_t),
+ void (*\fIafree\fP)(void *ptr),
+ void (*\fIarealloc\fP)(void *ptr, size_t size))
+.fi
+.SH DESCRIPTION
+.PP
+The
+.B ares_library_init
+function performs initializations internally required by the c-ares
+library that must take place before any other function provided by
+c-ares can be used in a program.
+.PP
+This function must be called at least once within the life of a program,
+before the program actually executes any other c-ares library function.
+Initializations done by this function remain effective until a number of
+calls to \fIares_library_cleanup(3)\fP equal to the number of calls to
+this function are performed.
+.PP
+Successive calls to this function do nothing further, only the first
+call done when c-ares is in an uninitialized state is actually
+effective.
+.PP
+The
+.I flags
+parameter is a bit pattern that tells c-ares exactly which features
+should be initialized, as described below. Set the desired bits by
+ORing the values together. In normal operation you should specify
+\fIARES_LIB_INIT_ALL\fP. Don't use any other value unless you are
+familiar with it and trying to control some internal c-ares feature.
+.PP
+The
+.B ares_library_init_mem
+function allows the caller to provide memory management functions that the
+c-ares library will be use instead of \fImalloc(3)\fP, \fIfree(3)\fP and
+\fIrealloc(3)\fP.
+.PP
+.B This function is not thread safe.
+You have to call it once the program has started, but this call must be done
+before the program starts any other thread. This is required to avoid
+potential race conditions in library initialization, and also due to the fact
+that \fIares_library_init(3)\fP might call functions from other libraries that
+are thread unsafe, and could conflict with any other thread that is already
+using these other libraries.
+.PP
+On Windows platforms, the library user should ensure that \fIWSAStartup()\fP
+is called before the c-ares library is initialized and used.
+.PP
+Win32/64 application DLLs shall not call \fIares_library_init(3)\fP from the
+DllMain function. Doing so will produce deadlocks and other problems.
+.SH FLAGS
+.TP 5
+.B ARES_LIB_INIT_ALL
+Initialize everything possible. This sets all known bits.
+.TP
+.B ARES_LIB_INIT_WIN32
+Initialize Win32/64 specific libraries. As of c-ares 1.19.0, this is ignored
+as there are no currently dynamically loaded libraries.
+.TP
+.B ARES_LIB_INIT_NONE
+Initialize nothing extra. This sets no bit.
+.SH RETURN VALUE
+Upon successful completion, \fIares_library_init(3)\fP returns 0. Otherwise,
+a non-zero error number is returned to indicate the error. Except for
+\fIares_strerror(3)\fP, you shall not call any other c-ares function upon
+\fIares_library_init(3)\fP failure.
+.SH AVAILABILITY
+This function was first introduced in c-ares version 1.7.0 along with the
+definition of preprocessor symbol \fICARES_HAVE_ARES_LIBRARY_INIT\fP as an
+indication of the availability of this function. Its recursive behavior, which
+requires a matching number of calls to \fIares_library_cleanup(3)\fP in order
+to deinitialize the library, is present since c-ares version 1.10.0. Earlier
+versions would deinitialize the library on the first call to
+\fIares_library_cleanup(3)\fP.
+.PP
+Since the introduction of this function it is absolutely mandatory to
+call it for any Win32/64 program using c-ares.
+.PP
+Non-Win32/64 systems can still use c-ares version 1.7.0 without calling
+\fIares_library_init(3)\fP due to the fact that \fIcurrently\fP it is nearly
+a do-nothing function on non-Win32/64 platforms at this point.
+.SH SEE ALSO
+.BR ares_library_cleanup (3),
+.BR ares_strerror (3)
+.SH AUTHOR
+Yang Tse
+.PP
+Copyright 1998 by the Massachusetts Institute of Technology.
+.br
+Copyright (C) 2004-2009 by Daniel Stenberg.
diff --git a/subprojects/c-ares/docs/ares_library_init_android.3 b/subprojects/c-ares/docs/ares_library_init_android.3
@@ -0,0 +1,144 @@
+.\"
+.\" Copyright (C) 2017 by John Schember
+.\"
+.\" Permission to use, copy, modify, and distribute this
+.\" software and its documentation for any purpose and without
+.\" fee is hereby granted, provided that the above copyright
+.\" notice appear in all copies and that both that copyright
+.\" notice and this permission notice appear in supporting
+.\" documentation, and that the name of M.I.T. not be used in
+.\" advertising or publicity pertaining to distribution of the
+.\" software without specific, written prior permission.
+.\" M.I.T. makes no representations about the suitability of
+.\" this software for any purpose. It is provided "as is"
+.\" without express or implied warranty.
+.\"
+.\" SPDX-License-Identifier: MIT
+.\"
+.TH ARES_LIBRARY_INIT_ANDROID 3 "13 Sept 2017"
+.SH NAME
+ares_library_init_android \- c-ares library Android initialization
+.SH SYNOPSIS
+.nf
+#include <ares.h>
+
+int ares_library_init_android(jobject \fIconnectivity_manager\fP)
+
+int ares_library_android_initialized();
+
+void ares_library_init_jvm(JavaVM *\fIjvm\fP)
+
+.fi
+.SH DESCRIPTION
+The \fIares_library_init_android(3)\fP function performs initializations
+internally required by the c-ares library when used on Android. This can take
+place anytime after \fIares_library_init(3)\fP. It must take place after
+\fIares_library_init_jvm\fP. ares_library_init_android must be called before
+DNS resolution will work on Android 8 (Oreo) or newer when targetSdkVersion is
+set to 26+.
+
+As of Android 8 (API level 26) getting DNS server information has
+becomei more restrictive and can only be accessed using the
+Connectivity Manager. It is necessary to pass the connectivity
+manager to c-ares via JNI. Also, the ACCESS_NETWORK_STATE permission
+must be present in the Android application.
+
+Android older than 8 do not need to to be initialized as they
+are less restrictive. However, this is a run time not compile time
+limitation. Proper Android initialization should take place regardless
+of the targeted Android version.
+
+Deinitialization will take place though \fIares_library_cleanup(3)\fP.
+
+The \fBares_library_init_jvm\fP function allows the caller to register the JVM
+with c-ares. It's meant to be called during JNI_OnLoad because you're
+guaranteed to have the JVM in that function. The JVM is required in order to
+use the Connectivity Manager registered using
+\fIares_library_init_android(3)\fP. This must be call before
+\fIares_library_init_android(3)\fP.
+
+The \fBares_library_android_initialized\fP function can be used to check
+whether c-ares has been initialized for use with Android.
+.SH RETURN VALUES
+ARES_SUCCESS will be returned on success otherwise an error code will be
+returned.
+.SH THREAD SAFETY
+.B These init functions are not thread safe.
+You have to call it once the program has started, but this call must be done
+before the program starts any other thread. This is required to avoid
+potential race conditions in library initialization, and also due to the fact
+these might call functions from other libraries that
+are thread unsafe, and could conflict with any other thread that is already
+using these other libraries.
+.SH JNI
+Accessing the Connectivity Manager though Java:
+
+Register the \fIares_library_android_init\fP.
+.nf
+ static JNINativeMethod funcs[] = {
+ { "initialize_native", "(Landroid/net/ConnectivityManager;)I",
+ (void *)&ares_library_init_android}
+ };
+
+ JNIEXPORT jint JNICALL JNI_OnLoad(JavaVM *vm, void *reserved)
+ {
+ JNIEnv *env = NULL;
+ jclass cls = NULL;
+ jint res;
+
+ if ((*vm)->GetEnv(vm, (void **)&env, JNI_VERSION_1_6) != JNI_OK)
+ return -1;
+
+ cls = (*env)->FindClass(env, JNIT_CLASS);
+ if (cls == NULL)
+ return -1;
+
+ res = (*env)->RegisterNatives(env, cls, funcs, sizeof(funcs)/sizeof(funcs[0]));
+ if (res != 0)
+ return -1;
+
+ ares_library_init_jvm(vm);
+ return JNI_VERSION_1_6;
+ }
+.fi
+Calling the registered function from Java:
+.nf
+ public class MyObject {
+ static {
+ System.loadLibrary("cares");
+ }
+
+ private static native boolean initialize_native(ConnectivityManager
+ connectivity_manager);
+
+ public static boolean initialize(Context context) {
+ initialize_native((ConnectivityManager)context.getSystemService(Context.CONNECTIVITY_SERVICE));
+ }
+ }
+.fi
+Initializing the Connectivity Manager in JNI directly using an Android
+Context. It is assumed the JVM has already been registered through
+\fIJNI_OnLoad\fP.
+.nf
+ void initialize(jobject android_context)
+ {
+ jclass obj_cls = jni_get_class(env, "android/content/Context");
+ jmethodID obj_mid = jni_get_method_id(env, obj_cls, "getSystemService", "(Ljava/lang/String;)Ljava/lang/Object;");
+ jfieldID fid = (*env)->GetStaticFieldID(env, obj_cls, "CONNECTIVITY_SERVICE", "Ljava/lang/String;");
+ jstring str = (*env)->GetStaticObjectField(env, obj_cls, fid);
+ connectivity_manager = (*env)->CallObjectMethod(env, android_context, obj_mid, str);
+ if (connectivity_manager == NULL)
+ return;
+ ares_library_init_android(connectivity_manager);
+ }
+.fi
+.SH AVAILABILITY
+This function was first introduced in c-ares version 1.15.0.
+.SH SEE ALSO
+.BR ares_library_init (3),
+.BR ares_library_cleanup (3),
+.SH AUTHOR
+John Schember
+.PP
+Copyright (C) 2017 by John Schember
+
diff --git a/subprojects/c-ares/docs/ares_library_initialized.3 b/subprojects/c-ares/docs/ares_library_initialized.3
@@ -0,0 +1,36 @@
+.\"
+.\" Copyright (C) 2016 by Daniel Stenberg
+.\"
+.\" Permission to use, copy, modify, and distribute this
+.\" software and its documentation for any purpose and without
+.\" fee is hereby granted, provided that the above copyright
+.\" notice appear in all copies and that both that copyright
+.\" notice and this permission notice appear in supporting
+.\" documentation, and that the name of M.I.T. not be used in
+.\" advertising or publicity pertaining to distribution of the
+.\" software without specific, written prior permission.
+.\" M.I.T. makes no representations about the suitability of
+.\" this software for any purpose. It is provided "as is"
+.\" without express or implied warranty.
+.\"
+.\" SPDX-License-Identifier: MIT
+.\"
+.TH ARES_LIBRARY_INITIALIZED 3 "29 Sep 2016"
+.SH NAME
+ares_library_initialized \- get the initialization state
+.SH SYNOPSIS
+.nf
+#include <ares.h>
+
+int ares_library_initialized(void)
+.fi
+.SH DESCRIPTION
+Returns information if c-ares needs to get initialized.
+.SH RETURN VALUE
+\fIARES_ENOTINITIALIZED\fP if not initialized and \fIARES_SUCCESS\fP if no
+initialization is needed.
+.SH AVAILABILITY
+This function was first introduced in c-ares version 1.11.0
+.SH SEE ALSO
+.BR ares_library_init (3),
+.BR ares_library_cleanup (3)
diff --git a/subprojects/c-ares/docs/ares_mkquery.3 b/subprojects/c-ares/docs/ares_mkquery.3
@@ -0,0 +1,92 @@
+.\"
+.\" Copyright 1998, 2000 by the Massachusetts Institute of Technology.
+.\"
+.\" Permission to use, copy, modify, and distribute this
+.\" software and its documentation for any purpose and without
+.\" fee is hereby granted, provided that the above copyright
+.\" notice appear in all copies and that both that copyright
+.\" notice and this permission notice appear in supporting
+.\" documentation, and that the name of M.I.T. not be used in
+.\" advertising or publicity pertaining to distribution of the
+.\" software without specific, written prior permission.
+.\" M.I.T. makes no representations about the suitability of
+.\" this software for any purpose. It is provided "as is"
+.\" without express or implied warranty.
+.\"
+.\" SPDX-License-Identifier: MIT
+.\"
+.TH ARES_MKQUERY 3 "20 Nov 2009"
+.SH NAME
+ares_mkquery \- Compose a single-question DNS query buffer
+.SH SYNOPSIS
+.nf
+#include <ares.h>
+
+int ares_mkquery(const char *\fIname\fP, int \fIdnsclass\fP, int \fItype\fP,
+ unsigned short \fIid\fP, int \fIrd\fP, unsigned char **\fIbuf\fP,
+ int *\fIbuflen\fP)
+.fi
+.SH DESCRIPTION
+Deprecated function. See \fIares_create_query(3)\fP instead!
+
+The
+.B ares_mkquery
+function composes a DNS query with a single question.
+The parameter
+.I name
+gives the query name as a NUL-terminated C string of period-separated
+labels optionally ending with a period; periods and backslashes within
+a label must be escaped with a backlash. The parameters
+.I dnsclass
+and
+.I type
+give the class and type of the query using the values defined in
+.BR <arpa/nameser.h> .
+The parameter
+.I id
+gives a 16-bit identifier for the query. The parameter
+.I rd
+should be nonzero if recursion is desired, zero if not. The query
+will be placed in an allocated buffer, a pointer to which will be
+stored in the variable pointed to by
+.IR buf ,
+and the length of which will be stored in the variable pointed to by
+.IR buflen .
+It is the caller's responsibility to free this buffer using
+\fIares_free_string(3)\fP when it is no longer needed.
+
+Usage of \fIares_mkquery(3)\fP is deprecated, whereas the function is
+equivalent to \fIares_create_query(3)\fP with \fBmax_udp_size\fP set to
+0.
+
+.SH RETURN VALUES
+.B ares_mkquery
+can return any of the following values:
+.TP 15
+.B ARES_SUCCESS
+Construction of the DNS query succeeded.
+.TP 15
+.B ARES_ENOTFOUND
+The query name
+.I name
+refers to a
+.I .onion
+domain name. See RFC 7686.
+.TP 15
+.B ARES_EBADNAME
+The query name
+.I name
+could not be encoded as a domain name, either because it contained a
+zero-length label or because it contained a label of more than 63
+characters.
+.TP 15
+.B ARES_ENOMEM
+Memory was exhausted.
+.SH SEE ALSO
+.BR ares_expand_name (3),
+.BR ares_dns_record (3),
+.BR ares_free_string (3)
+.SH AUTHOR
+Greg Hudson, MIT Information Systems
+.br
+Copyright 1998, 2000 by the Massachusetts Institute of Technology.
diff --git a/subprojects/c-ares/docs/ares_opt_param_t.3 b/subprojects/c-ares/docs/ares_opt_param_t.3
@@ -0,0 +1,4 @@
+.\"
+.\" Copyright (C) Daniel Stenberg
+.\" SPDX-License-Identifier: MIT
+.so man3/ares_dns_mapping.3
diff --git a/subprojects/c-ares/docs/ares_parse_a_reply.3 b/subprojects/c-ares/docs/ares_parse_a_reply.3
@@ -0,0 +1,82 @@
+.\"
+.\" Copyright 1998 by the Massachusetts Institute of Technology.
+.\"
+.\" Permission to use, copy, modify, and distribute this
+.\" software and its documentation for any purpose and without
+.\" fee is hereby granted, provided that the above copyright
+.\" notice appear in all copies and that both that copyright
+.\" notice and this permission notice appear in supporting
+.\" documentation, and that the name of M.I.T. not be used in
+.\" advertising or publicity pertaining to distribution of the
+.\" software without specific, written prior permission.
+.\" M.I.T. makes no representations about the suitability of
+.\" this software for any purpose. It is provided "as is"
+.\" without express or implied warranty.
+.\"
+.\" SPDX-License-Identifier: MIT
+.\"
+.TH ARES_PARSE_A_REPLY 3 "25 July 1998"
+.SH NAME
+ares_parse_a_reply \- Parse a reply to a DNS query of type A
+.SH SYNOPSIS
+.nf
+#include <ares.h>
+
+int ares_parse_a_reply(const unsigned char *\fIabuf\fP, int \fIalen\fP,
+ struct hostent **\fIhost\fP,
+ struct ares_addrttl *\fIaddrttls\fP, int *\fInaddrttls\fP);
+.fi
+.SH DESCRIPTION
+The
+.B ares_parse_a_reply
+function parses the response to a query of type A into a
+.BR "struct hostent"
+and/or an array of
+.BR "struct ares_addrttls" .
+The parameters
+.I abuf
+and
+.I alen
+give the contents of the response. The result is stored in allocated
+memory and a pointer to it stored into the variable pointed to by
+.IR host ,
+if host is nonnull.
+It is the caller's responsibility to free the resulting host structure
+using
+.BR ares_free_hostent (3)
+when it is no longer needed.
+.PP
+If
+.IR addrttls
+and
+.IR naddrttls
+are both nonnull,
+then up to *naddrttls
+.BR "struct ares_addrttl"
+records are stored in the array pointed to by addrttls,
+and then *naddrttls is set to the number of records so stored.
+Note that the memory for these records is supplied by the caller.
+.SH RETURN VALUES
+.B ares_parse_a_reply
+can return any of the following values:
+.TP 15
+.B ARES_SUCCESS
+The response was successfully parsed.
+.TP 15
+.B ARES_EBADRESP
+The response was malformatted.
+.TP 15
+.B ARES_ENODATA
+The response did not contain an answer to the query.
+.TP 15
+.B ARES_ENOMEM
+Memory was exhausted.
+.SH SEE ALSO
+.BR ares_gethostbyname (3),
+.BR ares_free_hostent (3)
+.SH AUTHOR
+Greg Hudson, MIT Information Systems
+.br
+Andrew Selivanov <andrew.selivanov@gmail.com>
+.br
+Copyright 1998 by the Massachusetts Institute of Technology.
diff --git a/subprojects/c-ares/docs/ares_parse_aaaa_reply.3 b/subprojects/c-ares/docs/ares_parse_aaaa_reply.3
@@ -0,0 +1,82 @@
+.\"
+.\" Copyright 2005 by Dominick Meglio.
+.\"
+.\" Permission to use, copy, modify, and distribute this
+.\" software and its documentation for any purpose and without
+.\" fee is hereby granted, provided that the above copyright
+.\" notice appear in all copies and that both that copyright
+.\" notice and this permission notice appear in supporting
+.\" documentation, and that the name of M.I.T. not be used in
+.\" advertising or publicity pertaining to distribution of the
+.\" software without specific, written prior permission.
+.\" M.I.T. makes no representations about the suitability of
+.\" this software for any purpose. It is provided "as is"
+.\" without express or implied warranty.
+.\"
+.\" SPDX-License-Identifier: MIT
+.\"
+.TH ARES_PARSE_AAAA_REPLY 3 "20 Nov 2009"
+.SH NAME
+ares_parse_aaaa_reply \- Parse a reply to a DNS query of type AAAA
+.SH SYNOPSIS
+.nf
+#include <ares.h>
+
+int ares_parse_aaaa_reply(const unsigned char *\fIabuf\fP, int \fIalen\fP,
+ struct hostent **\fIhost\fP,
+ struct ares_addr6ttl *\fIaddrttls\fP, int *\fInaddrttls\fP);
+.fi
+.SH DESCRIPTION
+The
+.B ares_parse_aaaa_reply
+function parses the response to a query of type AAAA into a
+.BR "struct hostent"
+and/or an array of
+.BR "struct ares_addr6ttl" .
+The parameters
+.I abuf
+and
+.I alen
+give the contents of the response. The result is stored in allocated
+memory and a pointer to it stored into the variable pointed to by
+.IR host ,
+if host is nonnull.
+It is the caller's responsibility to free the resulting host structure
+using
+.BR ares_free_hostent (3)
+when it is no longer needed.
+.PP
+If
+.IR addrttls
+and
+.IR naddrttls
+are both nonnull,
+then up to *naddrttls
+.BR "struct ares_addr6ttl"
+records are stored in the array pointed to by addrttls,
+and then *naddrttls is set to the number of records so stored.
+Note that the memory for these records is supplied by the caller.
+.SH RETURN VALUES
+.B ares_parse_aaaa_reply
+can return any of the following values:
+.TP 15
+.B ARES_SUCCESS
+The response was successfully parsed.
+.TP 15
+.B ARES_EBADRESP
+The response was malformatted.
+.TP 15
+.B ARES_ENODATA
+The response did not contain an answer to the query.
+.TP 15
+.B ARES_ENOMEM
+Memory was exhausted.
+.SH SEE ALSO
+.BR ares_gethostbyname (3),
+.BR ares_free_hostent (3)
+.SH AUTHOR
+Dominick Meglio
+.br
+Copyright 2005 by Dominick Meglio.
+.BR
+Andrew Selivanov <andrew.selivanov@gmail.com>
diff --git a/subprojects/c-ares/docs/ares_parse_caa_reply.3 b/subprojects/c-ares/docs/ares_parse_caa_reply.3
@@ -0,0 +1,173 @@
+.\"
+.\" Copyright 2020 Danny Sonnenschein <my.card.god@web.de>
+.\"
+.\" Permission to use, copy, modify, and distribute this
+.\" software and its documentation for any purpose and without
+.\" fee is hereby granted, provided that the above copyright
+.\" notice appear in all copies and that both that copyright
+.\" notice and this permission notice appear in supporting
+.\" documentation, and that the name of M.I.T. not be used in
+.\" advertising or publicity pertaining to distribution of the
+.\" software without specific, written prior permission.
+.\" M.I.T. makes no representations about the suitability of
+.\" this software for any purpose. It is provided "as is"
+.\" without express or implied warranty.
+.\"
+.\" SPDX-License-Identifier: MIT
+.\"
+.TH ARES_PARSE_CAA_REPLY 3 "16 September 2020"
+.SH NAME
+ares_parse_caa_reply \- Parse a reply to a DNS query of type CAA
+.SH SYNOPSIS
+.nf
+#include <ares.h>
+
+int ares_parse_caa_reply(const unsigned char* \fIabuf\fP, int \fIalen\fP,
+ struct ares_caa_reply **\fIcaa_out\fP);
+.fi
+.SH DESCRIPTION
+The
+.BR "ares_parse_caa_reply"
+function parses the response to a query of type CAA into a
+linked list (one element per sub-string) of
+.IR "struct ares_caa_reply"
+The parameters
+.I abuf
+and
+.I alen
+give the contents of the response. The result is stored in allocated
+memory and a pointer to it stored into the variable pointed to by
+.IR caa_out .
+It is the caller's responsibility to free the resulting
+.IR caa_out
+structure when it is no longer needed using the function
+.B ares_free_data(3)
+.PP
+The structure
+.I ares_caa_reply(3)
+contains the following fields:
+.sp
+.in +4n
+.nf
+struct ares_caa_reply {
+ struct ares_caa_reply *next;
+ int critical;
+ unsigned char *property;
+ size_t plength; /* plength excludes null */
+ unsigned char *value;
+ size_t length; /* length excludes null */
+};
+.fi
+.in
+.PP
+.SH RETURN VALUES
+.BR "ares_parse_caa_reply"
+can return any of the following values:
+.TP 15
+.B ARES_SUCCESS
+The response was successfully parsed.
+.TP 15
+.B ARES_EBADRESP
+The response was malformatted.
+.TP 15
+.B ARES_ENODATA
+The response did not contain an answer to the query.
+.TP 15
+.B ARES_ENOMEM
+Memory was exhausted.
+.SH EXAMPLE
+.nf
+#include <arpa/inet.h>
+#include <time.h>
+#include <sys/time.h>
+#include <netdb.h>
+
+#include <unistd.h>
+#include <stdio.h>
+#include <stdlib.h>
+
+#include "ares.h"
+
+static void dns_callback(void *arg,
+ int status,
+ int timeouts,
+ unsigned char *abuf,
+ int alen)
+ {
+ struct ares_caa_reply *caa_out;
+ int err;
+
+ err = ares_parse_caa_reply (abuf, alen, &caa_out);
+ if (err == ARES_SUCCESS)
+ {
+ struct ares_caa_reply *caa_curr;
+ for (caa_curr=caa_out; caa_curr; caa_curr=caa_curr->next)
+ printf ("%s. CAA %i %s \\"%s\\"\\n", arg,
+ caa_curr->critical,
+ caa_curr->property,
+ caa_curr->value);
+ }
+ else
+ {
+ printf ("err=%i\\n", err);
+ }
+ ares_free_data (caa_out);
+ }
+
+static void main_loop(ares_channel_t **channel)
+ {
+ int nfds, count;
+ fd_set readers, writers;
+ struct timeval tv, *tvp;
+ while (1)
+ {
+ FD_ZERO (&readers);
+ FD_ZERO (&writers);
+ nfds = ares_fds (*channel, &readers, &writers);
+ if (nfds == 0)
+ break;
+ tvp = ares_timeout (*channel, NULL, &tv);
+ count = select (nfds, &readers, &writers, NULL, tvp);
+ ares_process (*channel, &readers, &writers);
+ }
+ }
+
+int main(int argc, char **argv)
+ {
+ const char *sversion;
+ int iversion;
+ int err;
+
+ sversion = ares_version (&iversion);
+ printf ("c-ares version %s\\n", sversion);
+
+ char *domain = "wikipedia.org";
+ if (argc > 1)
+ domain = argv[1];
+
+ ares_channel_t *channel;
+ if ((err = ares_init (&channel)) != ARES_SUCCESS)
+ {
+ printf ("ares_init() failed (%i)\\n", err);
+ exit (EXIT_FAILURE);
+ }
+
+ ares_query (channel, domain,
+ 1, /* ns_c_in */
+ 257, /* T_CAA */
+ dns_callback, domain);
+
+ main_loop (&channel);
+
+ ares_destroy (channel);
+
+ exit (EXIT_SUCCESS);
+ }
+.fi
+.SH AVAILABILITY
+This function was first introduced in c-ares version 1.17.0.
+.SH SEE ALSO
+.BR ares_query (3)
+.BR ares_free_data (3)
+.SH AUTHOR
+Written by Danny Sonnenschein <my.card.god@web.de>, on behalf of platynum, https://platynum.ch
diff --git a/subprojects/c-ares/docs/ares_parse_mx_reply.3 b/subprojects/c-ares/docs/ares_parse_mx_reply.3
@@ -0,0 +1,80 @@
+.\"
+.\" Copyright 1998 by the Massachusetts Institute of Technology.
+.\"
+.\" Permission to use, copy, modify, and distribute this
+.\" software and its documentation for any purpose and without
+.\" fee is hereby granted, provided that the above copyright
+.\" notice appear in all copies and that both that copyright
+.\" notice and this permission notice appear in supporting
+.\" documentation, and that the name of M.I.T. not be used in
+.\" advertising or publicity pertaining to distribution of the
+.\" software without specific, written prior permission.
+.\" M.I.T. makes no representations about the suitability of
+.\" this software for any purpose. It is provided "as is"
+.\" without express or implied warranty.
+.\"
+.\" SPDX-License-Identifier: MIT
+.\"
+.TH ARES_PARSE_MX_REPLY 3 "4 August 2009"
+.SH NAME
+ares_parse_mx_reply \- Parse a reply to a DNS query of type MX
+.SH SYNOPSIS
+#include <ares.h>
+
+int ares_parse_mx_reply(const unsigned char* \fIabuf\fP, int \fIalen\fP,
+ struct ares_mx_reply** \fImx_out\fP);
+.fi
+.SH DESCRIPTION
+The
+.B ares_parse_mx_reply
+function parses the response to a query of type MX into a
+linked list of
+.I struct ares_mx_reply
+The parameters
+.I abuf
+and
+.I alen
+give the contents of the response. The result is stored in allocated
+memory and a pointer to it stored into the variable pointed to by
+.IR mx_out .
+It is the caller's responsibility to free the resulting
+.IR mx_out
+structure when it is no longer needed using the function
+\fBares_free_data(3)\fP.
+.PP
+The structure
+.I ares_mx_reply
+contains the following fields:
+.sp
+.in +4n
+.nf
+struct ares_mx_reply {
+ struct ares_mx_reply *next;
+ char *host;
+ unsigned short priority;
+};
+.fi
+.in
+.PP
+.SH RETURN VALUES
+.B ares_parse_mx_reply
+can return any of the following values:
+.TP 15
+.B ARES_SUCCESS
+The response was successfully parsed.
+.TP 15
+.B ARES_EBADRESP
+The response was malformatted.
+.TP 15
+.B ARES_ENODATA
+The response did not contain an answer to the query.
+.TP 15
+.B ARES_ENOMEM
+Memory was exhausted.
+.SH AVAILABILITY
+This function was first introduced in c-ares version 1.7.2.
+.SH SEE ALSO
+.BR ares_query (3)
+.BR ares_free_data (3)
+.SH AUTHOR
+Written by Jeremy Lal <kapouer@melix.org>
diff --git a/subprojects/c-ares/docs/ares_parse_naptr_reply.3 b/subprojects/c-ares/docs/ares_parse_naptr_reply.3
@@ -0,0 +1,85 @@
+.\"
+.\" Copyright 1998 by the Massachusetts Institute of Technology.
+.\"
+.\" Permission to use, copy, modify, and distribute this
+.\" software and its documentation for any purpose and without
+.\" fee is hereby granted, provided that the above copyright
+.\" notice appear in all copies and that both that copyright
+.\" notice and this permission notice appear in supporting
+.\" documentation, and that the name of M.I.T. not be used in
+.\" advertising or publicity pertaining to distribution of the
+.\" software without specific, written prior permission.
+.\" M.I.T. makes no representations about the suitability of
+.\" this software for any purpose. It is provided "as is"
+.\" without express or implied warranty.
+.\"
+.\" SPDX-License-Identifier: MIT
+.\"
+.TH ARES_PARSE_NAPTR_REPLY 3 "23 February 2012"
+.SH NAME
+ares_parse_naptr_reply \- Parse a reply to a DNS query of type NAPTR
+.SH SYNOPSIS
+.nf
+#include <ares.h>
+
+int ares_parse_naptr_reply(const unsigned char* \fIabuf\fP, int \fIalen\fP,
+ struct ares_naptr_reply** \fInaptr_out\fP);
+.fi
+.SH DESCRIPTION
+The
+.B ares_parse_naptr_reply
+function parses the response to a query of type NAPTR into a
+linked list of
+.I struct ares_naptr_reply
+The parameters
+.I abuf
+and
+.I alen
+give the contents of the response. The result is stored in allocated
+memory and a pointer to it stored into the variable pointed to by
+.IR naptr_out .
+It is the caller's responsibility to free the resulting
+.IR naptr_out
+structure when it is no longer needed using the function
+\fBares_free_data(3)\fP.
+.PP
+The structure
+.I ares_naptr_reply
+contains the following fields:
+.sp
+.in +4n
+.nf
+struct ares_naptr_reply {
+ struct ares_naptr_reply *next;
+ unsigned char *flags;
+ unsigned char *service;
+ unsigned char *regexp;
+ char *replacement;
+ unsigned short order;
+ unsigned short preference;
+};
+.fi
+.in
+.PP
+.SH RETURN VALUES
+.B ares_parse_naptr_reply
+can return any of the following values:
+.TP 15
+.B ARES_SUCCESS
+The response was successfully parsed.
+.TP 15
+.B ARES_EBADRESP
+The response was malformatted.
+.TP 15
+.B ARES_ENODATA
+The response did not contain an answer to the query.
+.TP 15
+.B ARES_ENOMEM
+Memory was exhausted.
+.SH AVAILABILITY
+This function was first introduced in c-ares version 1.7.6.
+.SH SEE ALSO
+.BR ares_query (3)
+.BR ares_free_data (3)
+.SH AUTHOR
+Written by Jakub Hrozek <jhrozek@redhat.com>, on behalf of Red Hat, Inc http://www.redhat.com
diff --git a/subprojects/c-ares/docs/ares_parse_ns_reply.3 b/subprojects/c-ares/docs/ares_parse_ns_reply.3
@@ -0,0 +1,68 @@
+.\"
+.\" Copyright 1998 by the Massachusetts Institute of Technology.
+.\"
+.\" Permission to use, copy, modify, and distribute this
+.\" software and its documentation for any purpose and without
+.\" fee is hereby granted, provided that the above copyright
+.\" notice appear in all copies and that both that copyright
+.\" notice and this permission notice appear in supporting
+.\" documentation, and that the name of M.I.T. not be used in
+.\" advertising or publicity pertaining to distribution of the
+.\" software without specific, written prior permission.
+.\" M.I.T. makes no representations about the suitability of
+.\" this software for any purpose. It is provided "as is"
+.\" without express or implied warranty.
+.\"
+.\" SPDX-License-Identifier: MIT
+.\"
+.TH ARES_PARSE_NS_REPLY 3 "10 February 2007"
+.SH NAME
+ares_parse_ns_reply \- Parse a reply to a DNS query of type NS into a hostent
+.SH SYNOPSIS
+.nf
+#include <ares.h>
+
+int ares_parse_ns_reply(const unsigned char *\fIabuf\fP, int \fIalen\fP,
+ struct hostent **\fIhost\fP);
+.fi
+.SH DESCRIPTION
+The
+.B ares_parse_ns_reply
+function parses the response to a query of type NS into a
+.BR "struct hostent" .
+The parameters
+.I abuf
+and
+.I alen
+give the contents of the response. The result is stored in allocated
+memory and a pointer to it stored into the variable pointed to by
+.IR host .
+The nameservers are stored into the
+.BR aliases
+field of the
+.IR host
+structure.
+It is the caller's responsibility to free the resulting host structure
+using
+.BR ares_free_hostent (3)
+when it is no longer needed.
+.SH RETURN VALUES
+.B ares_parse_ns_reply
+can return any of the following values:
+.TP 15
+.B ARES_SUCCESS
+The response was successfully parsed.
+.TP 15
+.B ARES_EBADRESP
+The response was malformatted.
+.TP 15
+.B ARES_ENODATA
+The response did not contain an answer to the query.
+.TP 15
+.B ARES_ENOMEM
+Memory was exhausted.
+.SH SEE ALSO
+.BR ares_query (3),
+.BR ares_free_hostent (3)
+.SH AUTHOR
+Written by Vlad Dinulescu <vlad.dinulescu@avira.com>, on behalf of AVIRA Gmbh http://www.avira.com
diff --git a/subprojects/c-ares/docs/ares_parse_ptr_reply.3 b/subprojects/c-ares/docs/ares_parse_ptr_reply.3
@@ -0,0 +1,76 @@
+.\"
+.\" Copyright 1998 by the Massachusetts Institute of Technology.
+.\"
+.\" Permission to use, copy, modify, and distribute this
+.\" software and its documentation for any purpose and without
+.\" fee is hereby granted, provided that the above copyright
+.\" notice appear in all copies and that both that copyright
+.\" notice and this permission notice appear in supporting
+.\" documentation, and that the name of M.I.T. not be used in
+.\" advertising or publicity pertaining to distribution of the
+.\" software without specific, written prior permission.
+.\" M.I.T. makes no representations about the suitability of
+.\" this software for any purpose. It is provided "as is"
+.\" without express or implied warranty.
+.\"
+.\" SPDX-License-Identifier: MIT
+.\"
+.TH ARES_PARSE_PTR_REPLY 3 "25 July 1998"
+.SH NAME
+ares_parse_ptr_reply \- Parse a reply to a DNS query of type PTR into a hostent
+.SH SYNOPSIS
+.nf
+#include <ares.h>
+
+int ares_parse_ptr_reply(const unsigned char *\fIabuf\fP, int \fIalen\fP,
+ const void *\fIaddr\fP, int \fIaddrlen\fP,
+ int \fIfamily\fP, struct hostent **\fIhost\fP);
+.fi
+.SH DESCRIPTION
+The
+.B ares_parse_ptr_reply
+function parses the response to a query of type PTR into a
+.BR "struct hostent" .
+The parameters
+.I abuf
+and
+.I alen
+give the contents of the response. The parameters
+.IR addr ,
+.IR addrlen ,
+and
+.I family
+specify which address was queried for; they are not used to verify the
+response, merely used to fill in the address of the
+.BR "struct hostent" .
+The resulting
+.B struct hostent
+is stored in allocated memory and a pointer to it stored into the
+variable pointed to by
+.IR host .
+It is the caller's responsibility to free the resulting host structure
+using
+.BR ares_free_hostent (3)
+when it is no longer needed.
+.SH RETURN VALUES
+.B ares_parse_ptr_reply
+can return any of the following values:
+.TP 15
+.B ARES_SUCCESS
+The response was successfully parsed.
+.TP 15
+.B ARES_EBADRESP
+The response was malformatted.
+.TP 15
+.B ARES_ENODATA
+The response did not contain an answer to the query.
+.TP 15
+.B ARES_ENOMEM
+Memory was exhausted.
+.SH SEE ALSO
+.BR ares_gethostbyaddr (3),
+.BR ares_free_hostent (3)
+.SH AUTHOR
+Greg Hudson, MIT Information Systems
+.br
+Copyright 1998 by the Massachusetts Institute of Technology.
diff --git a/subprojects/c-ares/docs/ares_parse_soa_reply.3 b/subprojects/c-ares/docs/ares_parse_soa_reply.3
@@ -0,0 +1,82 @@
+.\"
+.\" Copyright 1998 by the Massachusetts Institute of Technology.
+.\"
+.\" Permission to use, copy, modify, and distribute this
+.\" software and its documentation for any purpose and without
+.\" fee is hereby granted, provided that the above copyright
+.\" notice appear in all copies and that both that copyright
+.\" notice and this permission notice appear in supporting
+.\" documentation, and that the name of M.I.T. not be used in
+.\" advertising or publicity pertaining to distribution of the
+.\" software without specific, written prior permission.
+.\" M.I.T. makes no representations about the suitability of
+.\" this software for any purpose. It is provided "as is"
+.\" without express or implied warranty.
+.\"
+.\" SPDX-License-Identifier: MIT
+.\"
+.TH ARES_PARSE_SOA_REPLY 3 "29 May 2012"
+.SH NAME
+ares_parse_soa_reply \- Parse a reply to a DNS query of type SOA
+.SH SYNOPSIS
+.nf
+#include <ares.h>
+
+int ares_parse_soa_reply(const unsigned char* \fIabuf\fP, int \fIalen\fP,
+ struct ares_soa_reply** \fIsoa_out\fP);
+.fi
+.SH DESCRIPTION
+The
+.B ares_parse_soa_reply
+function parses the response to a query of type SOA into a
+.IR struct\ ares_soa_reply .
+The parameters
+.I abuf
+and
+.I alen
+give the contents of the response. The result is stored in allocated
+memory and a pointer to it stored into the variable pointed to by
+.IR soa_out .
+It is the caller's responsibility to free the resulting
+.IR soa_out
+structure when it is no longer needed using the function
+\fBares_free_data(3)\fP.
+.PP
+The structure
+.I ares_soa_reply
+contains the following fields:
+.sp
+.in +4n
+.nf
+struct ares_soa_reply {
+ char *nsname;
+ char *hostmaster;
+ unsigned int serial;
+ unsigned int refresh;
+ unsigned int retry;
+ unsigned int expire;
+ unsigned int minttl;
+};
+.fi
+.in
+.PP
+.SH RETURN VALUES
+.B ares_parse_soa_reply
+can return any of the following values:
+.TP 15
+.B ARES_SUCCESS
+The response was successfully parsed.
+.TP 15
+.B ARES_EBADRESP
+The response was malformatted.
+.TP 15
+.B ARES_ENODATA
+The response did not contain an answer to the query.
+.TP 15
+.B ARES_ENOMEM
+Memory was exhausted.
+.SH AVAILABILITY
+This function was first introduced in c-ares version 1.9.0.
+.SH SEE ALSO
+.BR ares_query (3)
+.BR ares_free_data (3)
diff --git a/subprojects/c-ares/docs/ares_parse_srv_reply.3 b/subprojects/c-ares/docs/ares_parse_srv_reply.3
@@ -0,0 +1,83 @@
+.\"
+.\" Copyright 1998 by the Massachusetts Institute of Technology.
+.\"
+.\" Permission to use, copy, modify, and distribute this
+.\" software and its documentation for any purpose and without
+.\" fee is hereby granted, provided that the above copyright
+.\" notice appear in all copies and that both that copyright
+.\" notice and this permission notice appear in supporting
+.\" documentation, and that the name of M.I.T. not be used in
+.\" advertising or publicity pertaining to distribution of the
+.\" software without specific, written prior permission.
+.\" M.I.T. makes no representations about the suitability of
+.\" this software for any purpose. It is provided "as is"
+.\" without express or implied warranty.
+.\"
+.\" SPDX-License-Identifier: MIT
+.\"
+.TH ARES_PARSE_SRV_REPLY 3 "4 August 2009"
+.SH NAME
+ares_parse_srv_reply \- Parse a reply to a DNS query of type SRV
+.SH SYNOPSIS
+.nf
+#include <ares.h>
+
+int ares_parse_srv_reply(const unsigned char* \fIabuf\fP, int \fIalen\fP,
+ struct ares_srv_reply** \fIsrv_out\fP);
+.fi
+.SH DESCRIPTION
+The
+.B ares_parse_srv_reply
+function parses the response to a query of type SRV into a
+linked list of
+.I struct ares_srv_reply
+The parameters
+.I abuf
+and
+.I alen
+give the contents of the response. The result is stored in allocated
+memory and a pointer to it stored into the variable pointed to by
+.IR srv_out .
+It is the caller's responsibility to free the resulting
+.IR srv_out
+structure when it is no longer needed using the function
+\fBares_free_data(3)\fP.
+.PP
+The structure
+.I ares_srv_reply
+contains the following fields:
+.sp
+.in +4n
+.nf
+struct ares_srv_reply {
+ struct ares_srv_reply *next;
+ unsigned short weight;
+ unsigned short priority;
+ unsigned short port;
+ char *host;
+};
+.fi
+.in
+.PP
+.SH RETURN VALUES
+.B ares_parse_srv_reply
+can return any of the following values:
+.TP 15
+.B ARES_SUCCESS
+The response was successfully parsed.
+.TP 15
+.B ARES_EBADRESP
+The response was malformatted.
+.TP 15
+.B ARES_ENODATA
+The response did not contain an answer to the query.
+.TP 15
+.B ARES_ENOMEM
+Memory was exhausted.
+.SH AVAILABILITY
+This function was first introduced in c-ares version 1.7.0.
+.SH SEE ALSO
+.BR ares_query (3)
+.BR ares_free_data (3)
+.SH AUTHOR
+Written by Jakub Hrozek <jhrozek@redhat.com>, on behalf of Red Hat, Inc http://www.redhat.com
diff --git a/subprojects/c-ares/docs/ares_parse_txt_reply.3 b/subprojects/c-ares/docs/ares_parse_txt_reply.3
@@ -0,0 +1,113 @@
+.\"
+.\" Copyright 1998 by the Massachusetts Institute of Technology.
+.\"
+.\" Permission to use, copy, modify, and distribute this
+.\" software and its documentation for any purpose and without
+.\" fee is hereby granted, provided that the above copyright
+.\" notice appear in all copies and that both that copyright
+.\" notice and this permission notice appear in supporting
+.\" documentation, and that the name of M.I.T. not be used in
+.\" advertising or publicity pertaining to distribution of the
+.\" software without specific, written prior permission.
+.\" M.I.T. makes no representations about the suitability of
+.\" this software for any purpose. It is provided "as is"
+.\" without express or implied warranty.
+.\"
+.\" SPDX-License-Identifier: MIT
+.\"
+.TH ARES_PARSE_TXT_REPLY 3 "27 October 2009"
+.SH NAME
+ares_parse_txt_reply \- Parse a reply to a DNS query of type TXT
+.SH SYNOPSIS
+.nf
+#include <ares.h>
+
+int ares_parse_txt_reply(const unsigned char* \fIabuf\fP, int \fIalen\fP,
+ struct ares_txt_reply **\fItxt_out\fP);
+
+int ares_parse_txt_reply_ext(const unsigned char* \fIabuf\fP, int \fIalen\fP,
+ struct ares_txt_ext **\fItxt_out\fP);
+.fi
+.SH DESCRIPTION
+The \fIares_parse_txt_reply(3)\fP and \fIares_parse_txt_reply_ext(3)\fP
+functions parse the response to a query of type TXT into a linked list (one
+element per sub-string) of
+.IR "struct ares_txt_reply" " (" "struct ares_txt_ext" ")"
+The parameters
+.I abuf
+and
+.I alen
+give the contents of the response. The result is stored in allocated
+memory and a pointer to it stored into the variable pointed to by
+.IR txt_out .
+It is the caller's responsibility to free the resulting
+.IR txt_out
+structure when it is no longer needed using the function
+\fBares_free_data(3)\fP.
+
+The structure
+.I ares_txt_reply
+contains the following fields:
+.nf
+struct ares_txt_reply {
+ struct ares_txt_reply *next;
+ unsigned int length;
+ unsigned char *txt;
+};
+.fi
+
+The structure
+.I ares_txt_ext
+contains the following fields:
+.nf
+struct ares_txt_ext {
+ struct ares_txt_ext *next;
+ unsigned int length;
+ unsigned char *txt;
+ unsigned char record_start;
+};
+.fi
+The
+.I record_start
+field in
+.I struct ares_txt_ext
+is 1 if this structure is a start of a TXT record, and 0 if the structure is a
+continuation of a previous record. The linked list of the
+.I struct ares_txt_ext
+will have at least one item with
+.I record_start
+equal to 1, and may have some items with
+.I record_start
+equal to 0 between them.
+
+These sequences of
+.I struct ares_txt_ext
+(starting from the item with
+.I record_start
+equal to 1, and ending right before the record start item) may be treated as
+either components of a single TXT record or as a multi-parted TXT record,
+depending on particular use case.
+.SH RETURN VALUES
+.BR "ares_parse_txt_reply" " (" "ares_parse_txt_reply_ext" ")"
+can return any of the following values:
+.TP 15
+.B ARES_SUCCESS
+The response was successfully parsed.
+.TP 15
+.B ARES_EBADRESP
+The response was malformatted.
+.TP 15
+.B ARES_ENODATA
+The response did not contain an answer to the query.
+.TP 15
+.B ARES_ENOMEM
+Memory was exhausted.
+.SH AVAILABILITY
+This function was first introduced in c-ares version 1.7.0.
+.SH SEE ALSO
+.BR ares_query (3)
+.BR ares_free_data (3)
+.SH AUTHOR
+Written by Jakub Hrozek <jhrozek@redhat.com>, on behalf of Red Hat, Inc http://www.redhat.com
+.PP
+Amended by Fedor Indutny <fedor@indutny.com>, on behalf of PayPal, Inc https://www.paypal.com
diff --git a/subprojects/c-ares/docs/ares_parse_uri_reply.3 b/subprojects/c-ares/docs/ares_parse_uri_reply.3
@@ -0,0 +1,77 @@
+.\"
+.\" Copyright 1998 by the Massachusetts Institute of Technology.
+.\"
+.\" Permission to use, copy, modify, and distribute this
+.\" software and its documentation for any purpose and without
+.\" fee is hereby granted, provided that the above copyright
+.\" notice appear in all copies and that both that copyright
+.\" notice and this permission notice appear in supporting
+.\" documentation, and that the name of M.I.T. not be used in
+.\" advertising or publicity pertaining to distribution of the
+.\" software without specific, written prior permission.
+.\" M.I.T. makes no representations about the suitability of
+.\" this software for any purpose. It is provided "as is"
+.\" without express or implied warranty.
+.\"
+.\" SPDX-License-Identifier: MIT
+.\"
+.TH ARES_PARSE_URI_REPLY 3 "14 August 2020"
+.SH NAME
+ares_parse_uri_reply \- Parse a reply to a DNS query of type URI
+.SH SYNOPSIS
+.nf
+#include <ares.h>
+
+int ares_parse_uri_reply(const unsigned char* \fIabuf\fP, int \fIalen\fP,
+ struct ares_uri_reply** \fIuri_out\fP);
+.fi
+.SH DESCRIPTION
+The \fIares_parse_uri_reply(3)\fP function parses the response to a query of
+type URI into a linked list of
+.I struct ares_uri_reply
+The parameters
+.I abuf
+and
+.I alen
+give the contents of the response. The result is stored in allocated
+memory and a pointer to it stored into the variable pointed to by
+.IR uri_out .
+It is the caller's responsibility to free the resulting
+.IR uri_out
+structure when it is no longer needed using the function
+\fBares_free_data(3)\fP.
+
+The structure
+.I ares_uri_reply
+contains the following fields:
+.nf
+struct ares_uri_reply {
+ struct ares_uri_reply *next;
+ unsigned short weight;
+ unsigned short priority;
+ char *uri;
+ int ttl;
+};
+.fi
+.SH RETURN VALUES
+.B ares_parse_uri_reply
+can return any of the following values:
+.TP 15
+.B ARES_SUCCESS
+The response was successfully parsed.
+.TP 15
+.B ARES_EBADRESP
+The response was malformatted.
+.TP 15
+.B ARES_ENODATA
+The response did not contain an answer to the query.
+.TP 15
+.B ARES_ENOMEM
+Memory was exhausted.
+.SH AVAILABILITY
+
+.SH SEE ALSO
+.BR ares_query (3)
+.BR ares_free_data (3)
+.SH AUTHOR
+Written by Jan Petrasek <petrasek@tes.eu>
diff --git a/subprojects/c-ares/docs/ares_process.3 b/subprojects/c-ares/docs/ares_process.3
@@ -0,0 +1,81 @@
+.\"
+.\" Copyright 1998 by the Massachusetts Institute of Technology.
+.\"
+.\" Permission to use, copy, modify, and distribute this
+.\" software and its documentation for any purpose and without
+.\" fee is hereby granted, provided that the above copyright
+.\" notice appear in all copies and that both that copyright
+.\" notice and this permission notice appear in supporting
+.\" documentation, and that the name of M.I.T. not be used in
+.\" advertising or publicity pertaining to distribution of the
+.\" software without specific, written prior permission.
+.\" M.I.T. makes no representations about the suitability of
+.\" this software for any purpose. It is provided "as is"
+.\" without express or implied warranty.
+.\"
+.\" SPDX-License-Identifier: MIT
+.\"
+.TH ARES_PROCESS 3 "25 July 1998"
+.SH NAME
+ares_process \- Process events for name resolution
+.SH SYNOPSIS
+.nf
+#include <ares.h>
+
+void ares_process(ares_channel_t *\fIchannel\fP,
+ fd_set *\fIread_fds\fP,
+ fd_set *\fIwrite_fds\fP)
+
+void ares_process_fd(ares_channel_t *\fIchannel\fP,
+ ares_socket_t \fIread_fd\fP,
+ ares_socket_t \fIwrite_fd\fP)
+.fi
+.SH DESCRIPTION
+The \fBares_process(3)\fP function handles input/output events and timeouts
+associated with queries pending on the name service channel identified by
+.IR channel .
+The file descriptor sets pointed to by \fIread_fds\fP and \fIwrite_fds\fP
+should have file descriptors set in them according to whether the file
+descriptors specified by \fIares_fds(3)\fP are ready for reading and writing.
+(The easiest way to determine this information is to invoke \fBselect(3)\fP
+with a timeout no greater than the timeout given by \fIares_timeout(3)\fP).
+
+The \fBares_process(3)\fP function will invoke callbacks for pending queries
+if they complete successfully or fail.
+
+\fBares_process_fd(3)\fP works the same way but acts and operates only on the
+specific file descriptors (sockets) you pass in to the function. Use
+ARES_SOCKET_BAD for "no action". This function is provided to allow users of
+c-ares to avoid \fIselect(3)\fP in their applications and within c-ares.
+
+To only process possible timeout conditions without a socket event occurring,
+one may pass NULL as the values for both \fIread_fds\fP and \fIwrite_fds\fP for
+\fBares_process(3)\fP, or ARES_SOCKET_BAD for both \fIread_fd\fP and
+\fIwrite_fd\fP for \fBares_process_fd(3)\fP.
+.SH EXAMPLE
+The following code fragment waits for all pending queries on a channel
+to complete:
+
+.nf
+int nfds, count;
+fd_set readers, writers;
+struct timeval tv, *tvp;
+
+while (1) {
+ FD_ZERO(&readers);
+ FD_ZERO(&writers);
+ nfds = ares_fds(channel, &readers, &writers);
+ if (nfds == 0)
+ break;
+ tvp = ares_timeout(channel, NULL, &tv);
+ count = select(nfds, &readers, &writers, NULL, tvp);
+ ares_process(channel, &readers, &writers);
+}
+.fi
+.SH SEE ALSO
+.BR ares_fds (3),
+.BR ares_timeout (3)
+.SH AUTHOR
+Greg Hudson, MIT Information Systems
+.br
+Copyright 1998 by the Massachusetts Institute of Technology.
diff --git a/subprojects/c-ares/docs/ares_query.3 b/subprojects/c-ares/docs/ares_query.3
@@ -0,0 +1,158 @@
+.\"
+.\" Copyright 1998 by the Massachusetts Institute of Technology.
+.\"
+.\" Permission to use, copy, modify, and distribute this
+.\" software and its documentation for any purpose and without
+.\" fee is hereby granted, provided that the above copyright
+.\" notice appear in all copies and that both that copyright
+.\" notice and this permission notice appear in supporting
+.\" documentation, and that the name of M.I.T. not be used in
+.\" advertising or publicity pertaining to distribution of the
+.\" software without specific, written prior permission.
+.\" M.I.T. makes no representations about the suitability of
+.\" this software for any purpose. It is provided "as is"
+.\" without express or implied warranty.
+.\"
+.\" SPDX-License-Identifier: MIT
+.\"
+.TH ARES_QUERY 3 "24 July 1998"
+.SH NAME
+ares_query \- Initiate a single-question DNS query
+.SH SYNOPSIS
+.nf
+#include <ares.h>
+
+typedef void (*ares_callback)(void *\fIarg\fP, int \fIstatus\fP,
+ int \fItimeouts\fP, unsigned char *\fIabuf\fP,
+ int \fIalen\fP)
+
+void ares_query(ares_channel_t *\fIchannel\fP, const char *\fIname\fP,
+ int \fIdnsclass\fP, int \fItype\fP,
+ ares_callback \fIcallback\fP, void *\fIarg\fP)
+.fi
+.SH DESCRIPTION
+The
+.B ares_query
+function initiates a single-question DNS query on the name service
+channel identified by
+.IR channel .
+The parameter
+.I name
+gives the query name as a NUL-terminated C string of period-separated
+labels optionally ending with a period; periods and backslashes within
+a label must be escaped with a backslash. The parameters
+.I dnsclass
+and
+.I type
+give the class and type of the query using the values defined in
+.BR <arpa/nameser.h> .
+When the query is complete or has failed, the ares library will invoke
+.IR callback .
+Completion or failure of the query may happen immediately, or may
+happen during a later call to
+.BR ares_process (3)
+or
+.BR ares_destroy (3).
+.PP
+If this is called from a thread other than which the main program event loop is
+running, care needs to be taken to ensure any file descriptor lists are updated
+immediately within the eventloop. When the associated callback is called,
+it is called with a channel lock so care must be taken to ensure any processing
+is minimal to prevent DNS channel stalls.
+.PP
+The callback argument
+.I arg
+is copied from the
+.B ares_query
+argument
+.IR arg .
+The callback argument
+.I status
+indicates whether the query succeeded and, if not, how it failed. It
+may have any of the following values:
+.TP 19
+.B ARES_SUCCESS
+The query completed successfully.
+.TP 19
+.B ARES_ENODATA
+The query completed but contains no answers.
+.TP 19
+.B ARES_EFORMERR
+The query completed but the server claims that the query was
+malformatted.
+.TP 19
+.B ARES_ESERVFAIL
+The query completed but the server claims to have experienced a
+failure. (This code can only occur if the
+.B ARES_FLAG_NOCHECKRESP
+flag was specified at channel initialization time; otherwise, such
+responses are ignored at the
+.BR ares_send (3)
+level.)
+.TP 19
+.B ARES_ENOTFOUND
+The query completed but the queried-for domain name was not found.
+.TP 19
+.B ARES_ENOTIMP
+The query completed but the server does not implement the operation
+requested by the query. (This code can only occur if the
+.B ARES_FLAG_NOCHECKRESP
+flag was specified at channel initialization time; otherwise, such
+responses are ignored at the
+.BR ares_send (3)
+level.)
+.TP 19
+.B ARES_EREFUSED
+The query completed but the server refused the query. (This code can
+only occur if the
+.B ARES_FLAG_NOCHECKRESP
+flag was specified at channel initialization time; otherwise, such
+responses are ignored at the
+.BR ares_send (3)
+level.)
+.TP 19
+.B ARES_EBADNAME
+The query name
+.I name
+could not be encoded as a domain name, either because it contained a
+zero-length label or because it contained a label of more than 63
+characters.
+.TP 19
+.B ARES_ETIMEOUT
+No name servers responded within the timeout period.
+.TP 19
+.B ARES_ECONNREFUSED
+No name servers could be contacted.
+.TP 19
+.B ARES_ENOMEM
+Memory was exhausted.
+.TP 19
+.B ARES_ECANCELLED
+The query was cancelled.
+.TP 19
+.B ARES_EDESTRUCTION
+The name service channel
+.I channel
+is being destroyed; the query will not be completed.
+.PP
+The callback argument
+.I timeouts
+reports how many times a query timed out during the execution of the
+given request.
+.PP
+If the query completed (even if there was something wrong with it, as
+indicated by some of the above error codes), the callback argument
+.I abuf
+points to a result buffer of length
+.IR alen .
+If the query did not complete,
+.I abuf
+will be NULL and
+.I alen
+will be 0.
+.SH SEE ALSO
+.BR ares_process (3)
+.SH AUTHOR
+Greg Hudson, MIT Information Systems
+.br
+Copyright 1998 by the Massachusetts Institute of Technology.
diff --git a/subprojects/c-ares/docs/ares_reinit.3 b/subprojects/c-ares/docs/ares_reinit.3
@@ -0,0 +1,51 @@
+.\"
+.\" SPDX-License-Identifier: MIT
+.\"
+.TH ARES_REINIT 3 "12 November 2023"
+.SH NAME
+ares_reinit \- ReInitialize a resolver channel from system configuration.
+.SH SYNOPSIS
+.nf
+#include <ares.h>
+
+int ares_reinit(ares_channel_t *\fIchannel\fP)
+.fi
+.SH DESCRIPTION
+The \fBares_reinit(3)\fP function re-reads the system configuration and safely
+applies the configuration to the existing channel. System configuration will
+never override user-provided settings such as provided via
+\fBares_init_options(3)\fP or \fBares_set_servers(3)\fP.
+
+Any existing queries will be automatically requeued if the server they are
+currently assigned to is removed from the system configuration.
+
+This function may cause additional file descriptors to be created, and existing
+ones to be destroyed if server configuration has changed. If this is called from
+a thread other than which the main program event loop is running, care needs to
+be taken to ensure any file descriptor lists are updated immediately within
+the eventloop.
+
+.SH RETURN VALUES
+\fIares_reinit(3)\fP can return any of the following values:
+.TP 14
+.B ARES_SUCCESS
+Initialization succeeded.
+.TP 14
+.B ARES_EFILE
+A configuration file could not be read.
+.TP 14
+.B ARES_ENOMEM
+The process's available memory was exhausted.
+
+.SH AVAILABILITY
+This function was first introduced in c-ares version 1.22.0.
+.SH SEE ALSO
+.BR ares_init (3),
+.BR ares_init_options (3),
+.BR ares_destroy (3),
+.BR ares_dup (3),
+.BR ares_library_init (3),
+.BR ares_set_servers (3),
+.BR ares_threadsafety (3)
+.SH AUTHOR
+Copyright (C) 2023 The c-ares project and its members.
diff --git a/subprojects/c-ares/docs/ares_save_options.3 b/subprojects/c-ares/docs/ares_save_options.3
@@ -0,0 +1,77 @@
+.\"
+.\" Copyright 1998 by the Massachusetts Institute of Technology.
+.\"
+.\" Permission to use, copy, modify, and distribute this
+.\" software and its documentation for any purpose and without
+.\" fee is hereby granted, provided that the above copyright
+.\" notice appear in all copies and that both that copyright
+.\" notice and this permission notice appear in supporting
+.\" documentation, and that the name of M.I.T. not be used in
+.\" advertising or publicity pertaining to distribution of the
+.\" software without specific, written prior permission.
+.\" M.I.T. makes no representations about the suitability of
+.\" this software for any purpose. It is provided "as is"
+.\" without express or implied warranty.
+.\"
+.\" SPDX-License-Identifier: MIT
+.\"
+.TH ARES_SAVE_OPTIONS 3 "5 March 2010"
+.SH NAME
+ares_save_options \- Save configuration values obtained from initialized ares_channel
+.SH SYNOPSIS
+.nf
+#include <ares.h>
+
+int ares_save_options(ares_channel_t *\fIchannel\fP,
+ struct ares_options *\fIoptions\fP, int *\fIoptmask\fP)
+.fi
+.SH DESCRIPTION
+The \fBares_save_options(3)\fP function saves the channel data identified by
+.IR channel ,
+into the options struct identified by
+.IR options ,
+and saves the mask of options which are set to the integer
+pointer (passed by reference) identified by
+.IR optmask .
+
+The resultant options and optmask are then able to be
+passed directly to ares_init_options. When the options
+are no longer needed, ares_destroy_options should be called
+to free any associated memory.
+.SH RETURN VALUES
+.B ares_save_options(3)
+can return any of the following values:
+.TP 15
+.B ARES_SUCCESS
+The channel data was successfully stored
+.TP 15
+.B ARES_ENOMEM
+The memory was exhausted
+.TP 15
+.B ARES_ENODATA
+The channel data identified by
+.IR channel
+were invalid.
+.SH NOTE
+Since c-ares 1.6.0 the ares_options struct has been "locked" meaning that it
+won't be extended to cover new functions. This function will remain
+functioning, but it can only return config data that can be represented in
+this config struct, which may no longer be the complete set of config
+options. \fBares_dup(3)\fP will not have that restriction.
+
+The ares_options struct can not handle potential IPv6 name servers the
+ares channel might be configured to use. The \fBares_save_options(3)\fP function
+will only return IPv4 servers, if any. In order to retrieve all name servers
+an ares channel might be using, the \fBares_get_servers(3)\fP function must be
+used instead.
+.SH SEE ALSO
+.BR ares_destroy_options (3),
+.BR ares_init_options (3),
+.BR ares_get_servers (3),
+.BR ares_dup (3)
+.SH AVAILABILITY
+ares_save_options(3) was added in c-ares 1.4.0
+.SH AUTHOR
+Brad House
+.br
+Copyright 1998 by the Massachusetts Institute of Technology.
diff --git a/subprojects/c-ares/docs/ares_search.3 b/subprojects/c-ares/docs/ares_search.3
@@ -0,0 +1,161 @@
+.\"
+.\" Copyright 1998 by the Massachusetts Institute of Technology.
+.\"
+.\" Permission to use, copy, modify, and distribute this
+.\" software and its documentation for any purpose and without
+.\" fee is hereby granted, provided that the above copyright
+.\" notice appear in all copies and that both that copyright
+.\" notice and this permission notice appear in supporting
+.\" documentation, and that the name of M.I.T. not be used in
+.\" advertising or publicity pertaining to distribution of the
+.\" software without specific, written prior permission.
+.\" M.I.T. makes no representations about the suitability of
+.\" this software for any purpose. It is provided "as is"
+.\" without express or implied warranty.
+.\"
+.\" SPDX-License-Identifier: MIT
+.\"
+.TH ARES_SEARCH 3 "24 July 1998"
+.SH NAME
+ares_search \- Initiate a DNS query with domain search
+.SH SYNOPSIS
+.nf
+#include <ares.h>
+
+typedef void (*ares_callback)(void *\fIarg\fP, int \fIstatus\fP,
+ int \fItimeouts\fP, unsigned char *\fIabuf\fP,
+ int \fIalen\fP)
+
+void ares_search(ares_channel_t *\fIchannel\fP, const char *\fIname\fP,
+ int \fIdnsclass\fP, int \fItype\fP,
+ ares_callback \fIcallback\fP, void *\fIarg\fP)
+.fi
+.SH DESCRIPTION
+The
+.B ares_search
+function initiates a series of single-question DNS queries on the name
+service channel identified by
+.IR channel ,
+using the channel's search domains as well as a host alias file given
+by the HOSTALIAS environment variable. The parameter
+.I name
+gives the alias name or the base of the query name as a NUL-terminated
+C string of period-separated labels; if it ends with a period, the
+channel's search domains will not be used. Periods and backslashes
+within a label must be escaped with a backslash. The parameters
+.I dnsclass
+and
+.I type
+give the class and type of the query using the values defined in
+.BR <arpa/nameser.h> .
+When the query sequence is complete or has failed, the ares library
+will invoke
+.IR callback .
+Completion or failure of the query sequence may happen immediately, or
+may happen during a later call to
+.BR ares_process (3)
+or
+.BR ares_destroy (3).
+.PP
+If this is called from a thread other than which the main program event loop is
+running, care needs to be taken to ensure any file descriptor lists are updated
+immediately within the eventloop. When the associated callback is called,
+it is called with a channel lock so care must be taken to ensure any processing
+is minimal to prevent DNS channel stalls.
+.PP
+The callback argument
+.I arg
+is copied from the
+.B ares_search
+argument
+.IR arg .
+The callback argument
+.I status
+indicates whether the query sequence ended with a successful query
+and, if not, how the query sequence failed. It may have any of the
+following values:
+.TP 19
+.B ARES_SUCCESS
+A query completed successfully.
+.TP 19
+.B ARES_ENODATA
+No query completed successfully; when the query was tried without a
+search domain appended, a response was returned with no answers.
+.TP 19
+.B ARES_EFORMERR
+A query completed but the server claimed that the query was
+malformatted.
+.TP 19
+.B ARES_ESERVFAIL
+No query completed successfully; when the query was tried without a
+search domain appended, the server claimed to have experienced a
+failure. (This code can only occur if the
+.B ARES_FLAG_NOCHECKRESP
+flag was specified at channel initialization time; otherwise, such
+responses are ignored at the
+.BR ares_send (3)
+level.)
+.TP 19
+.B ARES_ENOTFOUND
+No query completed successfully; when the query was tried without a
+search domain appended, the server reported that the queried-for
+domain name was not found.
+.TP 19
+.B ARES_ENOTIMP
+A query completed but the server does not implement the operation
+requested by the query. (This code can only occur if the
+.B ARES_FLAG_NOCHECKRESP
+flag was specified at channel initialization time; otherwise, such
+responses are ignored at the
+.BR ares_send (3)
+level.)
+.TP 19
+.B ARES_EREFUSED
+A query completed but the server refused the query. (This code can
+only occur returned if the
+.B ARES_FLAG_NOCHECKRESP
+flag was specified at channel initialization time; otherwise, such
+responses are ignored at the
+.BR ares_send (3)
+level.)
+.TP 19
+.B ARES_TIMEOUT
+No name servers responded to a query within the timeout period.
+.TP 19
+.B ARES_ECONNREFUSED
+No name servers could be contacted.
+.TP 19
+.B ARES_ENOMEM
+Memory was exhausted.
+.TP 19
+.B ARES_ECANCELLED
+The query was cancelled.
+.TP 19
+.B ARES_EDESTRUCTION
+The name service channel
+.I channel
+is being destroyed; the query will not be completed.
+.PP
+The callback argument
+.I timeouts
+reports how many times a query timed out during the execution of the
+given request.
+.PP
+If a query completed successfully, the callback argument
+.I abuf
+points to a result buffer of length
+.IR alen .
+If the query did not complete successfully,
+.I abuf
+will usually be NULL and
+.I alen
+will usually be 0, but in some cases an unsuccessful query result may
+be placed in
+.IR abuf .
+.SH SEE ALSO
+.BR ares_process (3),
+.BR ares_dns_record (3)
+.SH AUTHOR
+Greg Hudson, MIT Information Systems
+.br
+Copyright 1998 by the Massachusetts Institute of Technology.
diff --git a/subprojects/c-ares/docs/ares_send.3 b/subprojects/c-ares/docs/ares_send.3
@@ -0,0 +1,133 @@
+.\"
+.\" Copyright 1998 by the Massachusetts Institute of Technology.
+.\"
+.\" Permission to use, copy, modify, and distribute this
+.\" software and its documentation for any purpose and without
+.\" fee is hereby granted, provided that the above copyright
+.\" notice appear in all copies and that both that copyright
+.\" notice and this permission notice appear in supporting
+.\" documentation, and that the name of M.I.T. not be used in
+.\" advertising or publicity pertaining to distribution of the
+.\" software without specific, written prior permission.
+.\" M.I.T. makes no representations about the suitability of
+.\" this software for any purpose. It is provided "as is"
+.\" without express or implied warranty.
+.\"
+.\" SPDX-License-Identifier: MIT
+.\"
+.TH ARES_SEND 3 "25 July 1998"
+.SH NAME
+ares_send \- Initiate a DNS query
+.SH SYNOPSIS
+.nf
+#include <ares.h>
+
+typedef void (*ares_callback)(void *\fIarg\fP, int \fIstatus\fP,
+ int \fItimeouts\fP, unsigned char *\fIabuf\fP,
+ int \fIalen\fP)
+
+void ares_send(ares_channel_t *\fIchannel\fP, const unsigned char *\fIqbuf\fP,
+ int \fIqlen\fP, ares_callback \fIcallback\fP, void *\fIarg\fP)
+.fi
+.SH DESCRIPTION
+The
+.B ares_send
+function initiates a DNS query on the name service channel identified
+by
+.IR channel .
+The parameters
+.I qbuf
+and
+.I qlen
+give the DNS query, which should already have been formatted according
+to the DNS protocol. When the query is complete or has failed, the
+ares library will invoke
+.IR callback .
+Completion or failure of the query may happen immediately, or may
+happen during a later call to
+.BR ares_process (3)
+or
+.BR ares_destroy (3).
+.PP
+If this is called from a thread other than which the main program event loop is
+running, care needs to be taken to ensure any file descriptor lists are updated
+immediately within the eventloop. When the associated callback is called,
+it is called with a channel lock so care must be taken to ensure any processing
+is minimal to prevent DNS channel stalls.
+.PP
+The callback argument
+.I arg
+is copied from the
+.B ares_send
+argument
+.IR arg .
+The callback argument
+.I status
+indicates whether the query succeeded and, if not, how it failed. It
+may have any of the following values:
+.TP 19
+.B ARES_SUCCESS
+The query completed.
+.TP 19
+.B ARES_EBADQUERY
+The query buffer was poorly formed (was not long enough for a DNS
+header or was too long for TCP transmission).
+.TP 19
+.B ARES_ETIMEOUT
+No name servers responded within the timeout period.
+.TP 19
+.B ARES_ECONNREFUSED
+No name servers could be contacted.
+.TP 19
+.B ARES_ENOMEM
+Memory was exhausted.
+.TP 19
+.B ARES_ECANCELLED
+The query was cancelled.
+.TP 19
+.B ARES_EDESTRUCTION
+The name service channel
+.I channel
+is being destroyed; the query will not be completed.
+.PP
+The callback argument
+.I timeouts
+reports how many times a query timed out during the execution of the
+given request.
+.PP
+If the query completed, the callback argument
+.I abuf
+points to a result buffer of length
+.IR alen .
+If the query did not complete,
+.I abuf
+will be NULL and
+.I alen
+will be 0.
+.PP
+Unless the flag
+.B ARES_FLAG_NOCHECKRESP
+was set at channel initialization time,
+.B ares_send
+will normally ignore responses whose questions do not match the
+questions in
+.IR qbuf ,
+as well as responses with reply codes of
+.BR SERVFAIL ,
+.BR NOTIMP ,
+and
+.BR REFUSED .
+Unlike other query functions in the ares library, however,
+.B ares_send
+does not inspect the header of the reply packet to determine the error
+status, so a callback status of
+.B ARES_SUCCESS
+does not reflect as much about the response as for other query
+functions.
+.SH SEE ALSO
+.BR ares_process (3),
+.BR ares_dns_record (3)
+.SH AUTHOR
+Greg Hudson, MIT Information Systems
+.br
+Copyright 1998 by the Massachusetts Institute of Technology.
diff --git a/subprojects/c-ares/docs/ares_set_local_dev.3 b/subprojects/c-ares/docs/ares_set_local_dev.3
@@ -0,0 +1,41 @@
+.\"
+.\" Copyright 2010 by Ben Greear <greearb@candelatech.com>
+.\"
+.\" Permission to use, copy, modify, and distribute this
+.\" software and its documentation for any purpose and without
+.\" fee is hereby granted, provided that the above copyright
+.\" notice appear in all copies and that both that copyright
+.\" notice and this permission notice appear in supporting
+.\" documentation, and that the name of M.I.T. not be used in
+.\" advertising or publicity pertaining to distribution of the
+.\" software without specific, written prior permission.
+.\" M.I.T. makes no representations about the suitability of
+.\" this software for any purpose. It is provided "as is"
+.\" without express or implied warranty.
+.\"
+.\" SPDX-License-Identifier: MIT
+.\"
+.TH ARES_SET_LOCAL_DEV 3 "30 June 2010"
+.SH NAME
+ares_set_local_dev \- Bind to a specific network device when creating sockets.
+.SH SYNOPSIS
+.nf
+#include <ares.h>
+
+void ares_set_local_dev(ares_channel_t *\fIchannel\fP, const char* \fIlocal_dev_name\fP)
+.fi
+.SH DESCRIPTION
+The \fBares_set_local_dev\fP function causes all future sockets
+to be bound to this device with SO_BINDTODEVICE. This forces communications
+to go over a certain interface, which can be useful on multi-homed machines.
+This option is only supported on Linux, and root privileges are required
+for the option to work. If SO_BINDTODEVICE is not supported or the
+setsocktop call fails (probably because of permissions), the error is
+silently ignored.
+.SH SEE ALSO
+.BR ares_set_local_ip4 (3)
+.BR ares_set_local_ip6 (3)
+.SH NOTES
+This function was added in c-ares 1.7.4
+.SH AUTHOR
+Ben Greear
diff --git a/subprojects/c-ares/docs/ares_set_local_ip4.3 b/subprojects/c-ares/docs/ares_set_local_ip4.3
@@ -0,0 +1,36 @@
+.\"
+.\" Copyright 2010 by Ben Greear <greearb@candelatech.com>
+.\"
+.\" Permission to use, copy, modify, and distribute this
+.\" software and its documentation for any purpose and without
+.\" fee is hereby granted, provided that the above copyright
+.\" notice appear in all copies and that both that copyright
+.\" notice and this permission notice appear in supporting
+.\" documentation, and that the name of M.I.T. not be used in
+.\" advertising or publicity pertaining to distribution of the
+.\" software without specific, written prior permission.
+.\" M.I.T. makes no representations about the suitability of
+.\" this software for any purpose. It is provided "as is"
+.\" without express or implied warranty.
+.\"
+.\" SPDX-License-Identifier: MIT
+.\"
+.TH ARES_SET_LOCAL_IP4 3 "30 June 2010"
+.SH NAME
+ares_set_local_ip4 \- Set local IPv4 address outgoing requests.
+.SH SYNOPSIS
+.nf
+#include <ares.h>
+
+void ares_set_local_ip4(ares_channel_t *\fIchannel\fP, unsigned int \fIlocal_ip\fP)
+.fi
+.SH DESCRIPTION
+The \fBares_set_local_ip4\fP function sets the IP address for outbound
+requests. The parameter \fIlocal_ip\fP is specified in host byte order. This
+allows users to specify outbound interfaces when used on multi-homed systems.
+.SH SEE ALSO
+.BR ares_set_local_ip6 (3)
+.SH NOTES
+This function was added in c-ares 1.7.4
+.SH AUTHOR
+Ben Greear
diff --git a/subprojects/c-ares/docs/ares_set_local_ip6.3 b/subprojects/c-ares/docs/ares_set_local_ip6.3
@@ -0,0 +1,37 @@
+.\"
+.\" Copyright 2010 by Ben Greear <greearb@candelatech.com>
+.\"
+.\" Permission to use, copy, modify, and distribute this
+.\" software and its documentation for any purpose and without
+.\" fee is hereby granted, provided that the above copyright
+.\" notice appear in all copies and that both that copyright
+.\" notice and this permission notice appear in supporting
+.\" documentation, and that the name of M.I.T. not be used in
+.\" advertising or publicity pertaining to distribution of the
+.\" software without specific, written prior permission.
+.\" M.I.T. makes no representations about the suitability of
+.\" this software for any purpose. It is provided "as is"
+.\" without express or implied warranty.
+.\"
+.\" SPDX-License-Identifier: MIT
+.\"
+.TH ARES_SET_LOCAL_IP6 3 "30 June 2010"
+.SH NAME
+ares_set_local_ip6 \- Set local IPv6 address outgoing requests.
+.SH SYNOPSIS
+.nf
+#include <ares.h>
+
+void ares_set_local_ip6(ares_channel_t *\fIchannel\fP, const unsigned char* \fIlocal_ip6\fP)
+.fi
+.SH DESCRIPTION
+The \fBares_set_local_ip6\fP function sets the IPv6 address for outbound IPv6
+requests. The parameter \fIlocal_ip6\fP is specified in network byte order.
+This allows users to specify outbound interfaces when used on multi-homed
+systems. The \fIlocal_ip6\fP argument must be 16 bytes in length.
+.SH SEE ALSO
+.BR ares_set_local_ip4 (3)
+.SH NOTES
+This function was added in c-ares 1.7.4
+.SH AUTHOR
+Ben Greear
diff --git a/subprojects/c-ares/docs/ares_set_servers.3 b/subprojects/c-ares/docs/ares_set_servers.3
@@ -0,0 +1,109 @@
+.\"
+.\" Copyright 2010 by Ben Greear <greearb@candelatech.com>
+.\"
+.\" Permission to use, copy, modify, and distribute this
+.\" software and its documentation for any purpose and without
+.\" fee is hereby granted, provided that the above copyright
+.\" notice appear in all copies and that both that copyright
+.\" notice and this permission notice appear in supporting
+.\" documentation, and that the name of M.I.T. not be used in
+.\" advertising or publicity pertaining to distribution of the
+.\" software without specific, written prior permission.
+.\" M.I.T. makes no representations about the suitability of
+.\" this software for any purpose. It is provided "as is"
+.\" without express or implied warranty.
+.\"
+.\" SPDX-License-Identifier: MIT
+.\"
+.TH ARES_SET_SERVERS 3 "5 March 2010"
+.SH NAME
+ares_set_servers, ares_set_servers_ports \- Initialize name server configuration
+for an ares channel. (deprecated)
+.SH SYNOPSIS
+.nf
+#include <ares.h>
+
+int ares_set_servers(ares_channel_t *\fIchannel\fP,
+ const struct ares_addr_node *\fIservers\fP)
+
+int ares_set_servers_ports(ares_channel_t *\fIchannel\fP,
+ const struct ares_addr_port_node *\fIservers\fP)
+.fi
+.SH DESCRIPTION
+The \fBares_set_servers(3)\fP function initializes name servers configuration
+for the channel data identified by
+.IR channel ,
+from a
+.IR servers
+pointer to a linked list of ares_addr_node structs holding name servers
+address data.
+.PP
+The name server linked list pointer argument may be the result of a previous
+call to \fBares_get_servers(3)\fP or a linked list of \fBares_addr_node\fP structs
+set up by other means.
+.PP
+The \fBares_set_servers_ports(3)\fP function also allows the specification of UDP and
+TCP ports to be used for communication on a per-server basis. The provided
+linked list argument may be the result of a previous call to
+\fBares_get_servers_ports(3)\fP or a linked list of \fBares_addr_port_node\fP structs
+set up by other means.
+.PP
+This function replaces any potentially previously configured name servers
+with the ones given in the linked list. So, in order to configure a channel
+with more than one name server all the desired ones must be specified in a
+single list. Though not recommended, passing NULL will clear all configured
+servers and make an inoperable channel, this may be advantageous for test
+simulation but unlikely to be useful in production.
+.PP
+The function does not take ownership of the linked list argument.
+The caller is responsible for freeing the linked list when no longer needed.
+.PP
+This function is capable of handling IPv4 and IPv6 name server
+addresses simultaneously, rendering \fBares_init_options(3)\fP with
+optmask \fBARES_OPT_SERVERS\fP functionally obsolete except for
+IPv4-only name server usage.
+.PP
+As of v1.22.0 this function can
+be called on an active channel with running queries, previously it would return
+ARES_ENOTIMP.
+
+.SH RETURN VALUES
+.B ares_set_servers(3)
+may return any of the following values:
+.TP 15
+.B ARES_SUCCESS
+The name servers configuration was successfully initialized.
+.TP 15
+.B ARES_ENOMEM
+The process's available memory was exhausted.
+.TP 15
+.B ARES_ENODATA
+The channel data identified by
+.IR channel
+was invalid.
+.TP 15
+.B ARES_ENOTINITIALIZED
+c-ares library initialization not yet performed.
+.SH SEE ALSO
+.BR ares_set_servers_csv (3),
+.BR ares_get_servers (3),
+.BR ares_init_options (3),
+.BR ares_dup (3)
+
+.SH NOTES
+Deprecated functions as of c-ares 1.24.0 due to inability to set all available
+server options. Use \fBares_set_servers_csv(3)\fP.
+
+.SH AVAILABILITY
+\fBares_set_servers(3)\fP was added in c-ares 1.7.1;
+\fBares_set_servers_ports(3)\fP was added in c-ares 1.11.0.
+.SH AUTHOR
+Implementation of this function and associated library internals are based
+on code, comments and feedback provided in November and December of 2008 by
+Daniel Stenberg, Gregor Jasny, Phil Blundell and Yang Tse, December 2009
+by Cedric Bail, February 2010 by Jakub Hrozek. On March 2010 Yang Tse
+shuffled all the bits and this function popped out.
+.br
+Copyright 1998 by the Massachusetts Institute of Technology.
+.br
+Copyright (C) 2008-2010 by Daniel Stenberg
diff --git a/subprojects/c-ares/docs/ares_set_servers_csv.3 b/subprojects/c-ares/docs/ares_set_servers_csv.3
@@ -0,0 +1,98 @@
+.\"
+.\" Copyright 2010 by Ben Greear <greearb@candelatech.com>
+.\"
+.\" Permission to use, copy, modify, and distribute this
+.\" software and its documentation for any purpose and without
+.\" fee is hereby granted, provided that the above copyright
+.\" notice appear in all copies and that both that copyright
+.\" notice and this permission notice appear in supporting
+.\" documentation, and that the name of M.I.T. not be used in
+.\" advertising or publicity pertaining to distribution of the
+.\" software without specific, written prior permission.
+.\" M.I.T. makes no representations about the suitability of
+.\" this software for any purpose. It is provided "as is"
+.\" without express or implied warranty.
+.\"
+.\" SPDX-License-Identifier: MIT
+.\"
+.TH ARES_SET_SERVERS_CSV 3 "5 Dec 2023"
+.SH NAME
+ares_set_servers_csv, ares_set_servers_ports_csv, ares_get_servers_csv \- Set
+or Get a list of DNS servers used for queries.
+.SH SYNOPSIS
+.nf
+#include <ares.h>
+
+int ares_set_servers_csv(ares_channel_t *\fIchannel\fP, const char* \fIservers\fP)
+
+int ares_set_servers_ports_csv(ares_channel_t *\fIchannel\fP, const char* \fIservers\fP)
+
+char *ares_get_servers_csv(ares_channel_t *\fIchannel\fP)
+.fi
+.SH DESCRIPTION
+The \fBares_set_servers_csv\fP and \fBares_set_servers_ports_csv\fP functions set
+the list of DNS servers that c-ares will query. As of v1.22.0 this function can
+be called on an active channel with running queries, previously it would return
+ARES_ENOTIMP.
+
+Though not recommended, passing NULL for servers will clear all configured
+servers and make an inoperable channel, this may be advantageous for test
+simulation but unlikely to be useful in production.
+
+The \fBares_get_servers_csv\fP retrieves the list of servers in comma delimited
+format.
+
+The input and output format is a comma separated list of servers. Each server
+entry may contain these forms:
+
+ip[:port][%iface]
+
+The \fBip\fP may be encapsulated in square brackets ([ ]), and must be if
+using ipv6 and also specifying a port.
+
+The \fBport\fP is optional, and will default to 53 or the value specified in
+\fBares_init_options(3)\fP.
+
+The \fBiface\fP is specific to IPv6 link-local servers (fe80::/10) and should
+not otherwise be used.
+
+For example:
+
+192.168.1.100,192.168.1.101:53,[1:2:3::4]:53,[fe80::1]:53%eth0
+.PP
+As of c-ares 1.24.0, \fBares_set_servers_csv\fP and \fBares_set_servers_ports_csv\fP
+are identical. Prior versions would simply omit ports in \fBares_set_servers_csv\fP
+but due to the addition of link local interface support, this difference was
+removed.
+
+.SH RETURN VALUES
+.B ares_set_servers_csv(3)
+and
+.B ares_set_servers_ports_csv(3)
+may return any of the following values:
+.TP 15
+.B ARES_SUCCESS
+The name servers configuration was successfully initialized.
+.TP 15
+.B ARES_ENOMEM
+The process's available memory was exhausted.
+.TP 15
+.B ARES_ENODATA
+The channel data identified by
+.IR channel
+was invalid.
+.TP 15
+.B ARES_ENOTINITIALIZED
+c-ares library initialization not yet performed.
+.PP
+.B ares_get_servers_csv(3)
+returns a string representing the servers configured which must be freed with
+\fBares_free_string(3)\fP. If it returns NULL, this is an out of memory condition.
+.SH SEE ALSO
+.BR ares_set_servers (3)
+.SH AVAILABILITY
+\fBares_set_servers_csv\fP was added in c-ares 1.7.2
+\fBares_set_servers_ports_csv\fP was added in c-ares 1.11.0.
+\fBares_get_servers_csv\fP was added in c-ares 1.24.0.
+.SH AUTHOR
+Ben Greear
diff --git a/subprojects/c-ares/docs/ares_set_servers_ports.3 b/subprojects/c-ares/docs/ares_set_servers_ports.3
@@ -0,0 +1,4 @@
+.\"
+.\" Copyright (C) Daniel Stenberg
+.\" SPDX-License-Identifier: MIT
+.so man3/ares_set_servers.3
diff --git a/subprojects/c-ares/docs/ares_set_servers_ports_csv.3 b/subprojects/c-ares/docs/ares_set_servers_ports_csv.3
@@ -0,0 +1,4 @@
+.\"
+.\" Copyright (C) Daniel Stenberg
+.\" SPDX-License-Identifier: MIT
+.so man3/ares_set_servers_csv.3
diff --git a/subprojects/c-ares/docs/ares_set_socket_callback.3 b/subprojects/c-ares/docs/ares_set_socket_callback.3
@@ -0,0 +1,36 @@
+.\"
+.\" Copyright (C) Daniel Stenberg
+.\" SPDX-License-Identifier: MIT
+.\"
+.TH ARES_SET_SOCKET_CALLBACK 3 "20 Nov 2009"
+.SH NAME
+ares_set_socket_callback \- Set a socket creation callback
+.SH SYNOPSIS
+.nf
+#include <ares.h>
+
+typedef int (*ares_sock_create_callback)(ares_socket_t \fIsocket_fd\fP,
+ int \fItype\fP,
+ void *\fIuserdata\fP)
+
+void ares_set_socket_callback(ares_channel_t *\fIchannel\fP,
+ ares_sock_create_callback \fIcallback\fP,
+ void *\fIuserdata\fP)
+.PP
+.B cc file.c -lcares
+.fi
+.SH DESCRIPTION
+.PP
+This function sets a \fIcallback\fP in the given ares channel handle. This
+callback function will be invoked after the socket has been created, and
+connected to the remote server. The callback must return ARES_SUCCESS if
+things are fine, or return -1 to signal an error. A returned error will
+abort the ares operation.
+.SH SEE ALSO
+.BR ares_init_options (3),
+.BR ares_set_socket_configure_callback (3)
+.SH AVAILABILITY
+ares_set_socket_callback(3) was added in c-ares 1.6.0
+.SH AUTHOR
+Gregor Jasny
+
diff --git a/subprojects/c-ares/docs/ares_set_socket_configure_callback.3 b/subprojects/c-ares/docs/ares_set_socket_configure_callback.3
@@ -0,0 +1,34 @@
+.\"
+.\" Copyright (C) Daniel Stenberg
+.\" SPDX-License-Identifier: MIT
+.TH ARES_SET_SOCKET_CONFIGURE_CALLBACK 3 "6 Feb 2016"
+.SH NAME
+ares_set_socket_configure_callback \- Set a socket configuration callback
+.SH SYNOPSIS
+.nf
+#include <ares.h>
+
+typedef int (*ares_sock_config_callback)(ares_socket_t \fIsocket_fd\fP,
+ int \fItype\fP,
+ void *\fIuserdata\fP)
+
+void ares_set_socket_configure_callback(ares_channel_t *\fIchannel\fP,
+ ares_sock_config_callback \fIcallback\fP,
+ void *\fIuserdata\fP)
+.fi
+.SH DESCRIPTION
+.PP
+This function sets a \fIcallback\fP in the given ares channel handle. This
+callback function will be invoked after the socket has been created, but
+before it has been connected to the remote server, which is an ideal time
+to configure various socket options. The callback must return ARES_SUCCESS
+if things are fine, or return -1 to signal an error. A returned error will
+abort the ares operation.
+.SH SEE ALSO
+.BR ares_init_options (3),
+.BR ares_set_socket_callback (3)
+.SH AVAILABILITY
+ares_set_socket_configure_callback(3) was added in c-ares 1.11.0
+.SH AUTHOR
+Andrew Ayer
+
diff --git a/subprojects/c-ares/docs/ares_set_socket_functions.3 b/subprojects/c-ares/docs/ares_set_socket_functions.3
@@ -0,0 +1,101 @@
+.\" Copyright (C) Daniel Stenberg
+.\" SPDX-License-Identifier: MIT
+.TH ARES_SET_SOCKET_FUNCTIONS 3 "13 Dec 2016"
+.SH NAME
+ares_set_socket_functions \- Set socket io callbacks
+.SH SYNOPSIS
+.nf
+#include <ares.h>
+
+struct ares_socket_functions {
+ ares_socket_t (*\fIasocket\fP)(int, int, int, void *);
+ int (*\fIaclose\fP)(ares_socket_t, void *);
+ int (*\fIaconnect\fP)(ares_socket_t, const struct sockaddr *, ares_socklen_t, void *);
+ ares_ssize_t (*\fIarecvfrom\fP)(ares_socket_t, void *, size_t, int,
+ struct sockaddr *, ares_socklen_t *, void *);
+ ares_ssize_t (*\fIasendv\fP)(ares_socket_t, const struct iovec *, int, void *);
+};
+
+void ares_set_socket_functions(ares_channel_t *\fIchannel\fP,
+ const struct ares_socket_functions * \fIfunctions\fP,
+ void *\fIuser_data\fP);
+.fi
+.SH DESCRIPTION
+.PP
+This function sets a set of callback \fIfunctions\fP in the given ares channel handle.
+These callback functions will be invoked to create/destroy socket objects and perform
+io, instead of the normal system calls. A client application can override normal network
+operation fully through this functionality, and provide its own transport layer. You
+can choose to only implement some of the socket functions, and provide NULL to any
+others and c-ares will use its built-in system functions in that case.
+.PP
+All callback functions are expected to operate like their system equivalents, and to
+set
+.BR errno(3)
+to an appropriate error code on failure. C-ares also expects all io functions to behave
+asynchronously, i.e. as if the socket object has been set to non-blocking mode. Thus
+read/write calls (for TCP connections) are expected to often generate
+.BR EAGAIN
+or
+.BR EWOULDBLOCK.
+
+.PP
+The \fIuser_data\fP value is provided to each callback function invocation to serve as
+context.
+.PP
+The
+.B ares_socket_functions
+must provide the following callbacks:
+.TP 18
+.B \fIasocket\fP
+.B ares_socket_t(*)(int \fIdomain\fP, int \fItype\fP, int \fIprotocol\fP, void * \fIuser_data\fP)
+.br
+Creates an endpoint for communication and returns a descriptor. \fIdomain\fP, \fItype\fP, and \fIprotocol\fP
+each correspond to the parameters of
+.BR socket(2).
+Returns ahandle to the newly created socket, or -1 on error.
+.TP 18
+.B \fIaclose\fP
+.B int(*)(ares_socket_t \fIfd\fP, void * \fIuser_data\fP)
+.br
+Closes the socket endpoint indicated by \fIfd\fP. See
+.BR close(2)
+.TP 18
+.B \fIaconnect\fP
+.B int(*)(ares_socket_t \fIfd\fP, const struct sockaddr * \fIaddr\fP, ares_socklen_t \fIaddr_len\fP, void * \fIuser_data\fP)
+.br
+Initiate a connection to the address indicated by \fIaddr\fP on a socket. See
+.BR connect(2)
+
+.TP 18
+.B \fIarecvfrom\fP
+.B ares_ssize_t(*)(ares_socket_t \fIfd\fP, void * \fIbuffer\fP, size_t \fIbuf_size\fP, int \fIflags\fP, struct sockaddr * \fIaddr\fP, ares_socklen_t * \fIaddr_len\fP, void * \fIuser_data\fP)
+.br
+Receives data from remote socket endpoint, if available. If the \fIaddr\fP parameter is not NULL and the connection protocol provides the source address, the callback should fill this in. See
+.BR recvfrom(2)
+
+.TP 18
+.B \fIasendv\fP
+.B ares_ssize_t(*)(ares_socket_t \fIfd\fP, const struct iovec * \fIdata\fP, int \fIlen\fP, void * \fIuser_data\fP)
+.br
+Send data, as provided by the iovec array \fIdata\fP, to the socket endpoint. See
+.BR writev(2),
+
+.PP
+The
+.B ares_socket_functions
+struct provided is not copied but directly referenced,
+and must thus remain valid through out the channels and any created socket's lifetime.
+.SH AVAILABILITY
+Added in c-ares 1.13.0
+.SH SEE ALSO
+.BR ares_init_options (3),
+.BR socket (2),
+.BR close (2),
+.BR connect (2),
+.BR recv (2),
+.BR recvfrom (2),
+.BR send (2),
+.BR writev (2)
+.SH AUTHOR
+Carl Wilund
diff --git a/subprojects/c-ares/docs/ares_set_sortlist.3 b/subprojects/c-ares/docs/ares_set_sortlist.3
@@ -0,0 +1,61 @@
+.\"
+.\" Copyright (C) Daniel Stenberg
+.\" Permission to use, copy, modify, and distribute this
+.\" software and its documentation for any purpose and without
+.\" fee is hereby granted, provided that the above copyright
+.\" notice appear in all copies and that both that copyright
+.\" notice and this permission notice appear in supporting
+.\" documentation, and that the name of M.I.T. not be used in
+.\" advertising or publicity pertaining to distribution of the
+.\" software without specific, written prior permission.
+.\" M.I.T. makes no representations about the suitability of
+.\" this software for any purpose. It is provided "as is"
+.\" without express or implied warranty.
+.\"
+.\" SPDX-License-Identifier: MIT
+.\"
+.TH ARES_SET_SORTLIST 3 "23 November 2015"
+.SH NAME
+ares_set_sortlist \- Initialize an ares_channel_t *sortlist configuration
+.SH SYNOPSIS
+.nf
+#include <ares.h>
+
+int ares_set_sortlist(ares_channel_t *\fIchannel\fP, const char *\fIsortstr\fP)
+.fi
+.SH DESCRIPTION
+The \fBares_set_sortlist(3)\fP function initializes an address sortlist configuration
+for the channel data identified by
+.IR channel ,
+so that addresses returned by \fBares_gethostbyname(3)\fP are sorted according to the
+sortlist. The provided
+.IR sortstr
+string that holds a space separated list of IP-address-netmask pairs. The
+netmask is optional but follows the address after a slash if present. For example,
+"130.155.160.0/255.255.240.0 130.155.0.0".
+
+This function replaces any potentially previously configured address sortlist
+with the ones given in the configuration string.
+
+.SH RETURN VALUES
+.B ares_set_sortlist(3)
+may return any of the following values:
+.TP 15
+.B ARES_SUCCESS
+The sortlist configuration was successfully initialized.
+.TP 15
+.B ARES_ENOMEM
+The process's available memory was exhausted.
+.TP 15
+.B ARES_ENODATA
+The channel data identified by
+.IR channel
+was invalid.
+.TP 15
+.B ARES_ENOTINITIALIZED
+c-ares library initialization not yet performed.
+.SH SEE ALSO
+.BR ares_init_options (3),
+.BR ares_dup (3)
+.SH AVAILABILITY
+ares_set_sortlist(3) was added in c-ares 1.11.0
diff --git a/subprojects/c-ares/docs/ares_strerror.3 b/subprojects/c-ares/docs/ares_strerror.3
@@ -0,0 +1,39 @@
+.\"
+.\" Copyright 1998 by the Massachusetts Institute of Technology.
+.\"
+.\" Permission to use, copy, modify, and distribute this
+.\" software and its documentation for any purpose and without
+.\" fee is hereby granted, provided that the above copyright
+.\" notice appear in all copies and that both that copyright
+.\" notice and this permission notice appear in supporting
+.\" documentation, and that the name of M.I.T. not be used in
+.\" advertising or publicity pertaining to distribution of the
+.\" software without specific, written prior permission.
+.\" M.I.T. makes no representations about the suitability of
+.\" this software for any purpose. It is provided "as is"
+.\" without express or implied warranty.
+.\"
+.\" SPDX-License-Identifier: MIT
+.\"
+.TH ARES_STRERROR 3 "25 July 1998"
+.SH NAME
+ares_strerror \- Get the description of an ares library error code
+.SH SYNOPSIS
+.nf
+#include <ares.h>
+
+const char *ares_strerror(int \fIcode\fP)
+.fi
+.SH DESCRIPTION
+The
+.B ares_strerror
+function gets the description of the ares library error code
+.IR code ,
+returning the result as a NUL-terminated C string.
+.SH NOTES
+This function is not compatible with ares, it takes a different set of
+arguments.
+.SH AUTHOR
+Greg Hudson, MIT Information Systems
+.br
+Copyright 1998 by the Massachusetts Institute of Technology.
diff --git a/subprojects/c-ares/docs/ares_svcb_param_t.3 b/subprojects/c-ares/docs/ares_svcb_param_t.3
@@ -0,0 +1,4 @@
+.\"
+.\" Copyright (C) Daniel Stenberg
+.\" SPDX-License-Identifier: MIT
+.so man3/ares_dns_mapping.3
diff --git a/subprojects/c-ares/docs/ares_threadsafety.3 b/subprojects/c-ares/docs/ares_threadsafety.3
@@ -0,0 +1,43 @@
+.\"
+.\" SPDX-License-Identifier: MIT
+.\"
+.TH ARES_REINIT 3 "26 November 2023"
+.SH NAME
+ares_threadsafety \- Query if c-ares was built with thread-safety
+.SH SYNOPSIS
+.nf
+#include <ares.h>
+
+ares_bool_t ares_threadsafety(void);
+.fi
+.SH DESCRIPTION
+The \fBares_threadsafety(3)\fP function returns if the library was built with
+thread safety enabled or not.
+
+As of c-ares 1.23.0, this simply means that every public function which
+references an \fIares_channel_t\fP object will lock the channel on entry and
+release the lock on exit of the function. This will prevent concurrent
+thread access to the channel, thus ensuring no corruption can occur. Future
+versions will likely implement more threading-specific features.
+
+.SH RETURN VALUES
+\fIares_threadsafety(3)\fP can return any of the following values:
+.TP 14
+.B ARES_TRUE
+Built with thread safety.
+.TP 14
+.B ARES_FALSE
+Built without thread safety
+.TP 14
+
+.SH AVAILABILITY
+This function was first introduced in c-ares version 1.23.0.
+.SH SEE ALSO
+.BR ares_init (3),
+.BR ares_init_options (3),
+.BR ares_destroy (3),
+.BR ares_dup (3),
+.BR ares_library_init (3),
+.BR ares_set_servers (3)
+.SH AUTHOR
+Copyright (C) 2023 The c-ares project and its members.
diff --git a/subprojects/c-ares/docs/ares_timeout.3 b/subprojects/c-ares/docs/ares_timeout.3
@@ -0,0 +1,48 @@
+.\"
+.\" Copyright 1998 by the Massachusetts Institute of Technology.
+.\"
+.\" Permission to use, copy, modify, and distribute this
+.\" software and its documentation for any purpose and without
+.\" fee is hereby granted, provided that the above copyright
+.\" notice appear in all copies and that both that copyright
+.\" notice and this permission notice appear in supporting
+.\" documentation, and that the name of M.I.T. not be used in
+.\" advertising or publicity pertaining to distribution of the
+.\" software without specific, written prior permission.
+.\" M.I.T. makes no representations about the suitability of
+.\" this software for any purpose. It is provided "as is"
+.\" without express or implied warranty.
+.\"
+.\" SPDX-License-Identifier: MIT
+.\"
+.TH ARES_TIMEOUT 3 "25 July 1998"
+.SH NAME
+ares_timeout \- return maximum time to wait
+.SH SYNOPSIS
+.nf
+#include <ares.h>
+
+struct timeval *ares_timeout(ares_channel_t *\fIchannel\fP,
+ struct timeval *\fImaxtv\fP,
+ struct timeval *\fItv\fP)
+.fi
+.SH DESCRIPTION
+The \fBares_timeout(3)\fP function determines the maximum time for which the
+caller should wait before invoking \fIares_process(3)\fP to process timeouts.
+The parameter \fImaxtv\fP specifies a existing maximum timeout, or \fBNULL\fP
+if the caller does not wish to apply a maximum timeout. The parameter
+\fItv\fP must point to a writable buffer of type \fBstruct timeval\fP It is
+valid for \fImaxtv\fP and \fItv\fP to have the same value.
+
+If no queries have timeouts pending sooner than the given maximum timeout,
+\fBares_timeout(3)\fP returns the value of \fImaxtv\fP; otherwise
+\fBares_timeout(3)\fP stores the appropriate timeout value into the buffer
+pointed to by \fItv\fP and returns the value of \fItv\fP.
+.SH SEE ALSO
+.BR ares_fds (3),
+.BR ares_process (3),
+.BR ares_process_fd (3)
+.SH AUTHOR
+Greg Hudson, MIT Information Systems
+.br
+Copyright 1998 by the Massachusetts Institute of Technology.
diff --git a/subprojects/c-ares/docs/ares_tlsa_match_t.3 b/subprojects/c-ares/docs/ares_tlsa_match_t.3
@@ -0,0 +1,3 @@
+.\" Copyright (C) 2023 The c-ares project and its contributors.
+.\" SPDX-License-Identifier: MIT
+.so man3/ares_dns_rr.3
diff --git a/subprojects/c-ares/docs/ares_tlsa_selector_t.3 b/subprojects/c-ares/docs/ares_tlsa_selector_t.3
@@ -0,0 +1,3 @@
+.\" Copyright (C) 2023 The c-ares project and its contributors.
+.\" SPDX-License-Identifier: MIT
+.so man3/ares_dns_rr.3
diff --git a/subprojects/c-ares/docs/ares_tlsa_usage_t.3 b/subprojects/c-ares/docs/ares_tlsa_usage_t.3
@@ -0,0 +1,3 @@
+.\" Copyright (C) 2023 The c-ares project and its contributors.
+.\" SPDX-License-Identifier: MIT
+.so man3/ares_dns_rr.3
diff --git a/subprojects/c-ares/docs/ares_version.3 b/subprojects/c-ares/docs/ares_version.3
@@ -0,0 +1,37 @@
+.\"
+.\" Copyright 2004 by Daniel Stenberg
+.\"
+.\" Permission to use, copy, modify, and distribute this
+.\" software and its documentation for any purpose and without
+.\" fee is hereby granted, provided that the above copyright
+.\" notice appear in all copies and that both that copyright
+.\" notice and this permission notice appear in supporting
+.\" documentation, and that the name of M.I.T. not be used in
+.\" advertising or publicity pertaining to distribution of the
+.\" software without specific, written prior permission.
+.\" M.I.T. makes no representations about the suitability of
+.\" this software for any purpose. It is provided "as is"
+.\" without express or implied warranty.
+.\"
+.\" SPDX-License-Identifier: MIT
+.\"
+.TH ARES_VERSION 3 "29 January 2004"
+.SH NAME
+ares_version \- Get the version number of the library
+.SH SYNOPSIS
+.nf
+#include <ares.h>
+
+const char *ares_version(int *\fIversion\fP)
+.fi
+.SH DESCRIPTION
+The \fBares_version(3)\fP function gets the library version as a string and
+optionally as an integer stored in the \fIversion\fP argument. If you pass a
+NULL, no integer is attempted to be returned.
+
+The integer is built up as 24bit number, with 8 separate bits used for major
+number, minor number and patch number. This makes a version string such as
+1.2.3 will be returned as the hexadecimal number 0x010203 (decimal 66051).
+.SH "SEE ALSO"
+.BR ares_init (3),
+.BR ares_library_init (3)
diff --git a/subprojects/c-ares/get_ver.awk b/subprojects/c-ares/get_ver.awk
@@ -0,0 +1,29 @@
+# ***************************************************************************
+# * Project: c-ares
+# *
+# * Copyright (C) The c-ares project and its contributors
+# * SPDX-License-Identifier: MIT
+# ***************************************************************************
+# awk script which fetches c-ares version number and string from input
+# file and writes them to STDOUT. Here you can get an awk version for Win32:
+# http://www.gknw.net/development/prgtools/awk-20100523.zip
+#
+BEGIN {
+ while ((getline < ARGV[1]) > 0) {
+ sub("\r", "") # make MSYS gawk work with CRLF header input.
+ if (match ($0, /^#define ARES_COPYRIGHT "[^"]+"$/))
+ copyright_string = substr($0, 25, length($0)-25)
+ else if (match ($0, /^#define ARES_VERSION_STR "[^"]+"$/))
+ version_string = substr($3, 2, length($3)-2)
+ else if (match ($0, /^#define ARES_VERSION_MAJOR [0-9]+$/))
+ version_major = $3
+ else if (match ($0, /^#define ARES_VERSION_MINOR [0-9]+$/))
+ version_minor = $3
+ else if (match ($0, /^#define ARES_VERSION_PATCH [0-9]+$/))
+ version_patch = $3
+ }
+ print "LIBCARES_VERSION = " version_major "," version_minor "," version_patch
+ print "LIBCARES_VERSION_STR = " version_string
+ print "LIBCARES_COPYRIGHT_STR = " copyright_string
+}
+
diff --git a/subprojects/c-ares/git2changes.pl b/subprojects/c-ares/git2changes.pl
@@ -0,0 +1,79 @@
+#!/usr/bin/perl
+# Copyright (C) The c-ares project and its contributors
+# SPDX-License-Identifier: MIT
+
+# git log --pretty=fuller --no-color --date=short --decorate=full
+
+my @mname = ('Jan', 'Feb', 'Mar', 'Apr', 'May', 'Jun',
+ 'Jul', 'Aug', 'Sep', 'Oct', 'Nov', 'Dec' );
+
+sub nicedate {
+ my ($date)=$_;
+
+ if($date =~ /(\d\d\d\d)-(\d\d)-(\d\d)/) {
+ return sprintf("%d %s %4d", $3, $mname[$2-1], $1);
+ }
+ return $date;
+}
+
+print
+' Changelog for the c-ares project. Generated with git2changes.pl
+';
+
+my $line;
+my $tag;
+while(<STDIN>) {
+ my $l = $_;
+
+ if($l =~/^commit ([[:xdigit:]]*) ?(.*)/) {
+ $co = $1;
+ my $ref = $2;
+ if ($ref =~ /refs\/tags\/c[-]*ares-([0-9._]*)/) {
+ $tag = $1;
+ $tag =~ s/_/./g;
+ } else {
+ $tag = '';
+ }
+ }
+ elsif($l =~ /^Author: *(.*) +</) {
+ $a = $1;
+ }
+ elsif($l =~ /^Commit: *(.*) +</) {
+ $c = $1;
+ }
+ elsif($l =~ /^CommitDate: (.*)/) {
+ $date = nicedate($1);
+ }
+ elsif($l =~ /^( )(.*)/) {
+ my $extra;
+ if ($tag) {
+ # Version entries have a special format
+ print "\nVersion " . $tag." ($date)\n";
+ $oldc = "";
+ $tag = "";
+ }
+ if($a ne $c) {
+ $extra=sprintf("\n- [%s brought this change]\n\n ", $a);
+ }
+ else {
+ $extra="\n- ";
+ }
+ if($co ne $oldco) {
+ if($c ne $oldc) {
+ print "\n$c ($date)$extra";
+ }
+ else {
+ print "$extra";
+ }
+ $line =0;
+ }
+
+ $oldco = $co;
+ $oldc = $c;
+ $olddate = $date;
+ if($line++) {
+ print " ";
+ }
+ print $2."\n";
+ }
+}
diff --git a/subprojects/c-ares/include/CMakeLists.txt b/subprojects/c-ares/include/CMakeLists.txt
@@ -0,0 +1,10 @@
+# Copyright (C) The c-ares project and its contributors
+# SPDX-License-Identifier: MIT
+# Write ares_build.h configuration file. This is an installed file.
+CONFIGURE_FILE (ares_build.h.cmake ${PROJECT_BINARY_DIR}/ares_build.h)
+
+# Headers installation target
+IF (CARES_INSTALL)
+ SET (CARES_HEADERS ares.h ares_version.h "${PROJECT_BINARY_DIR}/ares_build.h" ares_rules.h ares_dns.h ares_dns_record.h ares_nameser.h)
+ INSTALL (FILES ${CARES_HEADERS} COMPONENT Devel DESTINATION ${CMAKE_INSTALL_INCLUDEDIR})
+ENDIF ()
diff --git a/subprojects/c-ares/include/Makefile.am b/subprojects/c-ares/include/Makefile.am
@@ -0,0 +1,9 @@
+# Copyright (C) Daniel Stenberg
+# SPDX-License-Identifier: MIT
+AUTOMAKE_OPTIONS = foreign nostdinc 1.9.6
+ACLOCAL_AMFLAGS = -I m4 --install
+
+# what headers to install on 'make install':
+include_HEADERS = ares.h ares_version.h ares_build.h ares_rules.h ares_dns.h ares_dns_record.h ares_nameser.h
+
+EXTRA_DIST = ares_build.h.cmake ares_build.h.in ares_build.h.dist CMakeLists.txt
diff --git a/subprojects/c-ares/include/ares.h b/subprojects/c-ares/include/ares.h
@@ -0,0 +1,765 @@
+/* MIT License
+ *
+ * Copyright (c) Massachusetts Institute of Technology
+ * Copyright (c) Daniel Stenberg
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice (including the next
+ * paragraph) shall be included in all copies or substantial portions of the
+ * Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ *
+ * SPDX-License-Identifier: MIT
+ */
+
+#ifndef ARES__H
+#define ARES__H
+
+#include "ares_version.h" /* c-ares version defines */
+#include "ares_build.h" /* c-ares build definitions */
+#include "ares_rules.h" /* c-ares rules enforcement */
+
+/*
+ * Define WIN32 when build target is Win32 API
+ */
+
+#if (defined(_WIN32) || defined(__WIN32__)) && !defined(WIN32) && \
+ !defined(__SYMBIAN32__)
+# define WIN32
+#endif
+
+#include <sys/types.h>
+
+/* HP-UX systems version 9, 10 and 11 lack sys/select.h and so does oldish
+ libc5-based Linux systems. Only include it on system that are known to
+ require it! */
+#if defined(_AIX) || defined(__NOVELL_LIBC__) || defined(__NetBSD__) || \
+ defined(__minix) || defined(__SYMBIAN32__) || defined(__INTEGRITY) || \
+ defined(ANDROID) || defined(__ANDROID__) || defined(__OpenBSD__) || \
+ defined(__QNXNTO__) || defined(__MVS__) || defined(__HAIKU__)
+# include <sys/select.h>
+#endif
+#if (defined(NETWARE) && !defined(__NOVELL_LIBC__))
+# include <sys/bsdskt.h>
+#endif
+
+#if defined(WATT32)
+# include <netinet/in.h>
+# include <sys/socket.h>
+# include <tcp.h>
+#elif defined(_WIN32_WCE)
+# ifndef WIN32_LEAN_AND_MEAN
+# define WIN32_LEAN_AND_MEAN
+# endif
+# include <windows.h>
+# include <winsock.h>
+#elif defined(WIN32)
+# ifndef WIN32_LEAN_AND_MEAN
+# define WIN32_LEAN_AND_MEAN
+# endif
+# include <windows.h>
+# include <winsock2.h>
+# include <ws2tcpip.h>
+/* To aid with linking against a static c-ares build, lets tell the microsoft
+ * compiler to pull in needed dependencies */
+# ifdef _MSC_VER
+# pragma comment(lib, "ws2_32")
+# pragma comment(lib, "advapi32")
+# pragma comment(lib, "iphlpapi")
+# endif
+#else
+# include <sys/socket.h>
+# include <netinet/in.h>
+#endif
+
+#if defined(ANDROID) || defined(__ANDROID__)
+# include <jni.h>
+#endif
+
+#ifdef __cplusplus
+extern "C" {
+#endif
+
+/*
+** c-ares external API function linkage decorations.
+*/
+
+#if defined(_WIN32) || defined(__CYGWIN__) || defined(__SYMBIAN32__)
+# ifdef CARES_STATICLIB
+# define CARES_EXTERN
+# else
+# ifdef CARES_BUILDING_LIBRARY
+# define CARES_EXTERN __declspec(dllexport)
+# else
+# define CARES_EXTERN __declspec(dllimport)
+# endif
+# endif
+#else
+# if defined(__GNUC__) && __GNUC__ >= 4
+# define CARES_EXTERN __attribute__ ((visibility ("default")))
+# elif defined(__INTEL_COMPILER) && __INTEL_COMPILER >= 900
+# define CARES_EXTERN __attribute__ ((visibility ("default")))
+# elif defined(__SUNPRO_C)
+# define CARES_EXTERN _global
+# else
+# define CARES_EXTERN
+# endif
+#endif
+
+typedef enum {
+ ARES_SUCCESS = 0,
+
+ /* Server error codes (ARES_ENODATA indicates no relevant answer) */
+ ARES_ENODATA = 1,
+ ARES_EFORMERR = 2,
+ ARES_ESERVFAIL = 3,
+ ARES_ENOTFOUND = 4,
+ ARES_ENOTIMP = 5,
+ ARES_EREFUSED = 6,
+
+ /* Locally generated error codes */
+ ARES_EBADQUERY = 7,
+ ARES_EBADNAME = 8,
+ ARES_EBADFAMILY = 9,
+ ARES_EBADRESP = 10,
+ ARES_ECONNREFUSED = 11,
+ ARES_ETIMEOUT = 12,
+ ARES_EOF = 13,
+ ARES_EFILE = 14,
+ ARES_ENOMEM = 15,
+ ARES_EDESTRUCTION = 16,
+ ARES_EBADSTR = 17,
+
+ /* ares_getnameinfo error codes */
+ ARES_EBADFLAGS = 18,
+
+ /* ares_getaddrinfo error codes */
+ ARES_ENONAME = 19,
+ ARES_EBADHINTS = 20,
+
+ /* Uninitialized library error code */
+ ARES_ENOTINITIALIZED = 21, /* introduced in 1.7.0 */
+
+ /* ares_library_init error codes */
+ ARES_ELOADIPHLPAPI = 22, /* introduced in 1.7.0 */
+ ARES_EADDRGETNETWORKPARAMS = 23, /* introduced in 1.7.0 */
+
+ /* More error codes */
+ ARES_ECANCELLED = 24, /* introduced in 1.7.0 */
+
+ /* More ares_getaddrinfo error codes */
+ ARES_ESERVICE = 25 /* ares_getaddrinfo() was passed a text service name that
+ * is not recognized. introduced in 1.16.0 */
+} ares_status_t;
+
+typedef enum {
+ ARES_FALSE = 0,
+ ARES_TRUE = 1
+} ares_bool_t;
+
+/* Flag values */
+#define ARES_FLAG_USEVC (1 << 0)
+#define ARES_FLAG_PRIMARY (1 << 1)
+#define ARES_FLAG_IGNTC (1 << 2)
+#define ARES_FLAG_NORECURSE (1 << 3)
+#define ARES_FLAG_STAYOPEN (1 << 4)
+#define ARES_FLAG_NOSEARCH (1 << 5)
+#define ARES_FLAG_NOALIASES (1 << 6)
+#define ARES_FLAG_NOCHECKRESP (1 << 7)
+#define ARES_FLAG_EDNS (1 << 8)
+
+/* Option mask values */
+#define ARES_OPT_FLAGS (1 << 0)
+#define ARES_OPT_TIMEOUT (1 << 1)
+#define ARES_OPT_TRIES (1 << 2)
+#define ARES_OPT_NDOTS (1 << 3)
+#define ARES_OPT_UDP_PORT (1 << 4)
+#define ARES_OPT_TCP_PORT (1 << 5)
+#define ARES_OPT_SERVERS (1 << 6)
+#define ARES_OPT_DOMAINS (1 << 7)
+#define ARES_OPT_LOOKUPS (1 << 8)
+#define ARES_OPT_SOCK_STATE_CB (1 << 9)
+#define ARES_OPT_SORTLIST (1 << 10)
+#define ARES_OPT_SOCK_SNDBUF (1 << 11)
+#define ARES_OPT_SOCK_RCVBUF (1 << 12)
+#define ARES_OPT_TIMEOUTMS (1 << 13)
+#define ARES_OPT_ROTATE (1 << 14)
+#define ARES_OPT_EDNSPSZ (1 << 15)
+#define ARES_OPT_NOROTATE (1 << 16)
+#define ARES_OPT_RESOLVCONF (1 << 17)
+#define ARES_OPT_HOSTS_FILE (1 << 18)
+#define ARES_OPT_UDP_MAX_QUERIES (1 << 19)
+#define ARES_OPT_MAXTIMEOUTMS (1 << 20)
+#define ARES_OPT_QUERY_CACHE (1 << 21)
+
+/* Nameinfo flag values */
+#define ARES_NI_NOFQDN (1 << 0)
+#define ARES_NI_NUMERICHOST (1 << 1)
+#define ARES_NI_NAMEREQD (1 << 2)
+#define ARES_NI_NUMERICSERV (1 << 3)
+#define ARES_NI_DGRAM (1 << 4)
+#define ARES_NI_TCP 0
+#define ARES_NI_UDP ARES_NI_DGRAM
+#define ARES_NI_SCTP (1 << 5)
+#define ARES_NI_DCCP (1 << 6)
+#define ARES_NI_NUMERICSCOPE (1 << 7)
+#define ARES_NI_LOOKUPHOST (1 << 8)
+#define ARES_NI_LOOKUPSERVICE (1 << 9)
+/* Reserved for future use */
+#define ARES_NI_IDN (1 << 10)
+#define ARES_NI_IDN_ALLOW_UNASSIGNED (1 << 11)
+#define ARES_NI_IDN_USE_STD3_ASCII_RULES (1 << 12)
+
+/* Addrinfo flag values */
+#define ARES_AI_CANONNAME (1 << 0)
+#define ARES_AI_NUMERICHOST (1 << 1)
+#define ARES_AI_PASSIVE (1 << 2)
+#define ARES_AI_NUMERICSERV (1 << 3)
+#define ARES_AI_V4MAPPED (1 << 4)
+#define ARES_AI_ALL (1 << 5)
+#define ARES_AI_ADDRCONFIG (1 << 6)
+#define ARES_AI_NOSORT (1 << 7)
+#define ARES_AI_ENVHOSTS (1 << 8)
+/* Reserved for future use */
+#define ARES_AI_IDN (1 << 10)
+#define ARES_AI_IDN_ALLOW_UNASSIGNED (1 << 11)
+#define ARES_AI_IDN_USE_STD3_ASCII_RULES (1 << 12)
+#define ARES_AI_CANONIDN (1 << 13)
+
+#define ARES_AI_MASK \
+ (ARES_AI_CANONNAME | ARES_AI_NUMERICHOST | ARES_AI_PASSIVE | \
+ ARES_AI_NUMERICSERV | ARES_AI_V4MAPPED | ARES_AI_ALL | ARES_AI_ADDRCONFIG)
+#define ARES_GETSOCK_MAXNUM \
+ 16 /* ares_getsock() can return info about this \
+ many sockets */
+#define ARES_GETSOCK_READABLE(bits, num) (bits & (1 << (num)))
+#define ARES_GETSOCK_WRITABLE(bits, num) \
+ (bits & (1 << ((num) + ARES_GETSOCK_MAXNUM)))
+
+/* c-ares library initialization flag values */
+#define ARES_LIB_INIT_NONE (0)
+#define ARES_LIB_INIT_WIN32 (1 << 0)
+#define ARES_LIB_INIT_ALL (ARES_LIB_INIT_WIN32)
+
+
+/*
+ * Typedef our socket type
+ */
+
+#ifndef ares_socket_typedef
+# ifdef WIN32
+typedef SOCKET ares_socket_t;
+# define ARES_SOCKET_BAD INVALID_SOCKET
+# else
+typedef int ares_socket_t;
+# define ARES_SOCKET_BAD -1
+# endif
+# define ares_socket_typedef
+#endif /* ares_socket_typedef */
+
+typedef void (*ares_sock_state_cb)(void *data, ares_socket_t socket_fd,
+ int readable, int writable);
+
+struct apattern;
+
+/* NOTE about the ares_options struct to users and developers.
+
+ This struct will remain looking like this. It will not be extended nor
+ shrunk in future releases, but all new options will be set by ares_set_*()
+ options instead of with the ares_init_options() function.
+
+ Eventually (in a galaxy far far away), all options will be settable by
+ ares_set_*() options and the ares_init_options() function will become
+ deprecated.
+
+ When new options are added to c-ares, they are not added to this
+ struct. And they are not "saved" with the ares_save_options() function but
+ instead we encourage the use of the ares_dup() function. Needless to say,
+ if you add config options to c-ares you need to make sure ares_dup()
+ duplicates this new option.
+
+ */
+struct ares_options {
+ int flags;
+ int timeout; /* in seconds or milliseconds, depending on options */
+ int tries;
+ int ndots;
+ unsigned short udp_port; /* host byte order */
+ unsigned short tcp_port; /* host byte order */
+ int socket_send_buffer_size;
+ int socket_receive_buffer_size;
+ struct in_addr *servers;
+ int nservers;
+ char **domains;
+ int ndomains;
+ char *lookups;
+ ares_sock_state_cb sock_state_cb;
+ void *sock_state_cb_data;
+ struct apattern *sortlist;
+ int nsort;
+ int ednspsz;
+ char *resolvconf_path;
+ char *hosts_path;
+ int udp_max_queries;
+ int maxtimeout; /* in milliseconds */
+ unsigned int qcache_max_ttl; /* Maximum TTL for query cache, 0=disabled */
+};
+
+struct hostent;
+struct timeval;
+struct sockaddr;
+struct ares_channeldata;
+struct ares_addrinfo;
+struct ares_addrinfo_hints;
+
+/* Legacy typedef, don't use, you can't specify "const" */
+typedef struct ares_channeldata *ares_channel;
+
+/* Current main channel typedef */
+typedef struct ares_channeldata ares_channel_t;
+
+
+typedef void (*ares_callback)(void *arg, int status, int timeouts,
+ unsigned char *abuf, int alen);
+
+typedef void (*ares_host_callback)(void *arg, int status, int timeouts,
+ struct hostent *hostent);
+
+typedef void (*ares_nameinfo_callback)(void *arg, int status, int timeouts,
+ char *node, char *service);
+
+typedef int (*ares_sock_create_callback)(ares_socket_t socket_fd, int type,
+ void *data);
+
+typedef int (*ares_sock_config_callback)(ares_socket_t socket_fd, int type,
+ void *data);
+
+typedef void (*ares_addrinfo_callback)(void *arg, int status, int timeouts,
+ struct ares_addrinfo *res);
+
+CARES_EXTERN int ares_library_init(int flags);
+
+CARES_EXTERN int ares_library_init_mem(int flags, void *(*amalloc)(size_t size),
+ void (*afree)(void *ptr),
+ void *(*arealloc)(void *ptr,
+ size_t size));
+
+#if defined(ANDROID) || defined(__ANDROID__)
+CARES_EXTERN void ares_library_init_jvm(JavaVM *jvm);
+CARES_EXTERN int ares_library_init_android(jobject connectivity_manager);
+CARES_EXTERN int ares_library_android_initialized(void);
+#endif
+
+CARES_EXTERN int ares_library_initialized(void);
+
+CARES_EXTERN void ares_library_cleanup(void);
+
+CARES_EXTERN const char *ares_version(int *version);
+
+CARES_EXTERN int ares_init(ares_channel_t **channelptr);
+
+CARES_EXTERN int ares_init_options(ares_channel_t **channelptr,
+ const struct ares_options *options,
+ int optmask);
+
+CARES_EXTERN int ares_save_options(ares_channel_t *channel,
+ struct ares_options *options, int *optmask);
+
+CARES_EXTERN void ares_destroy_options(struct ares_options *options);
+
+CARES_EXTERN int ares_dup(ares_channel_t **dest, ares_channel_t *src);
+
+CARES_EXTERN ares_status_t ares_reinit(ares_channel_t *channel);
+
+CARES_EXTERN void ares_destroy(ares_channel_t *channel);
+
+CARES_EXTERN void ares_cancel(ares_channel_t *channel);
+
+/* These next 3 configure local binding for the out-going socket
+ * connection. Use these to specify source IP and/or network device
+ * on multi-homed systems.
+ */
+CARES_EXTERN void ares_set_local_ip4(ares_channel_t *channel,
+ unsigned int local_ip);
+
+/* local_ip6 should be 16 bytes in length */
+CARES_EXTERN void ares_set_local_ip6(ares_channel_t *channel,
+ const unsigned char *local_ip6);
+
+/* local_dev_name should be null terminated. */
+CARES_EXTERN void ares_set_local_dev(ares_channel_t *channel,
+ const char *local_dev_name);
+
+CARES_EXTERN void ares_set_socket_callback(ares_channel_t *channel,
+ ares_sock_create_callback callback,
+ void *user_data);
+
+CARES_EXTERN void ares_set_socket_configure_callback(
+ ares_channel_t *channel, ares_sock_config_callback callback, void *user_data);
+
+CARES_EXTERN int ares_set_sortlist(ares_channel_t *channel,
+ const char *sortstr);
+
+CARES_EXTERN void ares_getaddrinfo(ares_channel_t *channel, const char *node,
+ const char *service,
+ const struct ares_addrinfo_hints *hints,
+ ares_addrinfo_callback callback, void *arg);
+
+CARES_EXTERN void ares_freeaddrinfo(struct ares_addrinfo *ai);
+
+/*
+ * Virtual function set to have user-managed socket IO.
+ * Note that all functions need to be defined, and when
+ * set, the library will not do any bind nor set any
+ * socket options, assuming the client handles these
+ * through either socket creation or the
+ * ares_sock_config_callback call.
+ */
+struct iovec;
+
+struct ares_socket_functions {
+ ares_socket_t (*asocket)(int, int, int, void *);
+ int (*aclose)(ares_socket_t, void *);
+ int (*aconnect)(ares_socket_t, const struct sockaddr *, ares_socklen_t,
+ void *);
+ ares_ssize_t (*arecvfrom)(ares_socket_t, void *, size_t, int,
+ struct sockaddr *, ares_socklen_t *, void *);
+ ares_ssize_t (*asendv)(ares_socket_t, const struct iovec *, int, void *);
+};
+
+CARES_EXTERN void
+ ares_set_socket_functions(ares_channel_t *channel,
+ const struct ares_socket_functions *funcs,
+ void *user_data);
+
+CARES_EXTERN void ares_send(ares_channel_t *channel, const unsigned char *qbuf,
+ int qlen, ares_callback callback, void *arg);
+
+CARES_EXTERN void ares_query(ares_channel_t *channel, const char *name,
+ int dnsclass, int type, ares_callback callback,
+ void *arg);
+
+CARES_EXTERN void ares_search(ares_channel_t *channel, const char *name,
+ int dnsclass, int type, ares_callback callback,
+ void *arg);
+
+CARES_EXTERN void ares_gethostbyname(ares_channel_t *channel, const char *name,
+ int family, ares_host_callback callback,
+ void *arg);
+
+CARES_EXTERN int ares_gethostbyname_file(ares_channel_t *channel,
+ const char *name, int family,
+ struct hostent **host);
+
+CARES_EXTERN void ares_gethostbyaddr(ares_channel_t *channel, const void *addr,
+ int addrlen, int family,
+ ares_host_callback callback, void *arg);
+
+CARES_EXTERN void ares_getnameinfo(ares_channel_t *channel,
+ const struct sockaddr *sa,
+ ares_socklen_t salen, int flags,
+ ares_nameinfo_callback callback, void *arg);
+
+CARES_EXTERN int ares_fds(ares_channel_t *channel, fd_set *read_fds,
+ fd_set *write_fds);
+
+CARES_EXTERN int ares_getsock(ares_channel_t *channel, ares_socket_t *socks,
+ int numsocks);
+
+CARES_EXTERN struct timeval *ares_timeout(ares_channel_t *channel,
+ struct timeval *maxtv,
+ struct timeval *tv);
+
+CARES_EXTERN void ares_process(ares_channel_t *channel, fd_set *read_fds,
+ fd_set *write_fds);
+
+CARES_EXTERN void ares_process_fd(ares_channel_t *channel,
+ ares_socket_t read_fd,
+ ares_socket_t write_fd);
+
+CARES_EXTERN int ares_create_query(const char *name, int dnsclass, int type,
+ unsigned short id, int rd,
+ unsigned char **buf, int *buflen,
+ int max_udp_size);
+
+CARES_EXTERN int ares_mkquery(const char *name, int dnsclass, int type,
+ unsigned short id, int rd, unsigned char **buf,
+ int *buflen);
+
+CARES_EXTERN int ares_expand_name(const unsigned char *encoded,
+ const unsigned char *abuf, int alen, char **s,
+ long *enclen);
+
+CARES_EXTERN int ares_expand_string(const unsigned char *encoded,
+ const unsigned char *abuf, int alen,
+ unsigned char **s, long *enclen);
+
+/*
+ * NOTE: before c-ares 1.7.0 we would most often use the system in6_addr
+ * struct below when ares itself was built, but many apps would use this
+ * private version since the header checked a HAVE_* define for it. Starting
+ * with 1.7.0 we always declare and use our own to stop relying on the
+ * system's one.
+ */
+struct ares_in6_addr {
+ union {
+ unsigned char _S6_u8[16];
+ } _S6_un;
+};
+
+struct ares_addr {
+ int family;
+
+ union {
+ struct in_addr addr4;
+ struct ares_in6_addr addr6;
+ } addr;
+};
+
+struct ares_addrttl {
+ struct in_addr ipaddr;
+ int ttl;
+};
+
+struct ares_addr6ttl {
+ struct ares_in6_addr ip6addr;
+ int ttl;
+};
+
+struct ares_caa_reply {
+ struct ares_caa_reply *next;
+ int critical;
+ unsigned char *property;
+ size_t plength; /* plength excludes null termination */
+ unsigned char *value;
+ size_t length; /* length excludes null termination */
+};
+
+struct ares_srv_reply {
+ struct ares_srv_reply *next;
+ char *host;
+ unsigned short priority;
+ unsigned short weight;
+ unsigned short port;
+};
+
+struct ares_mx_reply {
+ struct ares_mx_reply *next;
+ char *host;
+ unsigned short priority;
+};
+
+struct ares_txt_reply {
+ struct ares_txt_reply *next;
+ unsigned char *txt;
+ size_t length; /* length excludes null termination */
+};
+
+/* NOTE: This structure is a superset of ares_txt_reply
+ */
+struct ares_txt_ext {
+ struct ares_txt_ext *next;
+ unsigned char *txt;
+ size_t length;
+ /* 1 - if start of new record
+ * 0 - if a chunk in the same record */
+ unsigned char record_start;
+};
+
+struct ares_naptr_reply {
+ struct ares_naptr_reply *next;
+ unsigned char *flags;
+ unsigned char *service;
+ unsigned char *regexp;
+ char *replacement;
+ unsigned short order;
+ unsigned short preference;
+};
+
+struct ares_soa_reply {
+ char *nsname;
+ char *hostmaster;
+ unsigned int serial;
+ unsigned int refresh;
+ unsigned int retry;
+ unsigned int expire;
+ unsigned int minttl;
+};
+
+struct ares_uri_reply {
+ struct ares_uri_reply *next;
+ unsigned short priority;
+ unsigned short weight;
+ char *uri;
+ int ttl;
+};
+
+/*
+ * Similar to addrinfo, but with extra ttl and missing canonname.
+ */
+struct ares_addrinfo_node {
+ int ai_ttl;
+ int ai_flags;
+ int ai_family;
+ int ai_socktype;
+ int ai_protocol;
+ ares_socklen_t ai_addrlen;
+ struct sockaddr *ai_addr;
+ struct ares_addrinfo_node *ai_next;
+};
+
+/*
+ * alias - label of the resource record.
+ * name - value (canonical name) of the resource record.
+ * See RFC2181 10.1.1. CNAME terminology.
+ */
+struct ares_addrinfo_cname {
+ int ttl;
+ char *alias;
+ char *name;
+ struct ares_addrinfo_cname *next;
+};
+
+struct ares_addrinfo {
+ struct ares_addrinfo_cname *cnames;
+ struct ares_addrinfo_node *nodes;
+ char *name;
+};
+
+struct ares_addrinfo_hints {
+ int ai_flags;
+ int ai_family;
+ int ai_socktype;
+ int ai_protocol;
+};
+
+/*
+** Parse the buffer, starting at *abuf and of length alen bytes, previously
+** obtained from an ares_search call. Put the results in *host, if nonnull.
+** Also, if addrttls is nonnull, put up to *naddrttls IPv4 addresses along with
+** their TTLs in that array, and set *naddrttls to the number of addresses
+** so written.
+*/
+
+CARES_EXTERN int ares_parse_a_reply(const unsigned char *abuf, int alen,
+ struct hostent **host,
+ struct ares_addrttl *addrttls,
+ int *naddrttls);
+
+CARES_EXTERN int ares_parse_aaaa_reply(const unsigned char *abuf, int alen,
+ struct hostent **host,
+ struct ares_addr6ttl *addrttls,
+ int *naddrttls);
+
+CARES_EXTERN int ares_parse_caa_reply(const unsigned char *abuf, int alen,
+ struct ares_caa_reply **caa_out);
+
+CARES_EXTERN int ares_parse_ptr_reply(const unsigned char *abuf, int alen,
+ const void *addr, int addrlen, int family,
+ struct hostent **host);
+
+CARES_EXTERN int ares_parse_ns_reply(const unsigned char *abuf, int alen,
+ struct hostent **host);
+
+CARES_EXTERN int ares_parse_srv_reply(const unsigned char *abuf, int alen,
+ struct ares_srv_reply **srv_out);
+
+CARES_EXTERN int ares_parse_mx_reply(const unsigned char *abuf, int alen,
+ struct ares_mx_reply **mx_out);
+
+CARES_EXTERN int ares_parse_txt_reply(const unsigned char *abuf, int alen,
+ struct ares_txt_reply **txt_out);
+
+CARES_EXTERN int ares_parse_txt_reply_ext(const unsigned char *abuf, int alen,
+ struct ares_txt_ext **txt_out);
+
+CARES_EXTERN int ares_parse_naptr_reply(const unsigned char *abuf, int alen,
+ struct ares_naptr_reply **naptr_out);
+
+CARES_EXTERN int ares_parse_soa_reply(const unsigned char *abuf, int alen,
+ struct ares_soa_reply **soa_out);
+
+CARES_EXTERN int ares_parse_uri_reply(const unsigned char *abuf, int alen,
+ struct ares_uri_reply **uri_out);
+
+CARES_EXTERN void ares_free_string(void *str);
+
+CARES_EXTERN void ares_free_hostent(struct hostent *host);
+
+CARES_EXTERN void ares_free_data(void *dataptr);
+
+CARES_EXTERN const char *ares_strerror(int code);
+
+struct ares_addr_node {
+ struct ares_addr_node *next;
+ int family;
+
+ union {
+ struct in_addr addr4;
+ struct ares_in6_addr addr6;
+ } addr;
+};
+
+struct ares_addr_port_node {
+ struct ares_addr_port_node *next;
+ int family;
+
+ union {
+ struct in_addr addr4;
+ struct ares_in6_addr addr6;
+ } addr;
+
+ int udp_port;
+ int tcp_port;
+};
+
+CARES_EXTERN int ares_set_servers(ares_channel_t *channel,
+ const struct ares_addr_node *servers);
+CARES_EXTERN int
+ ares_set_servers_ports(ares_channel_t *channel,
+ const struct ares_addr_port_node *servers);
+
+/* Incoming string format: host[:port][,host[:port]]... */
+CARES_EXTERN int ares_set_servers_csv(ares_channel_t *channel,
+ const char *servers);
+CARES_EXTERN int ares_set_servers_ports_csv(ares_channel_t *channel,
+ const char *servers);
+CARES_EXTERN char *ares_get_servers_csv(ares_channel_t *channel);
+
+CARES_EXTERN int ares_get_servers(ares_channel_t *channel,
+ struct ares_addr_node **servers);
+CARES_EXTERN int ares_get_servers_ports(ares_channel_t *channel,
+ struct ares_addr_port_node **servers);
+
+CARES_EXTERN const char *ares_inet_ntop(int af, const void *src, char *dst,
+ ares_socklen_t size);
+
+CARES_EXTERN int ares_inet_pton(int af, const char *src, void *dst);
+
+/*! Whether or not the c-ares library was built with threadsafety
+ *
+ * \return ARES_TRUE if built with threadsafety, ARES_FALSE if not
+ */
+CARES_EXTERN ares_bool_t ares_threadsafety(void);
+
+#ifdef __cplusplus
+}
+#endif
+
+/* DNS record parser, writer, and helpers */
+#include "ares_dns_record.h"
+
+#endif /* ARES__H */
diff --git a/subprojects/c-ares/include/ares_build.h.cmake b/subprojects/c-ares/include/ares_build.h.cmake
@@ -0,0 +1,52 @@
+#ifndef __CARES_BUILD_H
+#define __CARES_BUILD_H
+/*
+ * Copyright (C) The c-ares project and its contributors
+ * SPDX-License-Identifier: MIT
+ */
+
+#define CARES_TYPEOF_ARES_SOCKLEN_T @CARES_TYPEOF_ARES_SOCKLEN_T@
+#define CARES_TYPEOF_ARES_SSIZE_T @CARES_TYPEOF_ARES_SSIZE_T@
+
+/* Prefix names with CARES_ to make sure they don't conflict with other config.h
+ * files. We need to include some dependent headers that may be system specific
+ * for C-Ares */
+#cmakedefine CARES_HAVE_SYS_TYPES_H
+#cmakedefine CARES_HAVE_SYS_RANDOM_H
+#cmakedefine CARES_HAVE_SYS_SOCKET_H
+#cmakedefine CARES_HAVE_WINDOWS_H
+#cmakedefine CARES_HAVE_WS2TCPIP_H
+#cmakedefine CARES_HAVE_WINSOCK2_H
+#cmakedefine CARES_HAVE_WINDOWS_H
+#cmakedefine CARES_HAVE_ARPA_NAMESER_H
+#cmakedefine CARES_HAVE_ARPA_NAMESER_COMPAT_H
+
+#ifdef CARES_HAVE_SYS_TYPES_H
+# include <sys/types.h>
+#endif
+
+#ifdef CARES_HAVE_SYS_RANDOM_H
+# include <sys/random.h>
+#endif
+
+#ifdef CARES_HAVE_SYS_SOCKET_H
+# include <sys/socket.h>
+#endif
+
+#ifdef CARES_HAVE_WINSOCK2_H
+# include <winsock2.h>
+#endif
+
+#ifdef CARES_HAVE_WS2TCPIP_H
+# include <ws2tcpip.h>
+#endif
+
+#ifdef CARES_HAVE_WINDOWS_H
+# include <windows.h>
+#endif
+
+
+typedef CARES_TYPEOF_ARES_SOCKLEN_T ares_socklen_t;
+typedef CARES_TYPEOF_ARES_SSIZE_T ares_ssize_t;
+
+#endif /* __CARES_BUILD_H */
diff --git a/subprojects/c-ares/include/ares_build.h.dist b/subprojects/c-ares/include/ares_build.h.dist
@@ -0,0 +1,219 @@
+/* MIT License
+ *
+ * Copyright (c) 2009 Daniel Stenberg
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice (including the next
+ * paragraph) shall be included in all copies or substantial portions of the
+ * Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ *
+ * SPDX-License-Identifier: MIT
+ */
+#ifndef __CARES_BUILD_H
+#define __CARES_BUILD_H
+
+
+/* ================================================================ */
+/* NOTES FOR CONFIGURE CAPABLE SYSTEMS */
+/* ================================================================ */
+
+/*
+ * NOTE 1:
+ * -------
+ *
+ * See file ares_build.h.in, run configure, and forget that this file
+ * exists it is only used for non-configure systems.
+ * But you can keep reading if you want ;-)
+ *
+ */
+
+/* ================================================================ */
+/* NOTES FOR NON-CONFIGURE SYSTEMS */
+/* ================================================================ */
+
+/*
+ * NOTE 1:
+ * -------
+ *
+ * Nothing in this file is intended to be modified or adjusted by the
+ * c-ares library user nor by the c-ares library builder.
+ *
+ * If you think that something actually needs to be changed, adjusted
+ * or fixed in this file, then, report it on the c-ares development
+ * mailing list: http://lists.haxx.se/listinfo/c-ares/
+ *
+ * Try to keep one section per platform, compiler and architecture,
+ * otherwise, if an existing section is reused for a different one and
+ * later on the original is adjusted, probably the piggybacking one can
+ * be adversely changed.
+ *
+ * In order to differentiate between platforms/compilers/architectures
+ * use only compiler built in predefined preprocessor symbols.
+ *
+ * This header file shall only export symbols which are 'cares' or 'CARES'
+ * prefixed, otherwise public name space would be polluted.
+ *
+ * NOTE 2:
+ * -------
+ *
+ * Right now you might be staring at file ares_build.h.dist or ares_build.h,
+ * this is due to the following reason: file ares_build.h.dist is renamed
+ * to ares_build.h when the c-ares source code distribution archive file is
+ * created.
+ *
+ * File ares_build.h.dist is not included in the distribution archive.
+ * File ares_build.h is not present in the git tree.
+ *
+ * The distributed ares_build.h file is only intended to be used on systems
+ * which can not run the also distributed configure script.
+ *
+ * On systems capable of running the configure script, the configure process
+ * will overwrite the distributed ares_build.h file with one that is suitable
+ * and specific to the library being configured and built, which is generated
+ * from the ares_build.h.in template file.
+ *
+ * If you check out from git on a non-configure platform, you must run the
+ * appropriate buildconf* script to set up ares_build.h and other local files.
+ *
+ */
+
+/* ================================================================ */
+/* DEFINITION OF THESE SYMBOLS SHALL NOT TAKE PLACE ANYWHERE ELSE */
+/* ================================================================ */
+
+#ifdef CARES_TYPEOF_ARES_SOCKLEN_T
+# error "CARES_TYPEOF_ARES_SOCKLEN_T shall not be defined except in ares_build.h"
+ Error Compilation_aborted_CARES_TYPEOF_ARES_SOCKLEN_T_already_defined
+#endif
+
+/* ================================================================ */
+/* EXTERNAL INTERFACE SETTINGS FOR NON-CONFIGURE SYSTEMS ONLY */
+/* ================================================================ */
+
+#if defined(__DJGPP__) || defined(__GO32__)
+# define CARES_TYPEOF_ARES_SOCKLEN_T int
+
+#elif defined(__SALFORDC__)
+# define CARES_TYPEOF_ARES_SOCKLEN_T int
+
+#elif defined(__BORLANDC__)
+# define CARES_TYPEOF_ARES_SOCKLEN_T int
+
+#elif defined(__TURBOC__)
+# define CARES_TYPEOF_ARES_SOCKLEN_T int
+
+#elif defined(__WATCOMC__)
+# define CARES_TYPEOF_ARES_SOCKLEN_T int
+
+#elif defined(__POCC__)
+# define CARES_TYPEOF_ARES_SOCKLEN_T int
+
+#elif defined(__LCC__)
+# define CARES_TYPEOF_ARES_SOCKLEN_T int
+
+#elif defined(__SYMBIAN32__)
+# define CARES_TYPEOF_ARES_SOCKLEN_T unsigned int
+
+#elif defined(__MWERKS__)
+# define CARES_TYPEOF_ARES_SOCKLEN_T int
+
+#elif defined(_WIN32_WCE)
+# define CARES_TYPEOF_ARES_SOCKLEN_T int
+
+#elif defined(__MINGW32__)
+# define CARES_TYPEOF_ARES_SOCKLEN_T int
+
+#elif defined(__VMS)
+# define CARES_TYPEOF_ARES_SOCKLEN_T unsigned int
+
+#elif defined(__OS400__)
+# if defined(__ILEC400__)
+# define CARES_TYPEOF_ARES_SOCKLEN_T socklen_t
+# define CARES_PULL_SYS_TYPES_H 1
+# define CARES_PULL_SYS_SOCKET_H 1
+# endif
+
+#elif defined(__MVS__)
+# if defined(__IBMC__) || defined(__IBMCPP__)
+# define CARES_TYPEOF_ARES_SOCKLEN_T socklen_t
+# define CARES_PULL_SYS_TYPES_H 1
+# define CARES_PULL_SYS_SOCKET_H 1
+# endif
+
+#elif defined(__370__)
+# if defined(__IBMC__) || defined(__IBMCPP__)
+# define CARES_TYPEOF_ARES_SOCKLEN_T socklen_t
+# define CARES_PULL_SYS_TYPES_H 1
+# define CARES_PULL_SYS_SOCKET_H 1
+# endif
+
+#elif defined(TPF)
+# define CARES_TYPEOF_ARES_SOCKLEN_T int
+
+/* ===================================== */
+/* KEEP MSVC THE PENULTIMATE ENTRY */
+/* ===================================== */
+
+#elif defined(_MSC_VER)
+# define CARES_TYPEOF_ARES_SOCKLEN_T int
+
+/* ===================================== */
+/* KEEP GENERIC GCC THE LAST ENTRY */
+/* ===================================== */
+
+#elif defined(__GNUC__)
+# define CARES_TYPEOF_ARES_SOCKLEN_T socklen_t
+# define CARES_PULL_SYS_TYPES_H 1
+# define CARES_PULL_SYS_SOCKET_H 1
+
+#else
+# error "Unknown non-configure build target!"
+ Error Compilation_aborted_Unknown_non_configure_build_target
+#endif
+
+/* CARES_PULL_SYS_TYPES_H is defined above when inclusion of header file */
+/* sys/types.h is required here to properly make type definitions below. */
+#ifdef CARES_PULL_SYS_TYPES_H
+# include <sys/types.h>
+#endif
+
+/* CARES_PULL_SYS_SOCKET_H is defined above when inclusion of header file */
+/* sys/socket.h is required here to properly make type definitions below. */
+#ifdef CARES_PULL_SYS_SOCKET_H
+# include <sys/socket.h>
+#endif
+
+/* Data type definition of ares_socklen_t. */
+
+#ifdef CARES_TYPEOF_ARES_SOCKLEN_T
+ typedef CARES_TYPEOF_ARES_SOCKLEN_T ares_socklen_t;
+#endif
+
+/* Data type definition of ares_ssize_t. */
+#ifdef _WIN32
+# ifdef _WIN64
+# define CARES_TYPEOF_ARES_SSIZE_T __int64
+# else
+# define CARES_TYPEOF_ARES_SSIZE_T long
+# endif
+#else
+# define CARES_TYPEOF_ARES_SSIZE_T ssize_t
+#endif
+
+typedef CARES_TYPEOF_ARES_SSIZE_T ares_ssize_t;
+
+#endif /* __CARES_BUILD_H */
diff --git a/subprojects/c-ares/include/ares_build.h.in b/subprojects/c-ares/include/ares_build.h.in
@@ -0,0 +1,52 @@
+#ifndef __CARES_BUILD_H
+#define __CARES_BUILD_H
+/*
+ * Copyright (C) The c-ares project and its contributors
+ * SPDX-License-Identifier: MIT
+ */
+
+#define CARES_TYPEOF_ARES_SOCKLEN_T @CARES_TYPEOF_ARES_SOCKLEN_T@
+#define CARES_TYPEOF_ARES_SSIZE_T @CARES_TYPEOF_ARES_SSIZE_T@
+
+/* Prefix names with CARES_ to make sure they don't conflict with other config.h
+ * files. We need to include some dependent headers that may be system specific
+ * for C-Ares */
+#undef CARES_HAVE_SYS_TYPES_H
+#undef CARES_HAVE_SYS_RANDOM_H
+#undef CARES_HAVE_SYS_SOCKET_H
+#undef CARES_HAVE_WINDOWS_H
+#undef CARES_HAVE_WS2TCPIP_H
+#undef CARES_HAVE_WINSOCK2_H
+#undef CARES_HAVE_WINDOWS_H
+#undef CARES_HAVE_ARPA_NAMESER_H
+#undef CARES_HAVE_ARPA_NAMESER_COMPAT_H
+
+#ifdef CARES_HAVE_SYS_TYPES_H
+# include <sys/types.h>
+#endif
+
+#ifdef CARES_HAVE_SYS_RANDOM_H
+# include <sys/random.h>
+#endif
+
+#ifdef CARES_HAVE_SYS_SOCKET_H
+# include <sys/socket.h>
+#endif
+
+#ifdef CARES_HAVE_WINSOCK2_H
+# include <winsock2.h>
+#endif
+
+#ifdef CARES_HAVE_WS2TCPIP_H
+# include <ws2tcpip.h>
+#endif
+
+#ifdef CARES_HAVE_WINDOWS_H
+# include <windows.h>
+#endif
+
+
+typedef CARES_TYPEOF_ARES_SOCKLEN_T ares_socklen_t;
+typedef CARES_TYPEOF_ARES_SSIZE_T ares_ssize_t;
+
+#endif /* __CARES_BUILD_H */
diff --git a/subprojects/c-ares/include/ares_dns.h b/subprojects/c-ares/include/ares_dns.h
@@ -0,0 +1,127 @@
+/* MIT License
+ *
+ * Copyright (c) Massachusetts Institute of Technology
+ * Copyright (c) The c-ares project and its contributors
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice (including the next
+ * paragraph) shall be included in all copies or substantial portions of the
+ * Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ *
+ * SPDX-License-Identifier: MIT
+ */
+#ifndef HEADER_CARES_DNS_H
+#define HEADER_CARES_DNS_H
+
+/*
+ * NOTE TO INTEGRATORS:
+ *
+ * This header is made public due to legacy projects relying on it.
+ * Please do not use the macros within this header, or include this
+ * header in your project as it may be removed in the future.
+ */
+
+
+/*
+ * Macro DNS__16BIT reads a network short (16 bit) given in network
+ * byte order, and returns its value as an unsigned short.
+ */
+#define DNS__16BIT(p) \
+ ((unsigned short)((unsigned int)0xffff & \
+ (((unsigned int)((unsigned char)(p)[0]) << 8U) | \
+ ((unsigned int)((unsigned char)(p)[1])))))
+
+/*
+ * Macro DNS__32BIT reads a network long (32 bit) given in network
+ * byte order, and returns its value as an unsigned int.
+ */
+#define DNS__32BIT(p) \
+ ((unsigned int)(((unsigned int)((unsigned char)(p)[0]) << 24U) | \
+ ((unsigned int)((unsigned char)(p)[1]) << 16U) | \
+ ((unsigned int)((unsigned char)(p)[2]) << 8U) | \
+ ((unsigned int)((unsigned char)(p)[3]))))
+
+#define DNS__SET16BIT(p, v) \
+ (((p)[0] = (unsigned char)(((v) >> 8) & 0xff)), \
+ ((p)[1] = (unsigned char)((v) & 0xff)))
+#define DNS__SET32BIT(p, v) \
+ (((p)[0] = (unsigned char)(((v) >> 24) & 0xff)), \
+ ((p)[1] = (unsigned char)(((v) >> 16) & 0xff)), \
+ ((p)[2] = (unsigned char)(((v) >> 8) & 0xff)), \
+ ((p)[3] = (unsigned char)((v) & 0xff)))
+
+#if 0
+/* we cannot use this approach on systems where we can't access 16/32 bit
+ data on un-aligned addresses */
+# define DNS__16BIT(p) ntohs(*(unsigned short *)(p))
+# define DNS__32BIT(p) ntohl(*(unsigned long *)(p))
+# define DNS__SET16BIT(p, v) *(unsigned short *)(p) = htons(v)
+# define DNS__SET32BIT(p, v) *(unsigned long *)(p) = htonl(v)
+#endif
+
+/* Macros for parsing a DNS header */
+#define DNS_HEADER_QID(h) DNS__16BIT(h)
+#define DNS_HEADER_QR(h) (((h)[2] >> 7) & 0x1)
+#define DNS_HEADER_OPCODE(h) (((h)[2] >> 3) & 0xf)
+#define DNS_HEADER_AA(h) (((h)[2] >> 2) & 0x1)
+#define DNS_HEADER_TC(h) (((h)[2] >> 1) & 0x1)
+#define DNS_HEADER_RD(h) ((h)[2] & 0x1)
+#define DNS_HEADER_RA(h) (((h)[3] >> 7) & 0x1)
+#define DNS_HEADER_Z(h) (((h)[3] >> 4) & 0x7)
+#define DNS_HEADER_RCODE(h) ((h)[3] & 0xf)
+#define DNS_HEADER_QDCOUNT(h) DNS__16BIT((h) + 4)
+#define DNS_HEADER_ANCOUNT(h) DNS__16BIT((h) + 6)
+#define DNS_HEADER_NSCOUNT(h) DNS__16BIT((h) + 8)
+#define DNS_HEADER_ARCOUNT(h) DNS__16BIT((h) + 10)
+
+/* Macros for constructing a DNS header */
+#define DNS_HEADER_SET_QID(h, v) DNS__SET16BIT(h, v)
+#define DNS_HEADER_SET_QR(h, v) ((h)[2] |= (unsigned char)(((v) & 0x1) << 7))
+#define DNS_HEADER_SET_OPCODE(h, v) \
+ ((h)[2] |= (unsigned char)(((v) & 0xf) << 3))
+#define DNS_HEADER_SET_AA(h, v) ((h)[2] |= (unsigned char)(((v) & 0x1) << 2))
+#define DNS_HEADER_SET_TC(h, v) ((h)[2] |= (unsigned char)(((v) & 0x1) << 1))
+#define DNS_HEADER_SET_RD(h, v) ((h)[2] |= (unsigned char)((v) & 0x1))
+#define DNS_HEADER_SET_RA(h, v) ((h)[3] |= (unsigned char)(((v) & 0x1) << 7))
+#define DNS_HEADER_SET_Z(h, v) ((h)[3] |= (unsigned char)(((v) & 0x7) << 4))
+#define DNS_HEADER_SET_RCODE(h, v) ((h)[3] |= (unsigned char)((v) & 0xf))
+#define DNS_HEADER_SET_QDCOUNT(h, v) DNS__SET16BIT((h) + 4, v)
+#define DNS_HEADER_SET_ANCOUNT(h, v) DNS__SET16BIT((h) + 6, v)
+#define DNS_HEADER_SET_NSCOUNT(h, v) DNS__SET16BIT((h) + 8, v)
+#define DNS_HEADER_SET_ARCOUNT(h, v) DNS__SET16BIT((h) + 10, v)
+
+/* Macros for parsing the fixed part of a DNS question */
+#define DNS_QUESTION_TYPE(q) DNS__16BIT(q)
+#define DNS_QUESTION_CLASS(q) DNS__16BIT((q) + 2)
+
+/* Macros for constructing the fixed part of a DNS question */
+#define DNS_QUESTION_SET_TYPE(q, v) DNS__SET16BIT(q, v)
+#define DNS_QUESTION_SET_CLASS(q, v) DNS__SET16BIT((q) + 2, v)
+
+/* Macros for parsing the fixed part of a DNS resource record */
+#define DNS_RR_TYPE(r) DNS__16BIT(r)
+#define DNS_RR_CLASS(r) DNS__16BIT((r) + 2)
+#define DNS_RR_TTL(r) DNS__32BIT((r) + 4)
+#define DNS_RR_LEN(r) DNS__16BIT((r) + 8)
+
+/* Macros for constructing the fixed part of a DNS resource record */
+#define DNS_RR_SET_TYPE(r, v) DNS__SET16BIT(r, v)
+#define DNS_RR_SET_CLASS(r, v) DNS__SET16BIT((r) + 2, v)
+#define DNS_RR_SET_TTL(r, v) DNS__SET32BIT((r) + 4, v)
+#define DNS_RR_SET_LEN(r, v) DNS__SET16BIT((r) + 8, v)
+
+#endif /* HEADER_CARES_DNS_H */
diff --git a/subprojects/c-ares/include/ares_dns_record.h b/subprojects/c-ares/include/ares_dns_record.h
@@ -0,0 +1,954 @@
+/* MIT License
+ *
+ * Copyright (c) 2023 Brad House
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice (including the next
+ * paragraph) shall be included in all copies or substantial portions of the
+ * Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ *
+ * SPDX-License-Identifier: MIT
+ */
+#ifndef __ARES_DNS_RECORD_H
+#define __ARES_DNS_RECORD_H
+
+/* Include ares.h, not this file directly */
+
+#ifdef __cplusplus
+extern "C" {
+#endif
+
+/*! \addtogroup ares_dns_record DNS Record Handling
+ *
+ * This is a set of functions to create and manipulate DNS records.
+ *
+ * @{
+ */
+
+/*! DNS Record types handled by c-ares. Some record types may only be valid
+ * on requests (e.g. ARES_REC_TYPE_ANY), and some may only be valid on
+ * responses */
+typedef enum {
+ ARES_REC_TYPE_A = 1, /*!< Host address. */
+ ARES_REC_TYPE_NS = 2, /*!< Authoritative server. */
+ ARES_REC_TYPE_CNAME = 5, /*!< Canonical name. */
+ ARES_REC_TYPE_SOA = 6, /*!< Start of authority zone. */
+ ARES_REC_TYPE_PTR = 12, /*!< Domain name pointer. */
+ ARES_REC_TYPE_HINFO = 13, /*!< Host information. */
+ ARES_REC_TYPE_MX = 15, /*!< Mail routing information. */
+ ARES_REC_TYPE_TXT = 16, /*!< Text strings. */
+ ARES_REC_TYPE_AAAA = 28, /*!< RFC 3596. Ip6 Address. */
+ ARES_REC_TYPE_SRV = 33, /*!< RFC 2782. Server Selection. */
+ ARES_REC_TYPE_NAPTR = 35, /*!< RFC 3403. Naming Authority Pointer */
+ ARES_REC_TYPE_OPT = 41, /*!< RFC 6891. EDNS0 option (meta-RR) */
+
+ ARES_REC_TYPE_TLSA = 52, /*!< RFC 6698. DNS-Based Authentication of Named
+ * Entities (DANE) Transport Layer Security
+ * (TLS) Protocol: TLSA */
+ ARES_REC_TYPE_SVCB = 64, /*!< RFC 9460. General Purpose Service Binding */
+ ARES_REC_TYPE_HTTPS = 65, /*!< RFC 9460. Service Binding type for use with
+ * HTTPS */
+ ARES_REC_TYPE_ANY = 255, /*!< Wildcard match. Not response RR. */
+ ARES_REC_TYPE_URI = 256, /*!< RFC 7553. Uniform Resource Identifier */
+ ARES_REC_TYPE_CAA = 257, /*!< RFC 6844. Certification Authority
+ * Authorization. */
+ ARES_REC_TYPE_RAW_RR = 65536 /*!< Used as an indicator that the RR record
+ * is not parsed, but provided in wire
+ * format */
+} ares_dns_rec_type_t;
+
+/*! DNS Classes for requests and responses. */
+typedef enum {
+ ARES_CLASS_IN = 1, /*!< Internet */
+ ARES_CLASS_CHAOS = 3, /*!< CHAOS */
+ ARES_CLASS_HESOID = 4, /*!< Hesoid [Dyer 87] */
+ ARES_CLASS_NONE = 254, /*!< RFC 2136 */
+ ARES_CLASS_ANY = 255 /*!< Any class (requests only) */
+} ares_dns_class_t;
+
+/*! DNS RR Section type */
+typedef enum {
+ ARES_SECTION_ANSWER = 1, /*!< Answer section */
+ ARES_SECTION_AUTHORITY = 2, /*!< Authority section */
+ ARES_SECTION_ADDITIONAL = 3 /*!< Additional information section */
+} ares_dns_section_t;
+
+/*! DNS Header opcodes */
+typedef enum {
+ ARES_OPCODE_QUERY = 0, /*!< Standard query */
+ ARES_OPCODE_IQUERY = 1, /*!< Inverse query. Obsolete. */
+ ARES_OPCODE_STATUS = 2, /*!< Name server status query */
+ ARES_OPCODE_NOTIFY = 4, /*!< Zone change notification (RFC 1996) */
+ ARES_OPCODE_UPDATE = 5, /*!< Zone update message (RFC2136) */
+} ares_dns_opcode_t;
+
+/*! DNS Header flags */
+typedef enum {
+ ARES_FLAG_QR = 1 << 0, /*!< QR. If set, is a response */
+ ARES_FLAG_AA = 1 << 1, /*!< Authoritative Answer. If set, is authoritative */
+ ARES_FLAG_TC = 1 << 2, /*!< Truncation. If set, is truncated response */
+ ARES_FLAG_RD = 1 << 3, /*!< Recursion Desired. If set, recursion is desired */
+ ARES_FLAG_RA = 1 << 4, /*!< Recursion Available. If set, server supports
+ * recursion */
+ ARES_FLAG_AD = 1 << 5, /*!< RFC 2065. Authentic Data bit indicates in a
+ * response that the data included has been verified by
+ * the server providing it */
+ ARES_FLAG_CD = 1 << 6, /*!< RFC 2065. Checking Disabled bit indicates in a
+ * query that non-verified data is acceptable to the
+ * resolver sending the query. */
+} ares_dns_flags_t;
+
+/*! DNS Response Codes from server */
+typedef enum {
+ ARES_RCODE_NOERROR = 0, /*!< Success */
+ ARES_RCODE_FORMERR = 1, /*!< Format error. The name server was unable
+ * to interpret the query. */
+ ARES_RCODE_SERVFAIL = 2, /*!< Server Failure. The name server was
+ * unable to process this query due to a
+ * problem with the nameserver */
+ ARES_RCODE_NXDOMAIN = 3, /*!< Name Error. Meaningful only for
+ * responses from an authoritative name
+ * server, this code signifies that the
+ * domain name referenced in the query does
+ * not exist. */
+ ARES_RCODE_NOTIMP = 4, /*!< Not implemented. The name server does
+ * not support the requested kind of
+ * query */
+ ARES_RCODE_REFUSED = 5, /*!< Refused. The name server refuses to
+ * perform the specified operation for
+ * policy reasons. */
+ ARES_RCODE_YXDOMAIN = 6, /*!< RFC 2136. Some name that ought not to
+ * exist, does exist. */
+ ARES_RCODE_YXRRSET = 7, /*!< RFC 2136. Some RRset that ought to not
+ * exist, does exist. */
+ ARES_RCODE_NXRRSET = 8, /*!< RFC 2136. Some RRset that ought to exist,
+ * does not exist. */
+ ARES_RCODE_NOTAUTH = 9, /*!< RFC 2136. The server is not authoritative
+ * for the zone named in the Zone section.
+ */
+ ARES_RCODE_NOTZONE = 10, /*!< RFC 2136. A name used in the Prerequisite
+ * or Update Section is not within the zone
+ * denoted by the Zone Section. */
+ ARES_RCODE_DSOTYPEI = 11, /*!< RFC 8409. DSO-TYPE Not implemented */
+ ARES_RCODE_BADSIG = 16, /*!< RFC 8945. TSIG Signature Failure */
+ ARES_RCODE_BADKEY = 17, /*!< RFC 8945. Key not recognized. */
+ ARES_RCODE_BADTIME = 18, /*!< RFC 8945. Signature out of time window. */
+ ARES_RCODE_BADMODE = 19, /*!< RFC 2930. Bad TKEY Mode */
+ ARES_RCODE_BADNAME = 20, /*!< RFC 2930. Duplicate Key Name */
+ ARES_RCODE_BADALG = 21, /*!< RFC 2930. Algorithm not supported */
+ ARES_RCODE_BADTRUNC = 22, /*!< RFC 8945. Bad Truncation */
+ ARES_RCODE_BADCOOKIE = 23, /*!< RVC 7973. Bad/missing Server Cookie */
+} ares_dns_rcode_t;
+
+/*! Data types used */
+typedef enum {
+ ARES_DATATYPE_INADDR = 1, /*!< struct in_addr * type */
+ ARES_DATATYPE_INADDR6 = 2, /*!< struct ares_in6_addr * type */
+ ARES_DATATYPE_U8 = 3, /*!< 8bit unsigned integer */
+ ARES_DATATYPE_U16 = 4, /*!< 16bit unsigned integer */
+ ARES_DATATYPE_U32 = 5, /*!< 32bit unsigned integer */
+ ARES_DATATYPE_NAME = 6, /*!< Null-terminated string of a domain name */
+ ARES_DATATYPE_STR = 7, /*!< Null-terminated string */
+ ARES_DATATYPE_BIN = 8, /*!< Binary data */
+ ARES_DATATYPE_BINP = 9, /*!< Officially defined as binary data, but likely
+ * printable. Guaranteed to have a NULL
+ * terminator for convenience (not included in
+ * length) */
+ ARES_DATATYPE_OPT = 10, /*!< Array of options. 16bit identifier, BIN
+ * data. */
+} ares_dns_datatype_t;
+
+/*! Keys used for all RR Types. We take the record type and multiply by 100
+ * to ensure we have a proper offset between keys so we can keep these sorted
+ */
+typedef enum {
+ /*! A Record. Address. Datatype: INADDR */
+ ARES_RR_A_ADDR = (ARES_REC_TYPE_A * 100) + 1,
+ /*! NS Record. Name. Datatype: NAME */
+ ARES_RR_NS_NSDNAME = (ARES_REC_TYPE_NS * 100) + 1,
+ /*! CNAME Record. CName. Datatype: NAME */
+ ARES_RR_CNAME_CNAME = (ARES_REC_TYPE_CNAME * 100) + 1,
+ /*! SOA Record. MNAME, Primary Source of Data. Datatype: NAME */
+ ARES_RR_SOA_MNAME = (ARES_REC_TYPE_SOA * 100) + 1,
+ /*! SOA Record. RNAME, Mailbox of person responsible. Datatype: NAME */
+ ARES_RR_SOA_RNAME = (ARES_REC_TYPE_SOA * 100) + 2,
+ /*! SOA Record. Serial, version. Datatype: U32 */
+ ARES_RR_SOA_SERIAL = (ARES_REC_TYPE_SOA * 100) + 3,
+ /*! SOA Record. Refresh, zone refersh interval. Datatype: U32 */
+ ARES_RR_SOA_REFRESH = (ARES_REC_TYPE_SOA * 100) + 4,
+ /*! SOA Record. Retry, failed refresh retry interval. Datatype: U32 */
+ ARES_RR_SOA_RETRY = (ARES_REC_TYPE_SOA * 100) + 5,
+ /*! SOA Record. Expire, upper limit on authority. Datatype: U32 */
+ ARES_RR_SOA_EXPIRE = (ARES_REC_TYPE_SOA * 100) + 6,
+ /*! SOA Record. Minimum, RR TTL. Datatype: U32 */
+ ARES_RR_SOA_MINIMUM = (ARES_REC_TYPE_SOA * 100) + 7,
+ /*! PTR Record. DNAME, pointer domain. Datatype: NAME */
+ ARES_RR_PTR_DNAME = (ARES_REC_TYPE_PTR * 100) + 1,
+ /*! HINFO Record. CPU. Datatype: STR */
+ ARES_RR_HINFO_CPU = (ARES_REC_TYPE_HINFO * 100) + 1,
+ /*! HINFO Record. OS. Datatype: STR */
+ ARES_RR_HINFO_OS = (ARES_REC_TYPE_HINFO * 100) + 2,
+ /*! MX Record. Preference. Datatype: U16 */
+ ARES_RR_MX_PREFERENCE = (ARES_REC_TYPE_MX * 100) + 1,
+ /*! MX Record. Exchange, domain. Datatype: NAME */
+ ARES_RR_MX_EXCHANGE = (ARES_REC_TYPE_MX * 100) + 2,
+ /*! TXT Record. Data. Datatype: BINP */
+ ARES_RR_TXT_DATA = (ARES_REC_TYPE_TXT * 100) + 1,
+ /*! AAAA Record. Address. Datatype: INADDR6 */
+ ARES_RR_AAAA_ADDR = (ARES_REC_TYPE_AAAA * 100) + 1,
+ /*! SRV Record. Priority. Datatype: U16 */
+ ARES_RR_SRV_PRIORITY = (ARES_REC_TYPE_SRV * 100) + 2,
+ /*! SRV Record. Weight. Datatype: U16 */
+ ARES_RR_SRV_WEIGHT = (ARES_REC_TYPE_SRV * 100) + 3,
+ /*! SRV Record. Port. Datatype: U16 */
+ ARES_RR_SRV_PORT = (ARES_REC_TYPE_SRV * 100) + 4,
+ /*! SRV Record. Target domain. Datatype: NAME */
+ ARES_RR_SRV_TARGET = (ARES_REC_TYPE_SRV * 100) + 5,
+ /*! NAPTR Record. Order. Datatype: U16 */
+ ARES_RR_NAPTR_ORDER = (ARES_REC_TYPE_NAPTR * 100) + 1,
+ /*! NAPTR Record. Preference. Datatype: U16 */
+ ARES_RR_NAPTR_PREFERENCE = (ARES_REC_TYPE_NAPTR * 100) + 2,
+ /*! NAPTR Record. Flags. Datatype: STR */
+ ARES_RR_NAPTR_FLAGS = (ARES_REC_TYPE_NAPTR * 100) + 3,
+ /*! NAPTR Record. Services. Datatype: STR */
+ ARES_RR_NAPTR_SERVICES = (ARES_REC_TYPE_NAPTR * 100) + 4,
+ /*! NAPTR Record. Regexp. Datatype: STR */
+ ARES_RR_NAPTR_REGEXP = (ARES_REC_TYPE_NAPTR * 100) + 5,
+ /*! NAPTR Record. Replacement. Datatype: NAME */
+ ARES_RR_NAPTR_REPLACEMENT = (ARES_REC_TYPE_NAPTR * 100) + 6,
+ /*! OPT Record. UDP Size. Datatype: U16 */
+ ARES_RR_OPT_UDP_SIZE = (ARES_REC_TYPE_OPT * 100) + 1,
+ /*! OPT Record. Version. Datatype: U8 */
+ ARES_RR_OPT_VERSION = (ARES_REC_TYPE_OPT * 100) + 3,
+ /*! OPT Record. Flags. Datatype: U16 */
+ ARES_RR_OPT_FLAGS = (ARES_REC_TYPE_OPT * 100) + 4,
+ /*! OPT Record. Options. Datatype: OPT */
+ ARES_RR_OPT_OPTIONS = (ARES_REC_TYPE_OPT * 100) + 5,
+ /*! TLSA Record. Certificate Usage. Datatype: U8 */
+ ARES_RR_TLSA_CERT_USAGE = (ARES_REC_TYPE_TLSA * 100) + 1,
+ /*! TLSA Record. Selector. Datatype: U8 */
+ ARES_RR_TLSA_SELECTOR = (ARES_REC_TYPE_TLSA * 100) + 2,
+ /*! TLSA Record. Matching Type. Datatype: U8 */
+ ARES_RR_TLSA_MATCH = (ARES_REC_TYPE_TLSA * 100) + 3,
+ /*! TLSA Record. Certificate Association Data. Datatype: BIN */
+ ARES_RR_TLSA_DATA = (ARES_REC_TYPE_TLSA * 100) + 4,
+ /*! SVCB Record. SvcPriority. Datatype: U16 */
+ ARES_RR_SVCB_PRIORITY = (ARES_REC_TYPE_SVCB * 100) + 1,
+ /*! SVCB Record. TargetName. Datatype: NAME */
+ ARES_RR_SVCB_TARGET = (ARES_REC_TYPE_SVCB * 100) + 2,
+ /*! SVCB Record. SvcParams. Datatype: OPT */
+ ARES_RR_SVCB_PARAMS = (ARES_REC_TYPE_SVCB * 100) + 3,
+ /*! HTTPS Record. SvcPriority. Datatype: U16 */
+ ARES_RR_HTTPS_PRIORITY = (ARES_REC_TYPE_HTTPS * 100) + 1,
+ /*! HTTPS Record. TargetName. Datatype: NAME */
+ ARES_RR_HTTPS_TARGET = (ARES_REC_TYPE_HTTPS * 100) + 2,
+ /*! HTTPS Record. SvcParams. Datatype: OPT */
+ ARES_RR_HTTPS_PARAMS = (ARES_REC_TYPE_HTTPS * 100) + 3,
+ /*! URI Record. Priority. Datatype: U16 */
+ ARES_RR_URI_PRIORITY = (ARES_REC_TYPE_URI * 100) + 1,
+ /*! URI Record. Weight. Datatype: U16 */
+ ARES_RR_URI_WEIGHT = (ARES_REC_TYPE_URI * 100) + 2,
+ /*! URI Record. Target domain. Datatype: NAME */
+ ARES_RR_URI_TARGET = (ARES_REC_TYPE_URI * 100) + 3,
+ /*! CAA Record. Critical flag. Datatype: U8 */
+ ARES_RR_CAA_CRITICAL = (ARES_REC_TYPE_CAA * 100) + 1,
+ /*! CAA Record. Tag/Property. Datatype: STR */
+ ARES_RR_CAA_TAG = (ARES_REC_TYPE_CAA * 100) + 2,
+ /*! CAA Record. Value. Datatype: BINP */
+ ARES_RR_CAA_VALUE = (ARES_REC_TYPE_CAA * 100) + 3,
+ /*! RAW Record. RR Type. Datatype: U16 */
+ ARES_RR_RAW_RR_TYPE = (ARES_REC_TYPE_RAW_RR * 100) + 1,
+ /*! RAW Record. RR Data. Datatype: BIN */
+ ARES_RR_RAW_RR_DATA = (ARES_REC_TYPE_RAW_RR * 100) + 2,
+} ares_dns_rr_key_t;
+
+/*! TLSA Record ARES_RR_TLSA_CERT_USAGE known values */
+typedef enum {
+ /*! Certificate Usage 0. CA Constraint. */
+ ARES_TLSA_USAGE_CA = 0,
+ /*! Certificate Usage 1. Service Certificate Constraint. */
+ ARES_TLSA_USAGE_SERVICE = 1,
+ /*! Certificate Usage 2. Trust Anchor Assertion. */
+ ARES_TLSA_USAGE_TRUSTANCHOR = 2,
+ /*! Certificate Usage 3. Domain-issued certificate. */
+ ARES_TLSA_USAGE_DOMAIN = 3
+} ares_tlsa_usage_t;
+
+/*! TLSA Record ARES_RR_TLSA_SELECTOR known values */
+typedef enum {
+ /*! Full Certificate */
+ ARES_TLSA_SELECTOR_FULL = 0,
+ /*! DER-encoded SubjectPublicKeyInfo */
+ ARES_TLSA_SELECTOR_SUBJPUBKEYINFO = 1
+} ares_tlsa_selector_t;
+
+/*! TLSA Record ARES_RR_TLSA_MATCH known values */
+typedef enum {
+ /*! Exact match */
+ ARES_TLSA_MATCH_EXACT = 0,
+ /*! Sha256 match */
+ ARES_TLSA_MATCH_SHA256 = 1,
+ /*! Sha512 match */
+ ARES_TLSA_MATCH_SHA512 = 2
+} ares_tlsa_match_t;
+
+/*! SVCB (and HTTPS) RR known parameters */
+typedef enum {
+ /*! Mandatory keys in this RR (RFC 9460 Section 8) */
+ ARES_SVCB_PARAM_MANDATORY = 0,
+ /*! Additional supported protocols (RFC 9460 Section 7.1) */
+ ARES_SVCB_PARAM_ALPN = 1,
+ /*! No support for default protocol (RFC 9460 Section 7.1) */
+ ARES_SVCB_PARAM_NO_DEFAULT_ALPN = 2,
+ /*! Port for alternative endpoint (RFC 9460 Section 7.2) */
+ ARES_SVCB_PARAM_PORT = 3,
+ /*! IPv4 address hints (RFC 9460 Section 7.3) */
+ ARES_SVCB_PARAM_IPV4HINT = 4,
+ /*! RESERVED (held for Encrypted ClientHello) */
+ ARES_SVCB_PARAM_ECH = 5,
+ /*! IPv6 address hints (RFC 9460 Section 7.3) */
+ ARES_SVCB_PARAM_IPV6HINT = 6
+} ares_svcb_param_t;
+
+/*! OPT RR known parameters */
+typedef enum {
+ /*! RFC 8764. Apple's DNS Long-Lived Queries Protocol */
+ ARES_OPT_PARAM_LLQ = 1,
+ /*! http://files.dns-sd.org/draft-sekar-dns-ul.txt: Update Lease */
+ ARES_OPT_PARAM_UL = 2,
+ /*! RFC 5001. Name Server Identification */
+ ARES_OPT_PARAM_NSID = 3,
+ /*! RFC 6975. DNSSEC Algorithm Understood */
+ ARES_OPT_PARAM_DAU = 5,
+ /*! RFC 6975. DS Hash Understood */
+ ARES_OPT_PARAM_DHU = 6,
+ /*! RFC 6975. NSEC3 Hash Understood */
+ ARES_OPT_PARAM_N3U = 7,
+ /*! RFC 7871. Client Subnet */
+ ARES_OPT_PARAM_EDNS_CLIENT_SUBNET = 8,
+ /*! RFC 7314. Expire Timer */
+ ARES_OPT_PARAM_EDNS_EXPIRE = 9,
+ /*! RFC 7873. Client and Server Cookies */
+ ARES_OPT_PARAM_COOKIE = 10,
+ /*! RFC 7828. TCP Keepalive timeout */
+ ARES_OPT_PARAM_EDNS_TCP_KEEPALIVE = 11,
+ /*! RFC 7830. Padding */
+ ARES_OPT_PARAM_PADDING = 12,
+ /*! RFC 7901. Chain query requests */
+ ARES_OPT_PARAM_CHAIN = 13,
+ /*! RFC 8145. Signaling Trust Anchor Knowledge in DNSSEC */
+ ARES_OPT_PARAM_EDNS_KEY_TAG = 14,
+ /*! RFC 8914. Extended ERROR code and message */
+ ARES_OPT_PARAM_EXTENDED_DNS_ERROR = 15,
+} ares_opt_param_t;
+
+/*! Data type for option records for keys like ARES_RR_OPT_OPTIONS and
+ * ARES_RR_HTTPS_PARAMS returned by ares_dns_opt_get_datatype() */
+typedef enum {
+ /*! No value allowed for this option */
+ ARES_OPT_DATATYPE_NONE = 1,
+ /*! List of strings, each prefixed with a single octet representing the length
+ */
+ ARES_OPT_DATATYPE_STR_LIST = 2,
+ /*! List of 8bit integers, concatenated */
+ ARES_OPT_DATATYPE_U8_LIST = 3,
+ /*! 16bit integer in network byte order */
+ ARES_OPT_DATATYPE_U16 = 4,
+ /*! list of 16bit integer in network byte order, concatenated. */
+ ARES_OPT_DATATYPE_U16_LIST = 5,
+ /*! 32bit integer in network byte order */
+ ARES_OPT_DATATYPE_U32 = 6,
+ /*! list 32bit integer in network byte order, concatenated */
+ ARES_OPT_DATATYPE_U32_LIST = 7,
+ /*! List of ipv4 addresses in network byte order, concatenated */
+ ARES_OPT_DATATYPE_INADDR4_LIST = 8,
+ /*! List of ipv6 addresses in network byte order, concatenated */
+ ARES_OPT_DATATYPE_INADDR6_LIST = 9,
+ /*! Binary Data */
+ ARES_OPT_DATATYPE_BIN = 10,
+ /*! DNS Domain Name Format */
+ ARES_OPT_DATATYPE_NAME = 11
+} ares_dns_opt_datatype_t;
+
+/*! String representation of DNS Record Type
+ *
+ * \param[in] type DNS Record Type
+ * \return string
+ */
+CARES_EXTERN const char *ares_dns_rec_type_tostr(ares_dns_rec_type_t type);
+
+/*! String representation of DNS Class
+ *
+ * \param[in] qclass DNS Class
+ * \return string
+ */
+CARES_EXTERN const char *ares_dns_class_tostr(ares_dns_class_t qclass);
+
+/*! String representation of DNS OpCode
+ *
+ * \param[in] opcode DNS OpCode
+ * \return string
+ */
+CARES_EXTERN const char *ares_dns_opcode_tostr(ares_dns_opcode_t opcode);
+
+/*! String representation of DNS Resource Record Parameter
+ *
+ * \param[in] key DNS Resource Record parameter
+ * \return string
+ */
+CARES_EXTERN const char *ares_dns_rr_key_tostr(ares_dns_rr_key_t key);
+
+/*! String representation of DNS Resource Record section
+ *
+ * \param[in] section Section
+ * \return string
+ */
+CARES_EXTERN const char *ares_dns_section_tostr(ares_dns_section_t section);
+
+/*! Convert DNS class name as string to ares_dns_class_t
+ *
+ * \param[out] qclass Pointer passed by reference to write class
+ * \param[in] str String to convert
+ * \return ARES_TRUE on success
+ */
+CARES_EXTERN ares_bool_t ares_dns_class_fromstr(ares_dns_class_t *qclass,
+ const char *str);
+
+/*! Convert DNS record type as string to ares_dns_rec_type_t
+ *
+ * \param[out] qclass Pointer passed by reference to write record type
+ * \param[in] str String to convert
+ * \return ARES_TRUE on success
+ */
+CARES_EXTERN ares_bool_t ares_dns_rec_type_fromstr(ares_dns_rec_type_t *qtype,
+ const char *str);
+
+
+/*! Convert DNS response code as string to from ares_dns_rcode_t
+ *
+ * \param[in] rcode Response code to convert
+ * \return ARES_TRUE on success
+ */
+CARES_EXTERN const char *ares_dns_rcode_tostr(ares_dns_rcode_t rcode);
+
+/*! Convert any valid ip address (ipv4 or ipv6) into struct ares_addr and
+ * return the starting pointer of the network byte order address and the
+ * length of the address (4 or 16).
+ *
+ * \param[in] ipaddr ASCII string form of the ip address
+ * \param[in,out] addr Must set "family" member to one of AF_UNSPEC,
+ * AF_INET, AF_INET6 on input.
+ * \param[out] ptr_len Length of binary form address
+ * \return Pointer to start of binary address or NULL on error.
+ */
+CARES_EXTERN const void *ares_dns_pton(const char *ipaddr,
+ struct ares_addr *addr, size_t *out_len);
+
+/*! Convert an ip address into the PTR format for in-addr.arpa or in6.arpa
+ *
+ * \param[in] addr properly filled address structure
+ * \return String representing PTR, use ares_free_string() to free
+ */
+CARES_EXTERN char *ares_dns_addr_to_ptr(const struct ares_addr *addr);
+
+
+/*! The options/parameters extensions to some RRs can be somewhat opaque, this
+ * is a helper to return the best match for a datatype for interpreting the
+ * option record.
+ *
+ * \param[in] key Key associated with options/parameters
+ * \param[in] opt Option Key/Parameter
+ * \return Datatype
+ */
+CARES_EXTERN ares_dns_opt_datatype_t
+ ares_dns_opt_get_datatype(ares_dns_rr_key_t key, unsigned short opt);
+
+/*! The options/parameters extensions to some RRs can be somewhat opaque, this
+ * is a helper to return the name if the option is known.
+ *
+ * \param[in] key Key associated with options/parameters
+ * \param[in] opt Option Key/Parameter
+ * \return name, or NULL if not known.
+ */
+CARES_EXTERN const char *ares_dns_opt_get_name(ares_dns_rr_key_t key,
+ unsigned short opt);
+
+
+/*! Retrieve a list of Resource Record keys that can be set or retrieved for
+ * the Resource record type.
+ *
+ * \param[in] type Record Type
+ * \param[out] cnt Number of keys returned
+ * \return array of keys associated with Resource Record
+ */
+CARES_EXTERN const ares_dns_rr_key_t *
+ ares_dns_rr_get_keys(ares_dns_rec_type_t type, size_t *cnt);
+
+/*! Retrieve the datatype associated with a Resource Record key.
+ *
+ * \param[in] key Resource Record Key
+ * \return datatype
+ */
+CARES_EXTERN ares_dns_datatype_t
+ ares_dns_rr_key_datatype(ares_dns_rr_key_t key);
+
+/*! Retrieve the DNS Resource Record type associated with a Resource Record key.
+ *
+ * \param[in] key Resource Record Key
+ * \return DNS Resource Record Type
+ */
+CARES_EXTERN ares_dns_rec_type_t
+ ares_dns_rr_key_to_rec_type(ares_dns_rr_key_t key);
+
+/*! Opaque data type representing a DNS RR (Resource Record) */
+struct ares_dns_rr;
+
+/*! Typedef for opaque data type representing a DNS RR (Resource Record) */
+typedef struct ares_dns_rr ares_dns_rr_t;
+
+/*! Opaque data type representing a DNS Query Data QD Packet */
+struct ares_dns_qd;
+
+/*! Typedef for opaque data type representing a DNS Query Data QD Packet */
+typedef struct ares_dns_qd ares_dns_qd_t;
+
+/*! Opaque data type representing a DNS Packet */
+struct ares_dns_record;
+
+/*! Typedef for opaque data type representing a DNS Packet */
+typedef struct ares_dns_record ares_dns_record_t;
+
+
+/*! Create a new DNS record object
+ *
+ * \param[out] dnsrec Pointer passed by reference for a newly allocated
+ * record object. Must be ares_dns_record_destroy()'d by
+ * caller.
+ * \param[in] id DNS Query ID. If structuring a new query to be sent
+ * with ares_send(), this value should be zero.
+ * \param[in] flags DNS Flags from \ares_dns_flags_t
+ * \param[in] opcode DNS OpCode (typically ARES_OPCODE_QUERY)
+ * \param[in] rcode DNS RCode
+ * \return ARES_SUCCESS on success
+ */
+CARES_EXTERN ares_status_t ares_dns_record_create(ares_dns_record_t **dnsrec,
+ unsigned short id,
+ unsigned short flags,
+ ares_dns_opcode_t opcode,
+ ares_dns_rcode_t rcode);
+
+/*! Destroy a DNS record object
+ *
+ * \param[in] dnsrec Initialized record object
+ */
+CARES_EXTERN void ares_dns_record_destroy(ares_dns_record_t *dnsrec);
+
+/*! Get the DNS Query ID
+ *
+ * \param[in] dnsrec Initialized record object
+ * \return DNS query id
+ */
+CARES_EXTERN unsigned short
+ ares_dns_record_get_id(const ares_dns_record_t *dnsrec);
+
+/*! Get the DNS Record Flags
+ *
+ * \param[in] dnsrec Initialized record object
+ * \return One or more \ares_dns_flags_t
+ */
+CARES_EXTERN unsigned short
+ ares_dns_record_get_flags(const ares_dns_record_t *dnsrec);
+
+/*! Get the DNS Record OpCode
+ *
+ * \param[in] dnsrec Initialized record object
+ * \return opcode
+ */
+CARES_EXTERN ares_dns_opcode_t
+ ares_dns_record_get_opcode(const ares_dns_record_t *dnsrec);
+
+/*! Get the DNS Record RCode
+ *
+ * \param[in] dnsrec Initialized record object
+ * \return rcode
+ */
+CARES_EXTERN ares_dns_rcode_t
+ ares_dns_record_get_rcode(const ares_dns_record_t *dnsrec);
+
+/*! Add a query to the DNS Record. Typically a record will have only 1
+ * query. Most DNS servers will reject queries with more than 1 question.
+ *
+ * \param[in] dnsrec Initialized record object
+ * \param[in] name Name/Hostname of request
+ * \param[in] qtype Type of query
+ * \param[in] qclass Class of query (typically ARES_CLASS_IN)
+ * \return ARES_SUCCESS on success
+ */
+CARES_EXTERN ares_status_t ares_dns_record_query_add(ares_dns_record_t *dnsrec,
+ const char *name,
+ ares_dns_rec_type_t qtype,
+ ares_dns_class_t qclass);
+
+/*! Get the count of queries in the DNS Record
+ *
+ * \param[in] dnsrec Initialized record object
+ * \return count of queries
+ */
+CARES_EXTERN size_t ares_dns_record_query_cnt(const ares_dns_record_t *dnsrec);
+
+/*! Get the data about the query at the provided index.
+ *
+ * \param[in] dnsrec Initialized record object
+ * \param[in] idx Index of query
+ * \param[out] name Optional. Returns name, may pass NULL if not desired.
+ * \param[out] qtype Optional. Returns record type, may pass NULL.
+ * \param[out] qclass Optional. Returns class, may pass NULL.
+ * \return ARES_SUCCESS on success
+ */
+CARES_EXTERN ares_status_t ares_dns_record_query_get(
+ const ares_dns_record_t *dnsrec, size_t idx, const char **name,
+ ares_dns_rec_type_t *qtype, ares_dns_class_t *qclass);
+
+/*! Get the count of Resource Records in the provided section
+ *
+ * \param[in] dnsrec Initialized record object
+ * \param[in] sect Section. ARES_SECTION_ANSWER is most used.
+ * \return count of resource records.
+ */
+CARES_EXTERN size_t ares_dns_record_rr_cnt(const ares_dns_record_t *dnsrec,
+ ares_dns_section_t sect);
+
+
+/*! Add a Resource Record to the DNS Record.
+ *
+ * \param[out] rr_out Pointer to created resource record. This pointer
+ * is owned by the DNS record itself, this is just made
+ * available to facilitate adding RR-specific fields.
+ * \param[in] dnsrec Initialized record object
+ * \param[in] sect Section to add resource record to
+ * \param[in] name Resource Record name/hostname
+ * \param[in] type Record Type
+ * \param[in] rclass Class
+ * \param[in] ttl TTL
+ * \return ARES_SUCCESS on success
+ */
+CARES_EXTERN ares_status_t ares_dns_record_rr_add(
+ ares_dns_rr_t **rr_out, ares_dns_record_t *dnsrec, ares_dns_section_t sect,
+ const char *name, ares_dns_rec_type_t type, ares_dns_class_t rclass,
+ unsigned int ttl);
+
+/*! Fetch a resource record based on the section and index.
+ *
+ * \param[in] dnsrec Initialized record object
+ * \param[in] sect Section for resource record
+ * \param[in] idx Index of resource record in section
+ * \return NULL on misuse, otherwise a pointer to the resource record
+ */
+CARES_EXTERN ares_dns_rr_t *ares_dns_record_rr_get(ares_dns_record_t *dnsrec,
+ ares_dns_section_t sect,
+ size_t idx);
+
+
+/*! Remove the resource record based on the section and index
+ *
+ * \param[in] dnsrec Initialized record object
+ * \param[in] sect Section for resource record
+ * \param[in] idx Index of resource record in section
+ * \return ARES_SUCCESS on success, otherwise an error code.
+ */
+CARES_EXTERN ares_status_t ares_dns_record_rr_del(ares_dns_record_t *dnsrec,
+ ares_dns_section_t sect,
+ size_t idx);
+
+
+/*! Retrieve the resource record Name/Hostname
+ *
+ * \param[in] rr Pointer to resource record
+ * \return Name
+ */
+CARES_EXTERN const char *ares_dns_rr_get_name(const ares_dns_rr_t *rr);
+
+/*! Retrieve the resource record type
+ *
+ * \param[in] rr Pointer to resource record
+ * \return type
+ */
+CARES_EXTERN ares_dns_rec_type_t ares_dns_rr_get_type(const ares_dns_rr_t *rr);
+
+/*! Retrieve the resource record class
+ *
+ * \param[in] rr Pointer to resource record
+ * \return class
+ */
+CARES_EXTERN ares_dns_class_t ares_dns_rr_get_class(const ares_dns_rr_t *rr);
+
+/*! Retrieve the resource record TTL
+ *
+ * \param[in] rr Pointer to resource record
+ * \return TTL
+ */
+CARES_EXTERN unsigned int ares_dns_rr_get_ttl(const ares_dns_rr_t *rr);
+
+/*! Set ipv4 address data type for specified resource record and key. Can
+ * only be used on keys with datatype ARES_DATATYPE_INADDR
+ *
+ * \param[in] dns_rr Pointer to resource record
+ * \param[in] key DNS Resource Record Key
+ * \param[in] addr Pointer to ipv4 address to use.
+ * \return ARES_SUCCESS on success
+ */
+CARES_EXTERN ares_status_t ares_dns_rr_set_addr(ares_dns_rr_t *dns_rr,
+ ares_dns_rr_key_t key,
+ const struct in_addr *addr);
+
+/*! Set ipv6 address data type for specified resource record and key. Can
+ * only be used on keys with datatype ARES_DATATYPE_INADDR6
+ *
+ * \param[in] dns_rr Pointer to resource record
+ * \param[in] key DNS Resource Record Key
+ * \param[in] addr Pointer to ipv6 address to use.
+ * \return ARES_SUCCESS on success
+ */
+CARES_EXTERN ares_status_t
+ ares_dns_rr_set_addr6(ares_dns_rr_t *dns_rr, ares_dns_rr_key_t key,
+ const struct ares_in6_addr *addr);
+
+/*! Set string data for specified resource record and key. Can
+ * only be used on keys with datatype ARES_DATATYPE_STR or ARES_DATATYPE_NAME.
+ *
+ * \param[in] dns_rr Pointer to resource record
+ * \param[in] key DNS Resource Record Key
+ * \param[in] val Pointer to string to set.
+ * \return ARES_SUCCESS on success
+ */
+CARES_EXTERN ares_status_t ares_dns_rr_set_str(ares_dns_rr_t *dns_rr,
+ ares_dns_rr_key_t key,
+ const char *val);
+
+/*! Set 8bit unsigned integer for specified resource record and key. Can
+ * only be used on keys with datatype ARES_DATATYPE_U8
+ *
+ * \param[in] dns_rr Pointer to resource record
+ * \param[in] key DNS Resource Record Key
+ * \param[in] val 8bit unsigned integer
+ * \return ARES_SUCCESS on success
+ */
+CARES_EXTERN ares_status_t ares_dns_rr_set_u8(ares_dns_rr_t *dns_rr,
+ ares_dns_rr_key_t key,
+ unsigned char val);
+
+/*! Set 16bit unsigned integer for specified resource record and key. Can
+ * only be used on keys with datatype ARES_DATATYPE_U16
+ *
+ * \param[in] dns_rr Pointer to resource record
+ * \param[in] key DNS Resource Record Key
+ * \param[in] val 16bit unsigned integer
+ * \return ARES_SUCCESS on success
+ */
+CARES_EXTERN ares_status_t ares_dns_rr_set_u16(ares_dns_rr_t *dns_rr,
+ ares_dns_rr_key_t key,
+ unsigned short val);
+
+/*! Set 32bit unsigned integer for specified resource record and key. Can
+ * only be used on keys with datatype ARES_DATATYPE_U32
+ *
+ * \param[in] dns_rr Pointer to resource record
+ * \param[in] key DNS Resource Record Key
+ * \param[in] val 32bit unsigned integer
+ * \return ARES_SUCCESS on success
+ */
+CARES_EXTERN ares_status_t ares_dns_rr_set_u32(ares_dns_rr_t *dns_rr,
+ ares_dns_rr_key_t key,
+ unsigned int val);
+
+/*! Set binary (BIN or BINP) data for specified resource record and key. Can
+ * only be used on keys with datatype ARES_DATATYPE_BIN or ARES_DATATYPE_BINP.
+ *
+ * \param[in] dns_rr Pointer to resource record
+ * \param[in] key DNS Resource Record Key
+ * \param[in] val Pointer to binary data.
+ * \param[in] len Length of binary data
+ * \return ARES_SUCCESS on success
+ */
+CARES_EXTERN ares_status_t ares_dns_rr_set_bin(ares_dns_rr_t *dns_rr,
+ ares_dns_rr_key_t key,
+ const unsigned char *val,
+ size_t len);
+
+/*! Set the option for the RR
+ *
+ * \param[in] dns_rr Pointer to resource record
+ * \param[in] key DNS Resource Record Key
+ * \param[in] opt Option record key id.
+ * \param[out] val Optional. Value to associate with option.
+ * \param[out] val_len Length of value passed.
+ * \return ARES_SUCCESS on success
+ */
+CARES_EXTERN ares_status_t ares_dns_rr_set_opt(ares_dns_rr_t *dns_rr,
+ ares_dns_rr_key_t key,
+ unsigned short opt,
+ const unsigned char *val,
+ size_t val_len);
+
+/*! Retrieve a pointer to the ipv4 address. Can only be used on keys with
+ * datatype ARES_DATATYPE_INADDR.
+ *
+ * \param[in] dns_rr Pointer to resource record
+ * \param[in] key DNS Resource Record Key
+ * \return pointer to ipv4 address or NULL on error
+ */
+CARES_EXTERN const struct in_addr *
+ ares_dns_rr_get_addr(const ares_dns_rr_t *dns_rr, ares_dns_rr_key_t key);
+
+/*! Retrieve a pointer to the ipv6 address. Can only be used on keys with
+ * datatype ARES_DATATYPE_INADDR6.
+ *
+ * \param[in] dns_rr Pointer to resource record
+ * \param[in] key DNS Resource Record Key
+ * \return pointer to ipv6 address or NULL on error
+ */
+CARES_EXTERN const struct ares_in6_addr *
+ ares_dns_rr_get_addr6(const ares_dns_rr_t *dns_rr, ares_dns_rr_key_t key);
+
+/*! Retrieve a pointer to the string. Can only be used on keys with
+ * datatype ARES_DATATYPE_STR and ARES_DATATYPE_NAME.
+ *
+ * \param[in] dns_rr Pointer to resource record
+ * \param[in] key DNS Resource Record Key
+ * \return pointer string or NULL on error
+ */
+CARES_EXTERN const char *ares_dns_rr_get_str(const ares_dns_rr_t *dns_rr,
+ ares_dns_rr_key_t key);
+
+/*! Retrieve an 8bit unsigned integer. Can only be used on keys with
+ * datatype ARES_DATATYPE_U8.
+ *
+ * \param[in] dns_rr Pointer to resource record
+ * \param[in] key DNS Resource Record Key
+ * \return 8bit unsigned integer
+ */
+CARES_EXTERN unsigned char ares_dns_rr_get_u8(const ares_dns_rr_t *dns_rr,
+ ares_dns_rr_key_t key);
+
+/*! Retrieve an 16bit unsigned integer. Can only be used on keys with
+ * datatype ARES_DATATYPE_U16.
+ *
+ * \param[in] dns_rr Pointer to resource record
+ * \param[in] key DNS Resource Record Key
+ * \return 16bit unsigned integer
+ */
+CARES_EXTERN unsigned short ares_dns_rr_get_u16(const ares_dns_rr_t *dns_rr,
+ ares_dns_rr_key_t key);
+
+/*! Retrieve an 32bit unsigned integer. Can only be used on keys with
+ * datatype ARES_DATATYPE_U32.
+ *
+ * \param[in] dns_rr Pointer to resource record
+ * \param[in] key DNS Resource Record Key
+ * \return 32bit unsigned integer
+ */
+CARES_EXTERN unsigned int ares_dns_rr_get_u32(const ares_dns_rr_t *dns_rr,
+ ares_dns_rr_key_t key);
+
+/*! Retrieve a pointer to the binary data. Can only be used on keys with
+ * datatype ARES_DATATYPE_BIN or ARES_DATATYPE_BINP. If BINP, the data is
+ * guaranteed to have a NULL terminator which is NOT included in the length.
+ *
+ * \param[in] dns_rr Pointer to resource record
+ * \param[in] key DNS Resource Record Key
+ * \param[out] len Length of binary data returned
+ * \return pointer binary data or NULL on error
+ */
+CARES_EXTERN const unsigned char *
+ ares_dns_rr_get_bin(const ares_dns_rr_t *dns_rr, ares_dns_rr_key_t key,
+ size_t *len);
+
+/*! Retrieve the number of options stored for the RR.
+ *
+ * \param[in] dns_rr Pointer to resource record
+ * \param[in] key DNS Resource Record Key
+ * \return count, or 0 if none.
+ */
+CARES_EXTERN size_t ares_dns_rr_get_opt_cnt(const ares_dns_rr_t *dns_rr,
+ ares_dns_rr_key_t key);
+
+/*! Retrieve the option for the RR by index.
+ *
+ * \param[in] dns_rr Pointer to resource record
+ * \param[in] key DNS Resource Record Key
+ * \param[in] idx Index of option record
+ * \param[out] val Optional. Pointer passed by reference to hold value.
+ * Options may not have values. Value if returned is
+ * guaranteed to be NULL terminated, however in most
+ * cases it is not printable.
+ * \param[out] val_len Optional. Pointer passed by reference to hold value
+ * length.
+ * \return option key/id on success, 65535 on misuse.
+ */
+CARES_EXTERN unsigned short
+ ares_dns_rr_get_opt(const ares_dns_rr_t *dns_rr, ares_dns_rr_key_t key,
+ size_t idx, const unsigned char **val, size_t *val_len);
+
+/*! Retrieve the option for the RR by the option key/id.
+ *
+ * \param[in] dns_rr Pointer to resource record
+ * \param[in] key DNS Resource Record Key
+ * \param[in] opt Option record key id (this is not the index).
+ * \param[out] val Optional. Pointer passed by reference to hold value.
+ * Options may not have values. Value if returned is
+ * guaranteed to be NULL terminated, however in most cases
+ * it is not printable.
+ * \param[out] val_len Optional. Pointer passed by reference to hold value
+ * length.
+ * \return ARES_TRUE on success, ARES_FALSE on misuse.
+ */
+CARES_EXTERN ares_bool_t ares_dns_rr_get_opt_byid(const ares_dns_rr_t *dns_rr,
+ ares_dns_rr_key_t key,
+ unsigned short opt,
+ const unsigned char **val,
+ size_t *val_len);
+
+/*! Parse a complete DNS message.
+ *
+ * \param[in] buf pointer to bytes to be parsed
+ * \param[in] buf_len Length of buf provided
+ * \param[in] flags Flags dictating how the message should be parsed. TBD.
+ * \param[out] dnsrec Pointer passed by reference for a new DNS record object
+ * that must be ares_dns_record_destroy()'d by caller.
+ * \return ARES_SUCCESS on success
+ */
+CARES_EXTERN ares_status_t ares_dns_parse(const unsigned char *buf,
+ size_t buf_len, unsigned int flags,
+ ares_dns_record_t **dnsrec);
+
+/*! Write a complete DNS message
+ *
+ * \param[in] dnsrec Pointer to initialized and filled DNS record object.
+ * \param[out] buf Pointer passed by reference to be filled in with with
+ * DNS message. Must be ares_free()'d by caller.
+ * \param[out] buf_len Length of returned buffer containing DNS message.
+ * \return ARES_SUCCESS on success
+ */
+CARES_EXTERN ares_status_t ares_dns_write(ares_dns_record_t *dnsrec,
+ unsigned char **buf, size_t *buf_len);
+/*! @} */
+
+#ifdef __cplusplus
+}
+#endif
+
+#endif /* __ARES_DNS_RECORD_H */
diff --git a/subprojects/c-ares/include/ares_nameser.h b/subprojects/c-ares/include/ares_nameser.h
@@ -0,0 +1,510 @@
+/* MIT License
+ *
+ * Copyright (c) Massachusetts Institute of Technology
+ * Copyright (c) Daniel Stenberg
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice (including the next
+ * paragraph) shall be included in all copies or substantial portions of the
+ * Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ *
+ * SPDX-License-Identifier: MIT
+ */
+
+#ifndef ARES_NAMESER_H
+#define ARES_NAMESER_H
+
+#include "ares_build.h"
+
+#ifdef CARES_HAVE_ARPA_NAMESER_H
+# include <arpa/nameser.h>
+#endif
+#ifdef CARES_HAVE_ARPA_NAMESER_COMPAT_H
+# include <arpa/nameser_compat.h>
+#endif
+
+/* ============================================================================
+ * arpa/nameser.h may or may not provide ALL of the below defines, so check
+ * each one individually and set if not
+ * ============================================================================
+ */
+
+#ifndef NS_PACKETSZ
+# define NS_PACKETSZ 512 /* maximum packet size */
+#endif
+
+#ifndef NS_MAXDNAME
+# define NS_MAXDNAME 256 /* maximum domain name */
+#endif
+
+#ifndef NS_MAXCDNAME
+# define NS_MAXCDNAME 255 /* maximum compressed domain name */
+#endif
+
+#ifndef NS_MAXLABEL
+# define NS_MAXLABEL 63
+#endif
+
+#ifndef NS_HFIXEDSZ
+# define NS_HFIXEDSZ 12 /* #/bytes of fixed data in header */
+#endif
+
+#ifndef NS_QFIXEDSZ
+# define NS_QFIXEDSZ 4 /* #/bytes of fixed data in query */
+#endif
+
+#ifndef NS_RRFIXEDSZ
+# define NS_RRFIXEDSZ 10 /* #/bytes of fixed data in r record */
+#endif
+
+#ifndef NS_INT16SZ
+# define NS_INT16SZ 2
+#endif
+
+#ifndef NS_INADDRSZ
+# define NS_INADDRSZ 4
+#endif
+
+#ifndef NS_IN6ADDRSZ
+# define NS_IN6ADDRSZ 16
+#endif
+
+#ifndef NS_CMPRSFLGS
+# define NS_CMPRSFLGS 0xc0 /* Flag bits indicating name compression. */
+#endif
+
+#ifndef NS_DEFAULTPORT
+# define NS_DEFAULTPORT 53 /* For both TCP and UDP. */
+#endif
+
+/* ============================================================================
+ * arpa/nameser.h should provide these enumerations always, so if not found,
+ * provide them
+ * ============================================================================
+ */
+#ifndef CARES_HAVE_ARPA_NAMESER_H
+
+typedef enum __ns_class {
+ ns_c_invalid = 0, /* Cookie. */
+ ns_c_in = 1, /* Internet. */
+ ns_c_2 = 2, /* unallocated/unsupported. */
+ ns_c_chaos = 3, /* MIT Chaos-net. */
+ ns_c_hs = 4, /* MIT Hesiod. */
+ /* Query class values which do not appear in resource records */
+ ns_c_none = 254, /* for prereq. sections in update requests */
+ ns_c_any = 255, /* Wildcard match. */
+ ns_c_max = 65536
+} ns_class;
+
+typedef enum __ns_type {
+ ns_t_invalid = 0, /* Cookie. */
+ ns_t_a = 1, /* Host address. */
+ ns_t_ns = 2, /* Authoritative server. */
+ ns_t_md = 3, /* Mail destination. */
+ ns_t_mf = 4, /* Mail forwarder. */
+ ns_t_cname = 5, /* Canonical name. */
+ ns_t_soa = 6, /* Start of authority zone. */
+ ns_t_mb = 7, /* Mailbox domain name. */
+ ns_t_mg = 8, /* Mail group member. */
+ ns_t_mr = 9, /* Mail rename name. */
+ ns_t_null = 10, /* Null resource record. */
+ ns_t_wks = 11, /* Well known service. */
+ ns_t_ptr = 12, /* Domain name pointer. */
+ ns_t_hinfo = 13, /* Host information. */
+ ns_t_minfo = 14, /* Mailbox information. */
+ ns_t_mx = 15, /* Mail routing information. */
+ ns_t_txt = 16, /* Text strings. */
+ ns_t_rp = 17, /* Responsible person. */
+ ns_t_afsdb = 18, /* AFS cell database. */
+ ns_t_x25 = 19, /* X_25 calling address. */
+ ns_t_isdn = 20, /* ISDN calling address. */
+ ns_t_rt = 21, /* Router. */
+ ns_t_nsap = 22, /* NSAP address. */
+ ns_t_nsap_ptr = 23, /* Reverse NSAP lookup (deprecated). */
+ ns_t_sig = 24, /* Security signature. */
+ ns_t_key = 25, /* Security key. */
+ ns_t_px = 26, /* X.400 mail mapping. */
+ ns_t_gpos = 27, /* Geographical position (withdrawn). */
+ ns_t_aaaa = 28, /* Ip6 Address. */
+ ns_t_loc = 29, /* Location Information. */
+ ns_t_nxt = 30, /* Next domain (security). */
+ ns_t_eid = 31, /* Endpoint identifier. */
+ ns_t_nimloc = 32, /* Nimrod Locator. */
+ ns_t_srv = 33, /* Server Selection. */
+ ns_t_atma = 34, /* ATM Address */
+ ns_t_naptr = 35, /* Naming Authority PoinTeR */
+ ns_t_kx = 36, /* Key Exchange */
+ ns_t_cert = 37, /* Certification record */
+ ns_t_a6 = 38, /* IPv6 address (deprecates AAAA) */
+ ns_t_dname = 39, /* Non-terminal DNAME (for IPv6) */
+ ns_t_sink = 40, /* Kitchen sink (experimental) */
+ ns_t_opt = 41, /* EDNS0 option (meta-RR) */
+ ns_t_apl = 42, /* Address prefix list (RFC3123) */
+ ns_t_ds = 43, /* Delegation Signer (RFC4034) */
+ ns_t_sshfp = 44, /* SSH Key Fingerprint (RFC4255) */
+ ns_t_rrsig = 46, /* Resource Record Signature (RFC4034) */
+ ns_t_nsec = 47, /* Next Secure (RFC4034) */
+ ns_t_dnskey = 48, /* DNS Public Key (RFC4034) */
+ ns_t_tkey = 249, /* Transaction key */
+ ns_t_tsig = 250, /* Transaction signature. */
+ ns_t_ixfr = 251, /* Incremental zone transfer. */
+ ns_t_axfr = 252, /* Transfer zone of authority. */
+ ns_t_mailb = 253, /* Transfer mailbox records. */
+ ns_t_maila = 254, /* Transfer mail agent records. */
+ ns_t_any = 255, /* Wildcard match. */
+ ns_t_uri = 256, /* Uniform Resource Identifier (RFC7553) */
+ ns_t_caa = 257, /* Certification Authority Authorization. */
+ ns_t_max = 65536
+} ns_type;
+
+typedef enum __ns_opcode {
+ ns_o_query = 0, /* Standard query. */
+ ns_o_iquery = 1, /* Inverse query (deprecated/unsupported). */
+ ns_o_status = 2, /* Name server status query (unsupported). */
+ /* Opcode 3 is undefined/reserved. */
+ ns_o_notify = 4, /* Zone change notification. */
+ ns_o_update = 5, /* Zone update message. */
+ ns_o_max = 6
+} ns_opcode;
+
+typedef enum __ns_rcode {
+ ns_r_noerror = 0, /* No error occurred. */
+ ns_r_formerr = 1, /* Format error. */
+ ns_r_servfail = 2, /* Server failure. */
+ ns_r_nxdomain = 3, /* Name error. */
+ ns_r_notimpl = 4, /* Unimplemented. */
+ ns_r_refused = 5, /* Operation refused. */
+ /* these are for BIND_UPDATE */
+ ns_r_yxdomain = 6, /* Name exists */
+ ns_r_yxrrset = 7, /* RRset exists */
+ ns_r_nxrrset = 8, /* RRset does not exist */
+ ns_r_notauth = 9, /* Not authoritative for zone */
+ ns_r_notzone = 10, /* Zone of record different from zone section */
+ ns_r_max = 11,
+ /* The following are TSIG extended errors */
+ ns_r_badsig = 16,
+ ns_r_badkey = 17,
+ ns_r_badtime = 18
+} ns_rcode;
+
+#endif /* CARES_HAVE_ARPA_NAMESER_H */
+
+
+/* ============================================================================
+ * arpa/nameser_compat.h typically sets these. However on some systems
+ * arpa/nameser.h does, but may not set all of them. Lets conditionally
+ * define each
+ * ============================================================================
+ */
+
+#ifndef PACKETSZ
+# define PACKETSZ NS_PACKETSZ
+#endif
+
+#ifndef MAXDNAME
+# define MAXDNAME NS_MAXDNAME
+#endif
+
+#ifndef MAXCDNAME
+# define MAXCDNAME NS_MAXCDNAME
+#endif
+
+#ifndef MAXLABEL
+# define MAXLABEL NS_MAXLABEL
+#endif
+
+#ifndef HFIXEDSZ
+# define HFIXEDSZ NS_HFIXEDSZ
+#endif
+
+#ifndef QFIXEDSZ
+# define QFIXEDSZ NS_QFIXEDSZ
+#endif
+
+#ifndef RRFIXEDSZ
+# define RRFIXEDSZ NS_RRFIXEDSZ
+#endif
+
+#ifndef INDIR_MASK
+# define INDIR_MASK NS_CMPRSFLGS
+#endif
+
+#ifndef NAMESERVER_PORT
+# define NAMESERVER_PORT NS_DEFAULTPORT
+#endif
+
+
+/* opcodes */
+#ifndef O_QUERY
+# define O_QUERY 0 /* ns_o_query */
+#endif
+#ifndef O_IQUERY
+# define O_IQUERY 1 /* ns_o_iquery */
+#endif
+#ifndef O_STATUS
+# define O_STATUS 2 /* ns_o_status */
+#endif
+#ifndef O_NOTIFY
+# define O_NOTIFY 4 /* ns_o_notify */
+#endif
+#ifndef O_UPDATE
+# define O_UPDATE 5 /* ns_o_update */
+#endif
+
+
+/* response codes */
+#ifndef SERVFAIL
+# define SERVFAIL ns_r_servfail
+#endif
+#ifndef NOTIMP
+# define NOTIMP ns_r_notimpl
+#endif
+#ifndef REFUSED
+# define REFUSED ns_r_refused
+#endif
+#if defined(_WIN32) && !defined(HAVE_ARPA_NAMESER_COMPAT_H) && defined(NOERROR)
+# undef NOERROR /* it seems this is already defined in winerror.h */
+#endif
+#ifndef NOERROR
+# define NOERROR ns_r_noerror
+#endif
+#ifndef FORMERR
+# define FORMERR ns_r_formerr
+#endif
+#ifndef NXDOMAIN
+# define NXDOMAIN ns_r_nxdomain
+#endif
+/* Non-standard response codes, use numeric values */
+#ifndef YXDOMAIN
+# define YXDOMAIN 6 /* ns_r_yxdomain */
+#endif
+#ifndef YXRRSET
+# define YXRRSET 7 /* ns_r_yxrrset */
+#endif
+#ifndef NXRRSET
+# define NXRRSET 8 /* ns_r_nxrrset */
+#endif
+#ifndef NOTAUTH
+# define NOTAUTH 9 /* ns_r_notauth */
+#endif
+#ifndef NOTZONE
+# define NOTZONE 10 /* ns_r_notzone */
+#endif
+#ifndef TSIG_BADSIG
+# define TSIG_BADSIG 16 /* ns_r_badsig */
+#endif
+#ifndef TSIG_BADKEY
+# define TSIG_BADKEY 17 /* ns_r_badkey */
+#endif
+#ifndef TSIG_BADTIME
+# define TSIG_BADTIME 18 /* ns_r_badtime */
+#endif
+
+
+/* classes */
+#ifndef C_IN
+# define C_IN 1 /* ns_c_in */
+#endif
+#ifndef C_CHAOS
+# define C_CHAOS 3 /* ns_c_chaos */
+#endif
+#ifndef C_HS
+# define C_HS 4 /* ns_c_hs */
+#endif
+#ifndef C_NONE
+# define C_NONE 254 /* ns_c_none */
+#endif
+#ifndef C_ANY
+# define C_ANY 255 /* ns_c_any */
+#endif
+
+
+/* types */
+#ifndef T_A
+# define T_A 1 /* ns_t_a */
+#endif
+#ifndef T_NS
+# define T_NS 2 /* ns_t_ns */
+#endif
+#ifndef T_MD
+# define T_MD 3 /* ns_t_md */
+#endif
+#ifndef T_MF
+# define T_MF 4 /* ns_t_mf */
+#endif
+#ifndef T_CNAME
+# define T_CNAME 5 /* ns_t_cname */
+#endif
+#ifndef T_SOA
+# define T_SOA 6 /* ns_t_soa */
+#endif
+#ifndef T_MB
+# define T_MB 7 /* ns_t_mb */
+#endif
+#ifndef T_MG
+# define T_MG 8 /* ns_t_mg */
+#endif
+#ifndef T_MR
+# define T_MR 9 /* ns_t_mr */
+#endif
+#ifndef T_NULL
+# define T_NULL 10 /* ns_t_null */
+#endif
+#ifndef T_WKS
+# define T_WKS 11 /* ns_t_wks */
+#endif
+#ifndef T_PTR
+# define T_PTR 12 /* ns_t_ptr */
+#endif
+#ifndef T_HINFO
+# define T_HINFO 13 /* ns_t_hinfo */
+#endif
+#ifndef T_MINFO
+# define T_MINFO 14 /* ns_t_minfo */
+#endif
+#ifndef T_MX
+# define T_MX 15 /* ns_t_mx */
+#endif
+#ifndef T_TXT
+# define T_TXT 16 /* ns_t_txt */
+#endif
+#ifndef T_RP
+# define T_RP 17 /* ns_t_rp */
+#endif
+#ifndef T_AFSDB
+# define T_AFSDB 18 /* ns_t_afsdb */
+#endif
+#ifndef T_X25
+# define T_X25 19 /* ns_t_x25 */
+#endif
+#ifndef T_ISDN
+# define T_ISDN 20 /* ns_t_isdn */
+#endif
+#ifndef T_RT
+# define T_RT 21 /* ns_t_rt */
+#endif
+#ifndef T_NSAP
+# define T_NSAP 22 /* ns_t_nsap */
+#endif
+#ifndef T_NSAP_PTR
+# define T_NSAP_PTR 23 /* ns_t_nsap_ptr */
+#endif
+#ifndef T_SIG
+# define T_SIG 24 /* ns_t_sig */
+#endif
+#ifndef T_KEY
+# define T_KEY 25 /* ns_t_key */
+#endif
+#ifndef T_PX
+# define T_PX 26 /* ns_t_px */
+#endif
+#ifndef T_GPOS
+# define T_GPOS 27 /* ns_t_gpos */
+#endif
+#ifndef T_AAAA
+# define T_AAAA 28 /* ns_t_aaaa */
+#endif
+#ifndef T_LOC
+# define T_LOC 29 /* ns_t_loc */
+#endif
+#ifndef T_NXT
+# define T_NXT 30 /* ns_t_nxt */
+#endif
+#ifndef T_EID
+# define T_EID 31 /* ns_t_eid */
+#endif
+#ifndef T_NIMLOC
+# define T_NIMLOC 32 /* ns_t_nimloc */
+#endif
+#ifndef T_SRV
+# define T_SRV 33 /* ns_t_srv */
+#endif
+#ifndef T_ATMA
+# define T_ATMA 34 /* ns_t_atma */
+#endif
+#ifndef T_NAPTR
+# define T_NAPTR 35 /* ns_t_naptr */
+#endif
+#ifndef T_KX
+# define T_KX 36 /* ns_t_kx */
+#endif
+#ifndef T_CERT
+# define T_CERT 37 /* ns_t_cert */
+#endif
+#ifndef T_A6
+# define T_A6 38 /* ns_t_a6 */
+#endif
+#ifndef T_DNAME
+# define T_DNAME 39 /* ns_t_dname */
+#endif
+#ifndef T_SINK
+# define T_SINK 40 /* ns_t_sink */
+#endif
+#ifndef T_OPT
+# define T_OPT 41 /* ns_t_opt */
+#endif
+#ifndef T_APL
+# define T_APL 42 /* ns_t_apl */
+#endif
+#ifndef T_DS
+# define T_DS 43 /* ns_t_ds */
+#endif
+#ifndef T_SSHFP
+# define T_SSHFP 44 /* ns_t_sshfp */
+#endif
+#ifndef T_RRSIG
+# define T_RRSIG 46 /* ns_t_rrsig */
+#endif
+#ifndef T_NSEC
+# define T_NSEC 47 /* ns_t_nsec */
+#endif
+#ifndef T_DNSKEY
+# define T_DNSKEY 48 /* ns_t_dnskey */
+#endif
+#ifndef T_TKEY
+# define T_TKEY 249 /* ns_t_tkey */
+#endif
+#ifndef T_TSIG
+# define T_TSIG 250 /* ns_t_tsig */
+#endif
+#ifndef T_IXFR
+# define T_IXFR 251 /* ns_t_ixfr */
+#endif
+#ifndef T_AXFR
+# define T_AXFR 252 /* ns_t_axfr */
+#endif
+#ifndef T_MAILB
+# define T_MAILB 253 /* ns_t_mailb */
+#endif
+#ifndef T_MAILA
+# define T_MAILA 254 /* ns_t_maila */
+#endif
+#ifndef T_ANY
+# define T_ANY 255 /* ns_t_any */
+#endif
+#ifndef T_URI
+# define T_URI 256 /* ns_t_uri */
+#endif
+#ifndef T_CAA
+# define T_CAA 257 /* ns_t_caa */
+#endif
+#ifndef T_MAX
+# define T_MAX 65536 /* ns_t_max */
+#endif
+
+
+#endif /* ARES_NAMESER_H */
diff --git a/subprojects/c-ares/include/ares_rules.h b/subprojects/c-ares/include/ares_rules.h
@@ -0,0 +1,133 @@
+/* MIT License
+ *
+ * Copyright (c) 2009 Daniel Stenberg
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice (including the next
+ * paragraph) shall be included in all copies or substantial portions of the
+ * Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ *
+ * SPDX-License-Identifier: MIT
+ */
+#ifndef __CARES_RULES_H
+#define __CARES_RULES_H
+
+/* ================================================================ */
+/* COMPILE TIME SANITY CHECKS */
+/* ================================================================ */
+
+/*
+ * NOTE 1:
+ * -------
+ *
+ * All checks done in this file are intentionally placed in a public
+ * header file which is pulled by ares.h when an application is
+ * being built using an already built c-ares library. Additionally
+ * this file is also included and used when building the library.
+ *
+ * If compilation fails on this file it is certainly sure that the
+ * problem is elsewhere. It could be a problem in the ares_build.h
+ * header file, or simply that you are using different compilation
+ * settings than those used to build the library.
+ *
+ * Nothing in this file is intended to be modified or adjusted by the
+ * c-ares library user nor by the c-ares library builder.
+ *
+ * Do not deactivate any check, these are done to make sure that the
+ * library is properly built and used.
+ *
+ * You can find further help on the c-ares development mailing list:
+ * http://lists.haxx.se/listinfo/c-ares/
+ *
+ * NOTE 2
+ * ------
+ *
+ * Some of the following compile time checks are based on the fact
+ * that the dimension of a constant array can not be a negative one.
+ * In this way if the compile time verification fails, the compilation
+ * will fail issuing an error. The error description wording is compiler
+ * dependent but it will be quite similar to one of the following:
+ *
+ * "negative subscript or subscript is too large"
+ * "array must have at least one element"
+ * "-1 is an illegal array size"
+ * "size of array is negative"
+ *
+ * If you are building an application which tries to use an already
+ * built c-ares library and you are getting this kind of errors on
+ * this file, it is a clear indication that there is a mismatch between
+ * how the library was built and how you are trying to use it for your
+ * application. Your already compiled or binary library provider is the
+ * only one who can give you the details you need to properly use it.
+ */
+
+/*
+ * Verify that some macros are actually defined.
+ */
+
+#ifndef CARES_TYPEOF_ARES_SOCKLEN_T
+# error "CARES_TYPEOF_ARES_SOCKLEN_T definition is missing!"
+Error Compilation_aborted_CARES_TYPEOF_ARES_SOCKLEN_T_is_missing
+#endif
+
+/*
+ * Macros private to this header file.
+ */
+
+#define CareschkszEQ(t, s) sizeof(t) == s ? 1 : -1
+
+#define CareschkszGE(t1, t2) sizeof(t1) >= sizeof(t2) ? 1 : -1
+
+ /*
+ * Verify that the size previously defined and expected for
+ * ares_socklen_t is actually the same as the one reported
+ * by sizeof() at compile time.
+ */
+
+ typedef char __cares_rule_02__[CareschkszEQ(
+ ares_socklen_t, sizeof(CARES_TYPEOF_ARES_SOCKLEN_T))];
+
+/*
+ * Verify at compile time that the size of ares_socklen_t as reported
+ * by sizeof() is greater or equal than the one reported for int for
+ * the current compilation.
+ */
+
+typedef char __cares_rule_03__[CareschkszGE(ares_socklen_t, int)];
+
+/* ================================================================ */
+/* EXTERNALLY AND INTERNALLY VISIBLE DEFINITIONS */
+/* ================================================================ */
+
+/*
+ * Get rid of macros private to this header file.
+ */
+
+#undef CareschkszEQ
+#undef CareschkszGE
+
+/*
+ * Get rid of macros not intended to exist beyond this point.
+ */
+
+#undef CARES_PULL_WS2TCPIP_H
+#undef CARES_PULL_SYS_TYPES_H
+#undef CARES_PULL_SYS_SOCKET_H
+
+#undef CARES_TYPEOF_ARES_SOCKLEN_T
+
+#endif /* __CARES_RULES_H */
diff --git a/subprojects/c-ares/include/ares_version.h b/subprojects/c-ares/include/ares_version.h
@@ -0,0 +1,49 @@
+/* MIT License
+ *
+ * Copyright (c) Daniel Stenberg
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice (including the next
+ * paragraph) shall be included in all copies or substantial portions of the
+ * Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ *
+ * SPDX-License-Identifier: MIT
+ */
+
+#ifndef ARES__VERSION_H
+#define ARES__VERSION_H
+
+/* This is the global package copyright */
+#define ARES_COPYRIGHT "2004 - 2024 Daniel Stenberg, <daniel@haxx.se>."
+
+#define ARES_VERSION_MAJOR 1
+#define ARES_VERSION_MINOR 25
+#define ARES_VERSION_PATCH 0
+#define ARES_VERSION \
+ ((ARES_VERSION_MAJOR << 16) | (ARES_VERSION_MINOR << 8) | \
+ (ARES_VERSION_PATCH))
+#define ARES_VERSION_STR "1.25.0"
+
+#if (ARES_VERSION >= 0x010700)
+# define CARES_HAVE_ARES_LIBRARY_INIT 1
+# define CARES_HAVE_ARES_LIBRARY_CLEANUP 1
+#else
+# undef CARES_HAVE_ARES_LIBRARY_INIT
+# undef CARES_HAVE_ARES_LIBRARY_CLEANUP
+#endif
+
+#endif
diff --git a/subprojects/c-ares/libcares.pc.cmake b/subprojects/c-ares/libcares.pc.cmake
@@ -0,0 +1,22 @@
+#***************************************************************************
+# Project ___ __ _ _ __ ___ ___
+# / __|____ / _` | '__/ _ \/ __|
+# | (_|_____| (_| | | | __/\__ \
+# \___| \__,_|_| \___||___/
+#
+# Copyright (C) The c-ares project and its contributors
+# SPDX-License-Identifier: MIT
+prefix=@CMAKE_INSTALL_PREFIX@
+exec_prefix=@CMAKE_INSTALL_FULL_BINDIR@
+libdir=@CMAKE_INSTALL_FULL_LIBDIR@
+includedir=@CMAKE_INSTALL_FULL_INCLUDEDIR@
+
+Name: c-ares
+URL: https://c-ares.org/
+Description: asynchronous DNS lookup library
+Version: @CARES_VERSION@
+Requires:
+Requires.private:
+Cflags: -I${includedir}
+Libs: -L${libdir} -lcares
+Libs.private: @CARES_PRIVATE_LIBS@
diff --git a/subprojects/c-ares/libcares.pc.in b/subprojects/c-ares/libcares.pc.in
@@ -0,0 +1,22 @@
+#***************************************************************************
+# Project ___ __ _ _ __ ___ ___
+# / __|____ / _` | '__/ _ \/ __|
+# | (_|_____| (_| | | | __/\__ \
+# \___| \__,_|_| \___||___/
+#
+# Copyright (C) The c-ares project and its contributors
+# SPDX-License-Identifier: MIT
+prefix=@prefix@
+exec_prefix=@exec_prefix@
+libdir=@libdir@
+includedir=@includedir@
+
+Name: c-ares
+URL: http://c-ares.org/
+Description: asynchronous DNS lookup library
+Version: @VERSION@
+Requires:
+Requires.private:
+Cflags: -I${includedir}
+Libs: -L${libdir} -lcares
+Libs.private: @CARES_PRIVATE_LIBS@
diff --git a/subprojects/c-ares/m4/.gitignore b/subprojects/c-ares/m4/.gitignore
@@ -0,0 +1,6 @@
+libtool.m4
+libtool.m4.tmp
+ltoptions.m4
+ltsugar.m4
+ltversion.m4
+lt~obsolete.m4
diff --git a/subprojects/c-ares/m4/ax_ac_append_to_file.m4 b/subprojects/c-ares/m4/ax_ac_append_to_file.m4
@@ -0,0 +1,32 @@
+# ===========================================================================
+# https://www.gnu.org/software/autoconf-archive/ax_ac_append_to_file.html
+# ===========================================================================
+#
+# SYNOPSIS
+#
+# AX_AC_APPEND_TO_FILE([FILE],[DATA])
+#
+# DESCRIPTION
+#
+# Appends the specified data to the specified Autoconf is run. If you want
+# to append to a file when configure is run use AX_APPEND_TO_FILE instead.
+#
+# LICENSE
+#
+# Copyright (c) 2009 Allan Caffee <allan.caffee@gmail.com>
+#
+# Copying and distribution of this file, with or without modification, are
+# permitted in any medium without royalty provided the copyright notice
+# and this notice are preserved. This file is offered as-is, without any
+# warranty.
+
+#serial 10
+
+AC_DEFUN([AX_AC_APPEND_TO_FILE],[
+AC_REQUIRE([AX_FILE_ESCAPES])
+m4_esyscmd(
+AX_FILE_ESCAPES
+[
+printf "%s" "$2" >> "$1"
+])
+])
diff --git a/subprojects/c-ares/m4/ax_ac_print_to_file.m4 b/subprojects/c-ares/m4/ax_ac_print_to_file.m4
@@ -0,0 +1,32 @@
+# ===========================================================================
+# https://www.gnu.org/software/autoconf-archive/ax_ac_print_to_file.html
+# ===========================================================================
+#
+# SYNOPSIS
+#
+# AX_AC_PRINT_TO_FILE([FILE],[DATA])
+#
+# DESCRIPTION
+#
+# Writes the specified data to the specified file when Autoconf is run. If
+# you want to print to a file when configure is run use AX_PRINT_TO_FILE
+# instead.
+#
+# LICENSE
+#
+# Copyright (c) 2009 Allan Caffee <allan.caffee@gmail.com>
+#
+# Copying and distribution of this file, with or without modification, are
+# permitted in any medium without royalty provided the copyright notice
+# and this notice are preserved. This file is offered as-is, without any
+# warranty.
+
+#serial 10
+
+AC_DEFUN([AX_AC_PRINT_TO_FILE],[
+m4_esyscmd(
+AC_REQUIRE([AX_FILE_ESCAPES])
+[
+printf "%s" "$2" > "$1"
+])
+])
diff --git a/subprojects/c-ares/m4/ax_add_am_macro_static.m4 b/subprojects/c-ares/m4/ax_add_am_macro_static.m4
@@ -0,0 +1,28 @@
+# ===========================================================================
+# https://www.gnu.org/software/autoconf-archive/ax_add_am_macro_static.html
+# ===========================================================================
+#
+# SYNOPSIS
+#
+# AX_ADD_AM_MACRO_STATIC([RULE])
+#
+# DESCRIPTION
+#
+# Adds the specified rule to $AMINCLUDE.
+#
+# LICENSE
+#
+# Copyright (c) 2009 Tom Howard <tomhoward@users.sf.net>
+# Copyright (c) 2009 Allan Caffee <allan.caffee@gmail.com>
+#
+# Copying and distribution of this file, with or without modification, are
+# permitted in any medium without royalty provided the copyright notice
+# and this notice are preserved. This file is offered as-is, without any
+# warranty.
+
+#serial 8
+
+AC_DEFUN([AX_ADD_AM_MACRO_STATIC],[
+ AC_REQUIRE([AX_AM_MACROS_STATIC])
+ AX_AC_APPEND_TO_FILE(AMINCLUDE_STATIC,[$1])
+])
diff --git a/subprojects/c-ares/m4/ax_am_macros_static.m4 b/subprojects/c-ares/m4/ax_am_macros_static.m4
@@ -0,0 +1,38 @@
+# ===========================================================================
+# https://www.gnu.org/software/autoconf-archive/ax_am_macros_static.html
+# ===========================================================================
+#
+# SYNOPSIS
+#
+# AX_AM_MACROS_STATIC
+#
+# DESCRIPTION
+#
+# Adds support for macros that create Automake rules. You must manually
+# add the following line
+#
+# include $(top_srcdir)/aminclude_static.am
+#
+# to your Makefile.am files.
+#
+# LICENSE
+#
+# Copyright (c) 2009 Tom Howard <tomhoward@users.sf.net>
+# Copyright (c) 2009 Allan Caffee <allan.caffee@gmail.com>
+#
+# Copying and distribution of this file, with or without modification, are
+# permitted in any medium without royalty provided the copyright notice
+# and this notice are preserved. This file is offered as-is, without any
+# warranty.
+
+#serial 11
+
+AC_DEFUN([AMINCLUDE_STATIC],[aminclude_static.am])
+
+AC_DEFUN([AX_AM_MACROS_STATIC],
+[
+AX_AC_PRINT_TO_FILE(AMINCLUDE_STATIC,[
+# ]AMINCLUDE_STATIC[ generated automatically by Autoconf
+# from AX_AM_MACROS_STATIC on ]m4_esyscmd([LC_ALL=C date])[
+])
+])
diff --git a/subprojects/c-ares/m4/ax_append_compile_flags.m4 b/subprojects/c-ares/m4/ax_append_compile_flags.m4
@@ -0,0 +1,65 @@
+# ===========================================================================
+# http://www.gnu.org/software/autoconf-archive/ax_append_compile_flags.html
+# ===========================================================================
+#
+# SYNOPSIS
+#
+# AX_APPEND_COMPILE_FLAGS([FLAG1 FLAG2 ...], [FLAGS-VARIABLE], [EXTRA-FLAGS])
+#
+# DESCRIPTION
+#
+# For every FLAG1, FLAG2 it is checked whether the compiler works with the
+# flag. If it does, the flag is added FLAGS-VARIABLE
+#
+# If FLAGS-VARIABLE is not specified, the current language's flags (e.g.
+# CFLAGS) is used. During the check the flag is always added to the
+# current language's flags.
+#
+# If EXTRA-FLAGS is defined, it is added to the current language's default
+# flags (e.g. CFLAGS) when the check is done. The check is thus made with
+# the flags: "CFLAGS EXTRA-FLAGS FLAG". This can for example be used to
+# force the compiler to issue an error when a bad flag is given.
+#
+# NOTE: This macro depends on the AX_APPEND_FLAG and
+# AX_CHECK_COMPILE_FLAG. Please keep this macro in sync with
+# AX_APPEND_LINK_FLAGS.
+#
+# LICENSE
+#
+# Copyright (c) 2011 Maarten Bosmans <mkbosmans@gmail.com>
+#
+# This program is free software: you can redistribute it and/or modify it
+# under the terms of the GNU General Public License as published by the
+# Free Software Foundation, either version 3 of the License, or (at your
+# option) any later version.
+#
+# This program is distributed in the hope that it will be useful, but
+# WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General
+# Public License for more details.
+#
+# You should have received a copy of the GNU General Public License along
+# with this program. If not, see <http://www.gnu.org/licenses/>.
+#
+# As a special exception, the respective Autoconf Macro's copyright owner
+# gives unlimited permission to copy, distribute and modify the configure
+# scripts that are the output of Autoconf when processing the Macro. You
+# need not follow the terms of the GNU General Public License when using
+# or distributing such scripts, even though portions of the text of the
+# Macro appear in them. The GNU General Public License (GPL) does govern
+# all other use of the material that constitutes the Autoconf Macro.
+#
+# This special exception to the GPL applies to versions of the Autoconf
+# Macro released by the Autoconf Archive. When you make and distribute a
+# modified version of the Autoconf Macro, you may extend this special
+# exception to the GPL to apply to your modified version as well.
+
+#serial 3
+
+AC_DEFUN([AX_APPEND_COMPILE_FLAGS],
+[AC_REQUIRE([AX_CHECK_COMPILE_FLAG])
+AC_REQUIRE([AX_APPEND_FLAG])
+for flag in $1; do
+ AX_CHECK_COMPILE_FLAG([$flag], [AX_APPEND_FLAG([$flag], [$2])], [], [$3])
+done
+])dnl AX_APPEND_COMPILE_FLAGS
diff --git a/subprojects/c-ares/m4/ax_append_flag.m4 b/subprojects/c-ares/m4/ax_append_flag.m4
@@ -0,0 +1,69 @@
+# ===========================================================================
+# http://www.gnu.org/software/autoconf-archive/ax_append_flag.html
+# ===========================================================================
+#
+# SYNOPSIS
+#
+# AX_APPEND_FLAG(FLAG, [FLAGS-VARIABLE])
+#
+# DESCRIPTION
+#
+# FLAG is appended to the FLAGS-VARIABLE shell variable, with a space
+# added in between.
+#
+# If FLAGS-VARIABLE is not specified, the current language's flags (e.g.
+# CFLAGS) is used. FLAGS-VARIABLE is not changed if it already contains
+# FLAG. If FLAGS-VARIABLE is unset in the shell, it is set to exactly
+# FLAG.
+#
+# NOTE: Implementation based on AX_CFLAGS_GCC_OPTION.
+#
+# LICENSE
+#
+# Copyright (c) 2008 Guido U. Draheim <guidod@gmx.de>
+# Copyright (c) 2011 Maarten Bosmans <mkbosmans@gmail.com>
+#
+# This program is free software: you can redistribute it and/or modify it
+# under the terms of the GNU General Public License as published by the
+# Free Software Foundation, either version 3 of the License, or (at your
+# option) any later version.
+#
+# This program is distributed in the hope that it will be useful, but
+# WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General
+# Public License for more details.
+#
+# You should have received a copy of the GNU General Public License along
+# with this program. If not, see <http://www.gnu.org/licenses/>.
+#
+# As a special exception, the respective Autoconf Macro's copyright owner
+# gives unlimited permission to copy, distribute and modify the configure
+# scripts that are the output of Autoconf when processing the Macro. You
+# need not follow the terms of the GNU General Public License when using
+# or distributing such scripts, even though portions of the text of the
+# Macro appear in them. The GNU General Public License (GPL) does govern
+# all other use of the material that constitutes the Autoconf Macro.
+#
+# This special exception to the GPL applies to versions of the Autoconf
+# Macro released by the Autoconf Archive. When you make and distribute a
+# modified version of the Autoconf Macro, you may extend this special
+# exception to the GPL to apply to your modified version as well.
+
+#serial 2
+
+AC_DEFUN([AX_APPEND_FLAG],
+[AC_PREREQ(2.59)dnl for _AC_LANG_PREFIX
+AS_VAR_PUSHDEF([FLAGS], [m4_default($2,_AC_LANG_PREFIX[FLAGS])])dnl
+AS_VAR_SET_IF(FLAGS,
+ [case " AS_VAR_GET(FLAGS) " in
+ *" $1 "*)
+ AC_RUN_LOG([: FLAGS already contains $1])
+ ;;
+ *)
+ AC_RUN_LOG([: FLAGS="$FLAGS $1"])
+ AS_VAR_SET(FLAGS, ["AS_VAR_GET(FLAGS) $1"])
+ ;;
+ esac],
+ [AS_VAR_SET(FLAGS,["$1"])])
+AS_VAR_POPDEF([FLAGS])dnl
+])dnl AX_APPEND_FLAG
diff --git a/subprojects/c-ares/m4/ax_append_link_flags.m4 b/subprojects/c-ares/m4/ax_append_link_flags.m4
@@ -0,0 +1,44 @@
+# ===========================================================================
+# https://www.gnu.org/software/autoconf-archive/ax_append_link_flags.html
+# ===========================================================================
+#
+# SYNOPSIS
+#
+# AX_APPEND_LINK_FLAGS([FLAG1 FLAG2 ...], [FLAGS-VARIABLE], [EXTRA-FLAGS], [INPUT])
+#
+# DESCRIPTION
+#
+# For every FLAG1, FLAG2 it is checked whether the linker works with the
+# flag. If it does, the flag is added FLAGS-VARIABLE
+#
+# If FLAGS-VARIABLE is not specified, the linker's flags (LDFLAGS) is
+# used. During the check the flag is always added to the linker's flags.
+#
+# If EXTRA-FLAGS is defined, it is added to the linker's default flags
+# when the check is done. The check is thus made with the flags: "LDFLAGS
+# EXTRA-FLAGS FLAG". This can for example be used to force the linker to
+# issue an error when a bad flag is given.
+#
+# INPUT gives an alternative input source to AC_COMPILE_IFELSE.
+#
+# NOTE: This macro depends on the AX_APPEND_FLAG and AX_CHECK_LINK_FLAG.
+# Please keep this macro in sync with AX_APPEND_COMPILE_FLAGS.
+#
+# LICENSE
+#
+# Copyright (c) 2011 Maarten Bosmans <mkbosmans@gmail.com>
+#
+# Copying and distribution of this file, with or without modification, are
+# permitted in any medium without royalty provided the copyright notice
+# and this notice are preserved. This file is offered as-is, without any
+# warranty.
+
+#serial 7
+
+AC_DEFUN([AX_APPEND_LINK_FLAGS],
+[AX_REQUIRE_DEFINED([AX_CHECK_LINK_FLAG])
+AX_REQUIRE_DEFINED([AX_APPEND_FLAG])
+for flag in $1; do
+ AX_CHECK_LINK_FLAG([$flag], [AX_APPEND_FLAG([$flag], [m4_default([$2], [LDFLAGS])])], [], [$3], [$4])
+done
+])dnl AX_APPEND_LINK_FLAGS
diff --git a/subprojects/c-ares/m4/ax_check_compile_flag.m4 b/subprojects/c-ares/m4/ax_check_compile_flag.m4
@@ -0,0 +1,72 @@
+# ===========================================================================
+# http://www.gnu.org/software/autoconf-archive/ax_check_compile_flag.html
+# ===========================================================================
+#
+# SYNOPSIS
+#
+# AX_CHECK_COMPILE_FLAG(FLAG, [ACTION-SUCCESS], [ACTION-FAILURE], [EXTRA-FLAGS])
+#
+# DESCRIPTION
+#
+# Check whether the given FLAG works with the current language's compiler
+# or gives an error. (Warnings, however, are ignored)
+#
+# ACTION-SUCCESS/ACTION-FAILURE are shell commands to execute on
+# success/failure.
+#
+# If EXTRA-FLAGS is defined, it is added to the current language's default
+# flags (e.g. CFLAGS) when the check is done. The check is thus made with
+# the flags: "CFLAGS EXTRA-FLAGS FLAG". This can for example be used to
+# force the compiler to issue an error when a bad flag is given.
+#
+# NOTE: Implementation based on AX_CFLAGS_GCC_OPTION. Please keep this
+# macro in sync with AX_CHECK_{PREPROC,LINK}_FLAG.
+#
+# LICENSE
+#
+# Copyright (c) 2008 Guido U. Draheim <guidod@gmx.de>
+# Copyright (c) 2011 Maarten Bosmans <mkbosmans@gmail.com>
+#
+# This program is free software: you can redistribute it and/or modify it
+# under the terms of the GNU General Public License as published by the
+# Free Software Foundation, either version 3 of the License, or (at your
+# option) any later version.
+#
+# This program is distributed in the hope that it will be useful, but
+# WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General
+# Public License for more details.
+#
+# You should have received a copy of the GNU General Public License along
+# with this program. If not, see <http://www.gnu.org/licenses/>.
+#
+# As a special exception, the respective Autoconf Macro's copyright owner
+# gives unlimited permission to copy, distribute and modify the configure
+# scripts that are the output of Autoconf when processing the Macro. You
+# need not follow the terms of the GNU General Public License when using
+# or distributing such scripts, even though portions of the text of the
+# Macro appear in them. The GNU General Public License (GPL) does govern
+# all other use of the material that constitutes the Autoconf Macro.
+#
+# This special exception to the GPL applies to versions of the Autoconf
+# Macro released by the Autoconf Archive. When you make and distribute a
+# modified version of the Autoconf Macro, you may extend this special
+# exception to the GPL to apply to your modified version as well.
+
+#serial 2
+
+AC_DEFUN([AX_CHECK_COMPILE_FLAG],
+[AC_PREREQ(2.59)dnl for _AC_LANG_PREFIX
+AS_VAR_PUSHDEF([CACHEVAR],[ax_cv_check_[]_AC_LANG_ABBREV[]flags_$4_$1])dnl
+AC_CACHE_CHECK([whether _AC_LANG compiler accepts $1], CACHEVAR, [
+ ax_check_save_flags=$[]_AC_LANG_PREFIX[]FLAGS
+ _AC_LANG_PREFIX[]FLAGS="$[]_AC_LANG_PREFIX[]FLAGS $4 $1"
+ AC_COMPILE_IFELSE([AC_LANG_PROGRAM()],
+ [AS_VAR_SET(CACHEVAR,[yes])],
+ [AS_VAR_SET(CACHEVAR,[no])])
+ _AC_LANG_PREFIX[]FLAGS=$ax_check_save_flags])
+AS_IF([test x"AS_VAR_GET(CACHEVAR)" = xyes],
+ [m4_default([$2], :)],
+ [m4_default([$3], :)])
+AS_VAR_POPDEF([CACHEVAR])dnl
+])dnl AX_CHECK_COMPILE_FLAGS
diff --git a/subprojects/c-ares/m4/ax_check_gnu_make.m4 b/subprojects/c-ares/m4/ax_check_gnu_make.m4
@@ -0,0 +1,95 @@
+# ===========================================================================
+# https://www.gnu.org/software/autoconf-archive/ax_check_gnu_make.html
+# ===========================================================================
+#
+# SYNOPSIS
+#
+# AX_CHECK_GNU_MAKE([run-if-true],[run-if-false])
+#
+# DESCRIPTION
+#
+# This macro searches for a GNU version of make. If a match is found:
+#
+# * The makefile variable `ifGNUmake' is set to the empty string, otherwise
+# it is set to "#". This is useful for including a special features in a
+# Makefile, which cannot be handled by other versions of make.
+# * The makefile variable `ifnGNUmake' is set to #, otherwise
+# it is set to the empty string. This is useful for including a special
+# features in a Makefile, which can be handled
+# by other versions of make or to specify else like clause.
+# * The variable `_cv_gnu_make_command` is set to the command to invoke
+# GNU make if it exists, the empty string otherwise.
+# * The variable `ax_cv_gnu_make_command` is set to the command to invoke
+# GNU make by copying `_cv_gnu_make_command`, otherwise it is unset.
+# * If GNU Make is found, its version is extracted from the output of
+# `make --version` as the last field of a record of space-separated
+# columns and saved into the variable `ax_check_gnu_make_version`.
+# * Additionally if GNU Make is found, run shell code run-if-true
+# else run shell code run-if-false.
+#
+# Here is an example of its use:
+#
+# Makefile.in might contain:
+#
+# # A failsafe way of putting a dependency rule into a makefile
+# $(DEPEND):
+# $(CC) -MM $(srcdir)/*.c > $(DEPEND)
+#
+# @ifGNUmake@ ifeq ($(DEPEND),$(wildcard $(DEPEND)))
+# @ifGNUmake@ include $(DEPEND)
+# @ifGNUmake@ else
+# fallback code
+# @ifGNUmake@ endif
+#
+# Then configure.in would normally contain:
+#
+# AX_CHECK_GNU_MAKE()
+# AC_OUTPUT(Makefile)
+#
+# Then perhaps to cause gnu make to override any other make, we could do
+# something like this (note that GNU make always looks for GNUmakefile
+# first):
+#
+# if ! test x$_cv_gnu_make_command = x ; then
+# mv Makefile GNUmakefile
+# echo .DEFAULT: > Makefile ;
+# echo \ $_cv_gnu_make_command \$@ >> Makefile;
+# fi
+#
+# Then, if any (well almost any) other make is called, and GNU make also
+# exists, then the other make wraps the GNU make.
+#
+# LICENSE
+#
+# Copyright (c) 2008 John Darrington <j.darrington@elvis.murdoch.edu.au>
+# Copyright (c) 2015 Enrico M. Crisostomo <enrico.m.crisostomo@gmail.com>
+#
+# Copying and distribution of this file, with or without modification, are
+# permitted in any medium without royalty provided the copyright notice
+# and this notice are preserved. This file is offered as-is, without any
+# warranty.
+
+#serial 12
+
+AC_DEFUN([AX_CHECK_GNU_MAKE],dnl
+ [AC_PROG_AWK
+ AC_CACHE_CHECK([for GNU make],[_cv_gnu_make_command],[dnl
+ _cv_gnu_make_command="" ;
+dnl Search all the common names for GNU make
+ for a in "$MAKE" make gmake gnumake ; do
+ if test -z "$a" ; then continue ; fi ;
+ if "$a" --version 2> /dev/null | grep GNU 2>&1 > /dev/null ; then
+ _cv_gnu_make_command=$a ;
+ AX_CHECK_GNU_MAKE_HEADLINE=$("$a" --version 2> /dev/null | grep "GNU Make")
+ ax_check_gnu_make_version=$(echo ${AX_CHECK_GNU_MAKE_HEADLINE} | ${AWK} -F " " '{ print $(NF); }')
+ break ;
+ fi
+ done ;])
+dnl If there was a GNU version, then set @ifGNUmake@ to the empty string, '#' otherwise
+ AS_VAR_IF([_cv_gnu_make_command], [""], [AS_VAR_SET([ifGNUmake], ["#"])], [AS_VAR_SET([ifGNUmake], [""])])
+ AS_VAR_IF([_cv_gnu_make_command], [""], [AS_VAR_SET([ifnGNUmake], [""])], [AS_VAR_SET([ifnGNUmake], ["#"])])
+ AS_VAR_IF([_cv_gnu_make_command], [""], [AS_UNSET(ax_cv_gnu_make_command)], [AS_VAR_SET([ax_cv_gnu_make_command], [${_cv_gnu_make_command}])])
+ AS_VAR_IF([_cv_gnu_make_command], [""],[$2],[$1])
+ AC_SUBST([ifGNUmake])
+ AC_SUBST([ifnGNUmake])
+])
diff --git a/subprojects/c-ares/m4/ax_check_link_flag.m4 b/subprojects/c-ares/m4/ax_check_link_flag.m4
@@ -0,0 +1,53 @@
+# ===========================================================================
+# https://www.gnu.org/software/autoconf-archive/ax_check_link_flag.html
+# ===========================================================================
+#
+# SYNOPSIS
+#
+# AX_CHECK_LINK_FLAG(FLAG, [ACTION-SUCCESS], [ACTION-FAILURE], [EXTRA-FLAGS], [INPUT])
+#
+# DESCRIPTION
+#
+# Check whether the given FLAG works with the linker or gives an error.
+# (Warnings, however, are ignored)
+#
+# ACTION-SUCCESS/ACTION-FAILURE are shell commands to execute on
+# success/failure.
+#
+# If EXTRA-FLAGS is defined, it is added to the linker's default flags
+# when the check is done. The check is thus made with the flags: "LDFLAGS
+# EXTRA-FLAGS FLAG". This can for example be used to force the linker to
+# issue an error when a bad flag is given.
+#
+# INPUT gives an alternative input source to AC_LINK_IFELSE.
+#
+# NOTE: Implementation based on AX_CFLAGS_GCC_OPTION. Please keep this
+# macro in sync with AX_CHECK_{PREPROC,COMPILE}_FLAG.
+#
+# LICENSE
+#
+# Copyright (c) 2008 Guido U. Draheim <guidod@gmx.de>
+# Copyright (c) 2011 Maarten Bosmans <mkbosmans@gmail.com>
+#
+# Copying and distribution of this file, with or without modification, are
+# permitted in any medium without royalty provided the copyright notice
+# and this notice are preserved. This file is offered as-is, without any
+# warranty.
+
+#serial 6
+
+AC_DEFUN([AX_CHECK_LINK_FLAG],
+[AC_PREREQ(2.64)dnl for _AC_LANG_PREFIX and AS_VAR_IF
+AS_VAR_PUSHDEF([CACHEVAR],[ax_cv_check_ldflags_$4_$1])dnl
+AC_CACHE_CHECK([whether the linker accepts $1], CACHEVAR, [
+ ax_check_save_flags=$LDFLAGS
+ LDFLAGS="$LDFLAGS $4 $1"
+ AC_LINK_IFELSE([m4_default([$5],[AC_LANG_PROGRAM()])],
+ [AS_VAR_SET(CACHEVAR,[yes])],
+ [AS_VAR_SET(CACHEVAR,[no])])
+ LDFLAGS=$ax_check_save_flags])
+AS_VAR_IF(CACHEVAR,yes,
+ [m4_default([$2], :)],
+ [m4_default([$3], :)])
+AS_VAR_POPDEF([CACHEVAR])dnl
+])dnl AX_CHECK_LINK_FLAGS
diff --git a/subprojects/c-ares/m4/ax_check_user_namespace.m4 b/subprojects/c-ares/m4/ax_check_user_namespace.m4
@@ -0,0 +1,57 @@
+# -*- Autoconf -*-
+
+# SYNOPSIS
+#
+# AX_CHECK_USER_NAMESPACE
+#
+# DESCRIPTION
+#
+# This macro checks whether the local system supports Linux user namespaces.
+# If so, it calls AC_DEFINE(HAVE_USER_NAMESPACE).
+#
+# Copyright (C) The c-ares team
+# SPDX-License-Identifier: MIT
+
+AC_DEFUN([AX_CHECK_USER_NAMESPACE],[dnl
+ AC_CACHE_CHECK([whether user namespaces are supported],
+ ax_cv_user_namespace,[
+ AC_LANG_PUSH([C])
+ AC_RUN_IFELSE([AC_LANG_SOURCE([[
+#define _GNU_SOURCE
+#include <fcntl.h>
+#include <sched.h>
+#include <signal.h>
+#include <stdio.h>
+#include <string.h>
+#include <sys/types.h>
+#include <sys/wait.h>
+
+int userfn(void *d) {
+ usleep(100000); /* synchronize by sleep */
+ return (getuid() != 0);
+}
+char userst[1024*1024];
+int main() {
+ char buffer[1024];
+ int rc, status, fd;
+ pid_t child = clone(userfn, userst + 1024*1024, CLONE_NEWUSER|SIGCHLD, 0);
+ if (child < 0) return 1;
+
+ snprintf(buffer, sizeof(buffer), "/proc/%d/uid_map", child);
+ fd = open(buffer, O_CREAT|O_WRONLY|O_TRUNC, 0755);
+ snprintf(buffer, sizeof(buffer), "0 %d 1\n", getuid());
+ write(fd, buffer, strlen(buffer));
+ close(fd);
+
+ rc = waitpid(child, &status, 0);
+ if (rc <= 0) return 1;
+ if (!WIFEXITED(status)) return 1;
+ return WEXITSTATUS(status);
+}
+ ]])],[ax_cv_user_namespace=yes],[ax_cv_user_namespace=no],[ax_cv_user_namespace=no])
+ AC_LANG_POP([C])
+ ])
+ if test "$ax_cv_user_namespace" = yes; then
+ AC_DEFINE([HAVE_USER_NAMESPACE],[1],[Whether user namespaces are available])
+ fi
+]) # AX_CHECK_USER_NAMESPACE
diff --git a/subprojects/c-ares/m4/ax_check_uts_namespace.m4 b/subprojects/c-ares/m4/ax_check_uts_namespace.m4
@@ -0,0 +1,79 @@
+# -*- Autoconf -*-
+
+# SYNOPSIS
+#
+# AX_CHECK_UTS_NAMESPACE
+#
+# DESCRIPTION
+#
+# This macro checks whether the local system supports Linux UTS namespaces.
+# Also requires user namespaces to be available, so that non-root users
+# can enter the namespace.
+# If so, it calls AC_DEFINE(HAVE_UTS_NAMESPACE).
+#
+# Copyright (C) The c-ares team
+# SPDX-License-Identifier: MIT
+
+AC_DEFUN([AX_CHECK_UTS_NAMESPACE],[dnl
+ AC_CACHE_CHECK([whether UTS namespaces are supported],
+ ax_cv_uts_namespace,[
+ AC_LANG_PUSH([C])
+ AC_RUN_IFELSE([AC_LANG_SOURCE([[
+#define _GNU_SOURCE
+#include <sched.h>
+#include <signal.h>
+#include <stdio.h>
+#include <string.h>
+#include <fcntl.h>
+#include <unistd.h>
+#include <sys/types.h>
+#include <sys/wait.h>
+
+int utsfn(void *d) {
+ char buffer[1024];
+ const char *name = "autoconftest";
+ int rc = sethostname(name, strlen(name));
+ if (rc != 0) return 1;
+ gethostname(buffer, 1024);
+ return (strcmp(buffer, name) != 0);
+}
+
+char st2[1024*1024];
+int fn(void *d) {
+ pid_t child;
+ int rc, status;
+ usleep(100000); /* synchronize by sleep */
+ if (getuid() != 0) return 1;
+ child = clone(utsfn, st2 + 1024*1024, CLONE_NEWUTS|SIGCHLD, 0);
+ if (child < 0) return 1;
+ rc = waitpid(child, &status, 0);
+ if (rc <= 0) return 1;
+ if (!WIFEXITED(status)) return 1;
+ return WEXITSTATUS(status);
+}
+char st[1024*1024];
+int main() {
+ char buffer[1024];
+ int rc, status, fd;
+ pid_t child = clone(fn, st + 1024*1024, CLONE_NEWUSER|SIGCHLD, 0);
+ if (child < 0) return 1;
+
+ snprintf(buffer, sizeof(buffer), "/proc/%d/uid_map", child);
+ fd = open(buffer, O_CREAT|O_WRONLY|O_TRUNC, 0755);
+ snprintf(buffer, sizeof(buffer), "0 %d 1\n", getuid());
+ write(fd, buffer, strlen(buffer));
+ close(fd);
+
+ rc = waitpid(child, &status, 0);
+ if (rc <= 0) return 1;
+ if (!WIFEXITED(status)) return 1;
+ return WEXITSTATUS(status);
+}
+]])
+ ],[ax_cv_uts_namespace=yes],[ax_cv_uts_namespace=no],[ax_cv_uts_namespace=no])
+ AC_LANG_POP([C])
+ ])
+ if test "$ax_cv_uts_namespace" = yes; then
+ AC_DEFINE([HAVE_UTS_NAMESPACE],[1],[Whether UTS namespaces are available])
+ fi
+]) # AX_CHECK_UTS_NAMESPACE
diff --git a/subprojects/c-ares/m4/ax_code_coverage.m4 b/subprojects/c-ares/m4/ax_code_coverage.m4
@@ -0,0 +1,272 @@
+# ===========================================================================
+# https://www.gnu.org/software/autoconf-archive/ax_code_coverage.html
+# ===========================================================================
+#
+# SYNOPSIS
+#
+# AX_CODE_COVERAGE()
+#
+# DESCRIPTION
+#
+# Defines CODE_COVERAGE_CPPFLAGS, CODE_COVERAGE_CFLAGS,
+# CODE_COVERAGE_CXXFLAGS and CODE_COVERAGE_LIBS which should be included
+# in the CPPFLAGS, CFLAGS CXXFLAGS and LIBS/LIBADD variables of every
+# build target (program or library) which should be built with code
+# coverage support. Also add rules using AX_ADD_AM_MACRO_STATIC; and
+# $enable_code_coverage which can be used in subsequent configure output.
+# CODE_COVERAGE_ENABLED is defined and substituted, and corresponds to the
+# value of the --enable-code-coverage option, which defaults to being
+# disabled.
+#
+# Test also for gcov program and create GCOV variable that could be
+# substituted.
+#
+# Note that all optimization flags in CFLAGS must be disabled when code
+# coverage is enabled.
+#
+# Usage example:
+#
+# configure.ac:
+#
+# AX_CODE_COVERAGE
+#
+# Makefile.am:
+#
+# include $(top_srcdir)/aminclude_static.am
+#
+# my_program_LIBS = ... $(CODE_COVERAGE_LIBS) ...
+# my_program_CPPFLAGS = ... $(CODE_COVERAGE_CPPFLAGS) ...
+# my_program_CFLAGS = ... $(CODE_COVERAGE_CFLAGS) ...
+# my_program_CXXFLAGS = ... $(CODE_COVERAGE_CXXFLAGS) ...
+#
+# clean-local: code-coverage-clean
+# distclean-local: code-coverage-dist-clean
+#
+# This results in a "check-code-coverage" rule being added to any
+# Makefile.am which do "include $(top_srcdir)/aminclude_static.am"
+# (assuming the module has been configured with --enable-code-coverage).
+# Running `make check-code-coverage` in that directory will run the
+# module's test suite (`make check`) and build a code coverage report
+# detailing the code which was touched, then print the URI for the report.
+#
+# This code was derived from Makefile.decl in GLib, originally licensed
+# under LGPLv2.1+.
+#
+# LICENSE
+#
+# Copyright (c) 2012, 2016 Philip Withnall
+# Copyright (c) 2012 Xan Lopez
+# Copyright (c) 2012 Christian Persch
+# Copyright (c) 2012 Paolo Borelli
+# Copyright (c) 2012 Dan Winship
+# Copyright (c) 2015,2018 Bastien ROUCARIES
+#
+# This library is free software; you can redistribute it and/or modify it
+# under the terms of the GNU Lesser General Public License as published by
+# the Free Software Foundation; either version 2.1 of the License, or (at
+# your option) any later version.
+#
+# This library is distributed in the hope that it will be useful, but
+# WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Lesser
+# General Public License for more details.
+#
+# You should have received a copy of the GNU Lesser General Public License
+# along with this program. If not, see <https://www.gnu.org/licenses/>.
+
+#serial 34
+
+m4_define(_AX_CODE_COVERAGE_RULES,[
+AX_ADD_AM_MACRO_STATIC([
+# Code coverage
+#
+# Optional:
+# - CODE_COVERAGE_DIRECTORY: Top-level directory for code coverage reporting.
+# Multiple directories may be specified, separated by whitespace.
+# (Default: \$(top_builddir))
+# - CODE_COVERAGE_OUTPUT_FILE: Filename and path for the .info file generated
+# by lcov for code coverage. (Default:
+# \$(PACKAGE_NAME)-\$(PACKAGE_VERSION)-coverage.info)
+# - CODE_COVERAGE_OUTPUT_DIRECTORY: Directory for generated code coverage
+# reports to be created. (Default:
+# \$(PACKAGE_NAME)-\$(PACKAGE_VERSION)-coverage)
+# - CODE_COVERAGE_BRANCH_COVERAGE: Set to 1 to enforce branch coverage,
+# set to 0 to disable it and leave empty to stay with the default.
+# (Default: empty)
+# - CODE_COVERAGE_LCOV_SHOPTS_DEFAULT: Extra options shared between both lcov
+# instances. (Default: based on $CODE_COVERAGE_BRANCH_COVERAGE)
+# - CODE_COVERAGE_LCOV_SHOPTS: Extra options to shared between both lcov
+# instances. (Default: $CODE_COVERAGE_LCOV_SHOPTS_DEFAULT)
+# - CODE_COVERAGE_LCOV_OPTIONS_GCOVPATH: --gcov-tool pathtogcov
+# - CODE_COVERAGE_LCOV_OPTIONS_DEFAULT: Extra options to pass to the
+# collecting lcov instance. (Default: $CODE_COVERAGE_LCOV_OPTIONS_GCOVPATH)
+# - CODE_COVERAGE_LCOV_OPTIONS: Extra options to pass to the collecting lcov
+# instance. (Default: $CODE_COVERAGE_LCOV_OPTIONS_DEFAULT)
+# - CODE_COVERAGE_LCOV_RMOPTS_DEFAULT: Extra options to pass to the filtering
+# lcov instance. (Default: empty)
+# - CODE_COVERAGE_LCOV_RMOPTS: Extra options to pass to the filtering lcov
+# instance. (Default: $CODE_COVERAGE_LCOV_RMOPTS_DEFAULT)
+# - CODE_COVERAGE_GENHTML_OPTIONS_DEFAULT: Extra options to pass to the
+# genhtml instance. (Default: based on $CODE_COVERAGE_BRANCH_COVERAGE)
+# - CODE_COVERAGE_GENHTML_OPTIONS: Extra options to pass to the genhtml
+# instance. (Default: $CODE_COVERAGE_GENHTML_OPTIONS_DEFAULT)
+# - CODE_COVERAGE_IGNORE_PATTERN: Extra glob pattern of files to ignore
+#
+# The generated report will be titled using the \$(PACKAGE_NAME) and
+# \$(PACKAGE_VERSION). In order to add the current git hash to the title,
+# use the git-version-gen script, available online.
+# Optional variables
+# run only on top dir
+if CODE_COVERAGE_ENABLED
+ ifeq (\$(abs_builddir), \$(abs_top_builddir))
+CODE_COVERAGE_DIRECTORY ?= \$(top_builddir)
+CODE_COVERAGE_OUTPUT_FILE ?= \$(PACKAGE_NAME)-\$(PACKAGE_VERSION)-coverage.info
+CODE_COVERAGE_OUTPUT_DIRECTORY ?= \$(PACKAGE_NAME)-\$(PACKAGE_VERSION)-coverage
+
+CODE_COVERAGE_BRANCH_COVERAGE ?=
+CODE_COVERAGE_LCOV_SHOPTS_DEFAULT ?= \$(if \$(CODE_COVERAGE_BRANCH_COVERAGE),\
+--rc lcov_branch_coverage=\$(CODE_COVERAGE_BRANCH_COVERAGE))
+CODE_COVERAGE_LCOV_SHOPTS ?= \$(CODE_COVERAGE_LCOV_SHOPTS_DEFAULT)
+CODE_COVERAGE_LCOV_OPTIONS_GCOVPATH ?= --gcov-tool \"\$(GCOV)\"
+CODE_COVERAGE_LCOV_OPTIONS_DEFAULT ?= \$(CODE_COVERAGE_LCOV_OPTIONS_GCOVPATH)
+CODE_COVERAGE_LCOV_OPTIONS ?= \$(CODE_COVERAGE_LCOV_OPTIONS_DEFAULT)
+CODE_COVERAGE_LCOV_RMOPTS_DEFAULT ?=
+CODE_COVERAGE_LCOV_RMOPTS ?= \$(CODE_COVERAGE_LCOV_RMOPTS_DEFAULT)
+CODE_COVERAGE_GENHTML_OPTIONS_DEFAULT ?=\
+\$(if \$(CODE_COVERAGE_BRANCH_COVERAGE),\
+--rc genhtml_branch_coverage=\$(CODE_COVERAGE_BRANCH_COVERAGE))
+CODE_COVERAGE_GENHTML_OPTIONS ?= \$(CODE_COVERAGE_GENHTML_OPTIONS_DEFAULT)
+CODE_COVERAGE_IGNORE_PATTERN ?=
+
+GITIGNOREFILES := \$(GITIGNOREFILES) \$(CODE_COVERAGE_OUTPUT_FILE) \$(CODE_COVERAGE_OUTPUT_DIRECTORY)
+code_coverage_v_lcov_cap = \$(code_coverage_v_lcov_cap_\$(V))
+code_coverage_v_lcov_cap_ = \$(code_coverage_v_lcov_cap_\$(AM_DEFAULT_VERBOSITY))
+code_coverage_v_lcov_cap_0 = @echo \" LCOV --capture\" \$(CODE_COVERAGE_OUTPUT_FILE);
+code_coverage_v_lcov_ign = \$(code_coverage_v_lcov_ign_\$(V))
+code_coverage_v_lcov_ign_ = \$(code_coverage_v_lcov_ign_\$(AM_DEFAULT_VERBOSITY))
+code_coverage_v_lcov_ign_0 = @echo \" LCOV --remove /tmp/*\" \$(CODE_COVERAGE_IGNORE_PATTERN);
+code_coverage_v_genhtml = \$(code_coverage_v_genhtml_\$(V))
+code_coverage_v_genhtml_ = \$(code_coverage_v_genhtml_\$(AM_DEFAULT_VERBOSITY))
+code_coverage_v_genhtml_0 = @echo \" GEN \" \"\$(CODE_COVERAGE_OUTPUT_DIRECTORY)\";
+code_coverage_quiet = \$(code_coverage_quiet_\$(V))
+code_coverage_quiet_ = \$(code_coverage_quiet_\$(AM_DEFAULT_VERBOSITY))
+code_coverage_quiet_0 = --quiet
+
+# sanitizes the test-name: replaces with underscores: dashes and dots
+code_coverage_sanitize = \$(subst -,_,\$(subst .,_,\$(1)))
+
+# Use recursive makes in order to ignore errors during check
+check-code-coverage:
+ -\$(AM_V_at)\$(MAKE) \$(AM_MAKEFLAGS) -k check
+ \$(AM_V_at)\$(MAKE) \$(AM_MAKEFLAGS) code-coverage-capture
+
+# Capture code coverage data
+code-coverage-capture: code-coverage-capture-hook
+ \$(code_coverage_v_lcov_cap)\$(LCOV) \$(code_coverage_quiet) \$(addprefix --directory ,\$(CODE_COVERAGE_DIRECTORY)) --capture --output-file \"\$(CODE_COVERAGE_OUTPUT_FILE).tmp\" --test-name \"\$(call code_coverage_sanitize,\$(PACKAGE_NAME)-\$(PACKAGE_VERSION))\" --no-checksum --compat-libtool \$(CODE_COVERAGE_LCOV_SHOPTS) \$(CODE_COVERAGE_LCOV_OPTIONS)
+ \$(code_coverage_v_lcov_ign)\$(LCOV) \$(code_coverage_quiet) \$(addprefix --directory ,\$(CODE_COVERAGE_DIRECTORY)) --remove \"\$(CODE_COVERAGE_OUTPUT_FILE).tmp\" \"/tmp/*\" \$(CODE_COVERAGE_IGNORE_PATTERN) --output-file \"\$(CODE_COVERAGE_OUTPUT_FILE)\" \$(CODE_COVERAGE_LCOV_SHOPTS) \$(CODE_COVERAGE_LCOV_RMOPTS)
+ -@rm -f \"\$(CODE_COVERAGE_OUTPUT_FILE).tmp\"
+ \$(code_coverage_v_genhtml)LANG=C \$(GENHTML) \$(code_coverage_quiet) \$(addprefix --prefix ,\$(CODE_COVERAGE_DIRECTORY)) --output-directory \"\$(CODE_COVERAGE_OUTPUT_DIRECTORY)\" --title \"\$(PACKAGE_NAME)-\$(PACKAGE_VERSION) Code Coverage\" --legend --show-details \"\$(CODE_COVERAGE_OUTPUT_FILE)\" \$(CODE_COVERAGE_GENHTML_OPTIONS)
+ @echo \"file://\$(abs_builddir)/\$(CODE_COVERAGE_OUTPUT_DIRECTORY)/index.html\"
+
+code-coverage-clean:
+ -\$(LCOV) --directory \$(top_builddir) -z
+ -rm -rf \"\$(CODE_COVERAGE_OUTPUT_FILE)\" \"\$(CODE_COVERAGE_OUTPUT_FILE).tmp\" \"\$(CODE_COVERAGE_OUTPUT_DIRECTORY)\"
+ -find . \\( -name \"*.gcda\" -o -name \"*.gcno\" -o -name \"*.gcov\" \\) -delete
+
+code-coverage-dist-clean:
+
+A][M_DISTCHECK_CONFIGURE_FLAGS := \$(A][M_DISTCHECK_CONFIGURE_FLAGS) --disable-code-coverage
+ else # ifneq (\$(abs_builddir), \$(abs_top_builddir))
+check-code-coverage:
+
+code-coverage-capture: code-coverage-capture-hook
+
+code-coverage-clean:
+
+code-coverage-dist-clean:
+ endif # ifeq (\$(abs_builddir), \$(abs_top_builddir))
+else #! CODE_COVERAGE_ENABLED
+# Use recursive makes in order to ignore errors during check
+check-code-coverage:
+ @echo \"Need to reconfigure with --enable-code-coverage\"
+# Capture code coverage data
+code-coverage-capture: code-coverage-capture-hook
+ @echo \"Need to reconfigure with --enable-code-coverage\"
+
+code-coverage-clean:
+
+code-coverage-dist-clean:
+
+endif #CODE_COVERAGE_ENABLED
+# Hook rule executed before code-coverage-capture, overridable by the user
+code-coverage-capture-hook:
+
+.PHONY: check-code-coverage code-coverage-capture code-coverage-dist-clean code-coverage-clean code-coverage-capture-hook
+])
+])
+
+AC_DEFUN([_AX_CODE_COVERAGE_ENABLED],[
+ AX_CHECK_GNU_MAKE([],AC_MSG_ERROR([not using GNU make that is needed for coverage]))
+ AC_REQUIRE([AX_ADD_AM_MACRO_STATIC])
+ # check for gcov
+ AC_CHECK_TOOL([GCOV],
+ [$_AX_CODE_COVERAGE_GCOV_PROG_WITH],
+ [:])
+ AS_IF([test "X$GCOV" = "X:"],
+ AC_MSG_ERROR([gcov is needed to do coverage]))
+ AC_SUBST([GCOV])
+
+ dnl Check if gcc is being used
+ AS_IF([ test "$GCC" = "no" ], [
+ AC_MSG_ERROR([not compiling with gcc, which is required for gcov code coverage])
+ ])
+
+ AC_CHECK_PROG([LCOV], [lcov], [lcov])
+ AC_CHECK_PROG([GENHTML], [genhtml], [genhtml])
+
+ AS_IF([ test x"$LCOV" = x ], [
+ AC_MSG_ERROR([To enable code coverage reporting you must have lcov installed])
+ ])
+
+ AS_IF([ test x"$GENHTML" = x ], [
+ AC_MSG_ERROR([Could not find genhtml from the lcov package])
+ ])
+
+ dnl Build the code coverage flags
+ dnl Define CODE_COVERAGE_LDFLAGS for backwards compatibility
+ CODE_COVERAGE_CPPFLAGS="-DNDEBUG"
+ CODE_COVERAGE_CFLAGS="-O0 -g -fprofile-arcs -ftest-coverage"
+ CODE_COVERAGE_CXXFLAGS="-O0 -g -fprofile-arcs -ftest-coverage"
+ CODE_COVERAGE_LIBS="-lgcov"
+
+ AC_SUBST([CODE_COVERAGE_CPPFLAGS])
+ AC_SUBST([CODE_COVERAGE_CFLAGS])
+ AC_SUBST([CODE_COVERAGE_CXXFLAGS])
+ AC_SUBST([CODE_COVERAGE_LIBS])
+])
+
+AC_DEFUN([AX_CODE_COVERAGE],[
+ dnl Check for --enable-code-coverage
+
+ # allow to override gcov location
+ AC_ARG_WITH([gcov],
+ [AS_HELP_STRING([--with-gcov[=GCOV]], [use given GCOV for coverage (GCOV=gcov).])],
+ [_AX_CODE_COVERAGE_GCOV_PROG_WITH=$with_gcov],
+ [_AX_CODE_COVERAGE_GCOV_PROG_WITH=gcov])
+
+ AC_MSG_CHECKING([whether to build with code coverage support])
+ AC_ARG_ENABLE([code-coverage],
+ AS_HELP_STRING([--enable-code-coverage],
+ [Whether to enable code coverage support]),,
+ enable_code_coverage=no)
+
+ AM_CONDITIONAL([CODE_COVERAGE_ENABLED], [test "x$enable_code_coverage" = xyes])
+ AC_SUBST([CODE_COVERAGE_ENABLED], [$enable_code_coverage])
+ AC_MSG_RESULT($enable_code_coverage)
+
+ AS_IF([ test "x$enable_code_coverage" = xyes ], [
+ _AX_CODE_COVERAGE_ENABLED
+ ])
+
+ _AX_CODE_COVERAGE_RULES
+])
diff --git a/subprojects/c-ares/m4/ax_compiler_vendor.m4 b/subprojects/c-ares/m4/ax_compiler_vendor.m4
@@ -0,0 +1,119 @@
+# ===========================================================================
+# https://www.gnu.org/software/autoconf-archive/ax_compiler_vendor.html
+# ===========================================================================
+#
+# SYNOPSIS
+#
+# AX_COMPILER_VENDOR
+#
+# DESCRIPTION
+#
+# Determine the vendor of the C, C++ or Fortran compiler. The vendor is
+# returned in the cache variable $ax_cv_c_compiler_vendor for C,
+# $ax_cv_cxx_compiler_vendor for C++ or $ax_cv_fc_compiler_vendor for
+# (modern) Fortran. The value is one of "intel", "ibm", "pathscale",
+# "clang" (LLVM), "cray", "fujitsu", "sdcc", "sx", "nvhpc" (NVIDIA HPC
+# Compiler), "portland" (PGI), "gnu" (GCC), "sun" (Oracle Developer
+# Studio), "hp", "dec", "borland", "comeau", "kai", "lcc", "sgi",
+# "microsoft", "metrowerks", "watcom", "tcc" (Tiny CC) or "unknown" (if
+# the compiler cannot be determined).
+#
+# To check for a Fortran compiler, you must first call AC_FC_PP_SRCEXT
+# with an appropriate preprocessor-enabled extension. For example:
+#
+# AC_LANG_PUSH([Fortran])
+# AC_PROG_FC
+# AC_FC_PP_SRCEXT([F])
+# AX_COMPILER_VENDOR
+# AC_LANG_POP([Fortran])
+#
+# LICENSE
+#
+# Copyright (c) 2008 Steven G. Johnson <stevenj@alum.mit.edu>
+# Copyright (c) 2008 Matteo Frigo
+# Copyright (c) 2018-19 John Zaitseff <J.Zaitseff@zap.org.au>
+#
+# This program is free software: you can redistribute it and/or modify it
+# under the terms of the GNU General Public License as published by the
+# Free Software Foundation, either version 3 of the License, or (at your
+# option) any later version.
+#
+# This program is distributed in the hope that it will be useful, but
+# WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General
+# Public License for more details.
+#
+# You should have received a copy of the GNU General Public License along
+# with this program. If not, see <https://www.gnu.org/licenses/>.
+#
+# As a special exception, the respective Autoconf Macro's copyright owner
+# gives unlimited permission to copy, distribute and modify the configure
+# scripts that are the output of Autoconf when processing the Macro. You
+# need not follow the terms of the GNU General Public License when using
+# or distributing such scripts, even though portions of the text of the
+# Macro appear in them. The GNU General Public License (GPL) does govern
+# all other use of the material that constitutes the Autoconf Macro.
+#
+# This special exception to the GPL applies to versions of the Autoconf
+# Macro released by the Autoconf Archive. When you make and distribute a
+# modified version of the Autoconf Macro, you may extend this special
+# exception to the GPL to apply to your modified version as well.
+
+#serial 32
+
+AC_DEFUN([AX_COMPILER_VENDOR], [dnl
+ AC_CACHE_CHECK([for _AC_LANG compiler vendor], ax_cv_[]_AC_LANG_ABBREV[]_compiler_vendor, [dnl
+ dnl If you modify this list of vendors, please add similar support
+ dnl to ax_compiler_version.m4 if at all possible.
+ dnl
+ dnl Note: Do NOT check for GCC first since some other compilers
+ dnl define __GNUC__ to remain compatible with it. Compilers that
+ dnl are very slow to start (such as Intel) are listed first.
+
+ vendors="
+ intel: __ICC,__ECC,__INTEL_COMPILER
+ ibm: __xlc__,__xlC__,__IBMC__,__IBMCPP__,__ibmxl__
+ pathscale: __PATHCC__,__PATHSCALE__
+ clang: __clang__
+ cray: _CRAYC
+ fujitsu: __FUJITSU
+ sdcc: SDCC,__SDCC
+ sx: _SX
+ nvhpc: __NVCOMPILER
+ portland: __PGI
+ gnu: __GNUC__
+ sun: __SUNPRO_C,__SUNPRO_CC,__SUNPRO_F90,__SUNPRO_F95
+ hp: __HP_cc,__HP_aCC
+ dec: __DECC,__DECCXX,__DECC_VER,__DECCXX_VER
+ borland: __BORLANDC__,__CODEGEARC__,__TURBOC__
+ comeau: __COMO__
+ kai: __KCC
+ lcc: __LCC__
+ sgi: __sgi,sgi
+ microsoft: _MSC_VER
+ metrowerks: __MWERKS__
+ watcom: __WATCOMC__
+ tcc: __TINYC__
+ unknown: UNKNOWN
+ "
+ for ventest in $vendors; do
+ case $ventest in
+ *:)
+ vendor=$ventest
+ continue
+ ;;
+ *)
+ vencpp="defined("`echo $ventest | sed 's/,/) || defined(/g'`")"
+ ;;
+ esac
+
+ AC_COMPILE_IFELSE([AC_LANG_PROGRAM([], [[
+#if !($vencpp)
+ thisisanerror;
+#endif
+ ]])], [break])
+ done
+
+ ax_cv_[]_AC_LANG_ABBREV[]_compiler_vendor=`echo $vendor | cut -d: -f1`
+ ])
+])dnl
diff --git a/subprojects/c-ares/m4/ax_cxx_compile_stdcxx.m4 b/subprojects/c-ares/m4/ax_cxx_compile_stdcxx.m4
@@ -0,0 +1,1018 @@
+# ===========================================================================
+# https://www.gnu.org/software/autoconf-archive/ax_cxx_compile_stdcxx.html
+# ===========================================================================
+#
+# SYNOPSIS
+#
+# AX_CXX_COMPILE_STDCXX(VERSION, [ext|noext], [mandatory|optional])
+#
+# DESCRIPTION
+#
+# Check for baseline language coverage in the compiler for the specified
+# version of the C++ standard. If necessary, add switches to CXX and
+# CXXCPP to enable support. VERSION may be '11', '14', '17', or '20' for
+# the respective C++ standard version.
+#
+# The second argument, if specified, indicates whether you insist on an
+# extended mode (e.g. -std=gnu++11) or a strict conformance mode (e.g.
+# -std=c++11). If neither is specified, you get whatever works, with
+# preference for no added switch, and then for an extended mode.
+#
+# The third argument, if specified 'mandatory' or if left unspecified,
+# indicates that baseline support for the specified C++ standard is
+# required and that the macro should error out if no mode with that
+# support is found. If specified 'optional', then configuration proceeds
+# regardless, after defining HAVE_CXX${VERSION} if and only if a
+# supporting mode is found.
+#
+# LICENSE
+#
+# Copyright (c) 2008 Benjamin Kosnik <bkoz@redhat.com>
+# Copyright (c) 2012 Zack Weinberg <zackw@panix.com>
+# Copyright (c) 2013 Roy Stogner <roystgnr@ices.utexas.edu>
+# Copyright (c) 2014, 2015 Google Inc.; contributed by Alexey Sokolov <sokolov@google.com>
+# Copyright (c) 2015 Paul Norman <penorman@mac.com>
+# Copyright (c) 2015 Moritz Klammler <moritz@klammler.eu>
+# Copyright (c) 2016, 2018 Krzesimir Nowak <qdlacz@gmail.com>
+# Copyright (c) 2019 Enji Cooper <yaneurabeya@gmail.com>
+# Copyright (c) 2020 Jason Merrill <jason@redhat.com>
+# Copyright (c) 2021 Jörn Heusipp <osmanx@problemloesungsmaschine.de>
+#
+# Copying and distribution of this file, with or without modification, are
+# permitted in any medium without royalty provided the copyright notice
+# and this notice are preserved. This file is offered as-is, without any
+# warranty.
+
+#serial 18
+
+dnl This macro is based on the code from the AX_CXX_COMPILE_STDCXX_11 macro
+dnl (serial version number 13).
+
+AC_DEFUN([AX_CXX_COMPILE_STDCXX], [dnl
+ m4_if([$1], [11], [ax_cxx_compile_alternatives="11 0x"],
+ [$1], [14], [ax_cxx_compile_alternatives="14 1y"],
+ [$1], [17], [ax_cxx_compile_alternatives="17 1z"],
+ [$1], [20], [ax_cxx_compile_alternatives="20"],
+ [m4_fatal([invalid first argument `$1' to AX_CXX_COMPILE_STDCXX])])dnl
+ m4_if([$2], [], [],
+ [$2], [ext], [],
+ [$2], [noext], [],
+ [m4_fatal([invalid second argument `$2' to AX_CXX_COMPILE_STDCXX])])dnl
+ m4_if([$3], [], [ax_cxx_compile_cxx$1_required=true],
+ [$3], [mandatory], [ax_cxx_compile_cxx$1_required=true],
+ [$3], [optional], [ax_cxx_compile_cxx$1_required=false],
+ [m4_fatal([invalid third argument `$3' to AX_CXX_COMPILE_STDCXX])])
+ AC_LANG_PUSH([C++])dnl
+ ac_success=no
+
+ m4_if([$2], [], [dnl
+ AC_CACHE_CHECK(whether $CXX supports C++$1 features by default,
+ ax_cv_cxx_compile_cxx$1,
+ [AC_COMPILE_IFELSE([AC_LANG_SOURCE([_AX_CXX_COMPILE_STDCXX_testbody_$1])],
+ [ax_cv_cxx_compile_cxx$1=yes],
+ [ax_cv_cxx_compile_cxx$1=no])])
+ if test x$ax_cv_cxx_compile_cxx$1 = xyes; then
+ ac_success=yes
+ fi])
+
+ m4_if([$2], [noext], [], [dnl
+ if test x$ac_success = xno; then
+ for alternative in ${ax_cxx_compile_alternatives}; do
+ switch="-std=gnu++${alternative}"
+ cachevar=AS_TR_SH([ax_cv_cxx_compile_cxx$1_$switch])
+ AC_CACHE_CHECK(whether $CXX supports C++$1 features with $switch,
+ $cachevar,
+ [ac_save_CXX="$CXX"
+ CXX="$CXX $switch"
+ AC_COMPILE_IFELSE([AC_LANG_SOURCE([_AX_CXX_COMPILE_STDCXX_testbody_$1])],
+ [eval $cachevar=yes],
+ [eval $cachevar=no])
+ CXX="$ac_save_CXX"])
+ if eval test x\$$cachevar = xyes; then
+ CXX="$CXX $switch"
+ if test -n "$CXXCPP" ; then
+ CXXCPP="$CXXCPP $switch"
+ fi
+ ac_success=yes
+ break
+ fi
+ done
+ fi])
+
+ m4_if([$2], [ext], [], [dnl
+ if test x$ac_success = xno; then
+ dnl HP's aCC needs +std=c++11 according to:
+ dnl http://h21007.www2.hp.com/portal/download/files/unprot/aCxx/PDF_Release_Notes/769149-001.pdf
+ dnl Cray's crayCC needs "-h std=c++11"
+ dnl MSVC needs -std:c++NN for C++17 and later (default is C++14)
+ for alternative in ${ax_cxx_compile_alternatives}; do
+ for switch in -std=c++${alternative} +std=c++${alternative} "-h std=c++${alternative}" MSVC; do
+ if test x"$switch" = xMSVC; then
+ dnl AS_TR_SH maps both `:` and `=` to `_` so -std:c++17 would collide
+ dnl with -std=c++17. We suffix the cache variable name with _MSVC to
+ dnl avoid this.
+ switch=-std:c++${alternative}
+ cachevar=AS_TR_SH([ax_cv_cxx_compile_cxx$1_${switch}_MSVC])
+ else
+ cachevar=AS_TR_SH([ax_cv_cxx_compile_cxx$1_$switch])
+ fi
+ AC_CACHE_CHECK(whether $CXX supports C++$1 features with $switch,
+ $cachevar,
+ [ac_save_CXX="$CXX"
+ CXX="$CXX $switch"
+ AC_COMPILE_IFELSE([AC_LANG_SOURCE([_AX_CXX_COMPILE_STDCXX_testbody_$1])],
+ [eval $cachevar=yes],
+ [eval $cachevar=no])
+ CXX="$ac_save_CXX"])
+ if eval test x\$$cachevar = xyes; then
+ CXX="$CXX $switch"
+ if test -n "$CXXCPP" ; then
+ CXXCPP="$CXXCPP $switch"
+ fi
+ ac_success=yes
+ break
+ fi
+ done
+ if test x$ac_success = xyes; then
+ break
+ fi
+ done
+ fi])
+ AC_LANG_POP([C++])
+ if test x$ax_cxx_compile_cxx$1_required = xtrue; then
+ if test x$ac_success = xno; then
+ AC_MSG_ERROR([*** A compiler with support for C++$1 language features is required.])
+ fi
+ fi
+ if test x$ac_success = xno; then
+ HAVE_CXX$1=0
+ AC_MSG_NOTICE([No compiler with C++$1 support was found])
+ else
+ HAVE_CXX$1=1
+ AC_DEFINE(HAVE_CXX$1,1,
+ [define if the compiler supports basic C++$1 syntax])
+ fi
+ AC_SUBST(HAVE_CXX$1)
+])
+
+
+dnl Test body for checking C++11 support
+
+m4_define([_AX_CXX_COMPILE_STDCXX_testbody_11],
+ _AX_CXX_COMPILE_STDCXX_testbody_new_in_11
+)
+
+dnl Test body for checking C++14 support
+
+m4_define([_AX_CXX_COMPILE_STDCXX_testbody_14],
+ _AX_CXX_COMPILE_STDCXX_testbody_new_in_11
+ _AX_CXX_COMPILE_STDCXX_testbody_new_in_14
+)
+
+dnl Test body for checking C++17 support
+
+m4_define([_AX_CXX_COMPILE_STDCXX_testbody_17],
+ _AX_CXX_COMPILE_STDCXX_testbody_new_in_11
+ _AX_CXX_COMPILE_STDCXX_testbody_new_in_14
+ _AX_CXX_COMPILE_STDCXX_testbody_new_in_17
+)
+
+dnl Test body for checking C++20 support
+
+m4_define([_AX_CXX_COMPILE_STDCXX_testbody_20],
+ _AX_CXX_COMPILE_STDCXX_testbody_new_in_11
+ _AX_CXX_COMPILE_STDCXX_testbody_new_in_14
+ _AX_CXX_COMPILE_STDCXX_testbody_new_in_17
+ _AX_CXX_COMPILE_STDCXX_testbody_new_in_20
+)
+
+
+dnl Tests for new features in C++11
+
+m4_define([_AX_CXX_COMPILE_STDCXX_testbody_new_in_11], [[
+
+// If the compiler admits that it is not ready for C++11, why torture it?
+// Hopefully, this will speed up the test.
+
+#ifndef __cplusplus
+
+#error "This is not a C++ compiler"
+
+// MSVC always sets __cplusplus to 199711L in older versions; newer versions
+// only set it correctly if /Zc:__cplusplus is specified as well as a
+// /std:c++NN switch:
+// https://devblogs.microsoft.com/cppblog/msvc-now-correctly-reports-__cplusplus/
+#elif __cplusplus < 201103L && !defined _MSC_VER
+
+#error "This is not a C++11 compiler"
+
+#else
+
+namespace cxx11
+{
+
+ namespace test_static_assert
+ {
+
+ template <typename T>
+ struct check
+ {
+ static_assert(sizeof(int) <= sizeof(T), "not big enough");
+ };
+
+ }
+
+ namespace test_final_override
+ {
+
+ struct Base
+ {
+ virtual ~Base() {}
+ virtual void f() {}
+ };
+
+ struct Derived : public Base
+ {
+ virtual ~Derived() override {}
+ virtual void f() override {}
+ };
+
+ }
+
+ namespace test_double_right_angle_brackets
+ {
+
+ template < typename T >
+ struct check {};
+
+ typedef check<void> single_type;
+ typedef check<check<void>> double_type;
+ typedef check<check<check<void>>> triple_type;
+ typedef check<check<check<check<void>>>> quadruple_type;
+
+ }
+
+ namespace test_decltype
+ {
+
+ int
+ f()
+ {
+ int a = 1;
+ decltype(a) b = 2;
+ return a + b;
+ }
+
+ }
+
+ namespace test_type_deduction
+ {
+
+ template < typename T1, typename T2 >
+ struct is_same
+ {
+ static const bool value = false;
+ };
+
+ template < typename T >
+ struct is_same<T, T>
+ {
+ static const bool value = true;
+ };
+
+ template < typename T1, typename T2 >
+ auto
+ add(T1 a1, T2 a2) -> decltype(a1 + a2)
+ {
+ return a1 + a2;
+ }
+
+ int
+ test(const int c, volatile int v)
+ {
+ static_assert(is_same<int, decltype(0)>::value == true, "");
+ static_assert(is_same<int, decltype(c)>::value == false, "");
+ static_assert(is_same<int, decltype(v)>::value == false, "");
+ auto ac = c;
+ auto av = v;
+ auto sumi = ac + av + 'x';
+ auto sumf = ac + av + 1.0;
+ static_assert(is_same<int, decltype(ac)>::value == true, "");
+ static_assert(is_same<int, decltype(av)>::value == true, "");
+ static_assert(is_same<int, decltype(sumi)>::value == true, "");
+ static_assert(is_same<int, decltype(sumf)>::value == false, "");
+ static_assert(is_same<int, decltype(add(c, v))>::value == true, "");
+ return (sumf > 0.0) ? sumi : add(c, v);
+ }
+
+ }
+
+ namespace test_noexcept
+ {
+
+ int f() { return 0; }
+ int g() noexcept { return 0; }
+
+ static_assert(noexcept(f()) == false, "");
+ static_assert(noexcept(g()) == true, "");
+
+ }
+
+ namespace test_constexpr
+ {
+
+ template < typename CharT >
+ unsigned long constexpr
+ strlen_c_r(const CharT *const s, const unsigned long acc) noexcept
+ {
+ return *s ? strlen_c_r(s + 1, acc + 1) : acc;
+ }
+
+ template < typename CharT >
+ unsigned long constexpr
+ strlen_c(const CharT *const s) noexcept
+ {
+ return strlen_c_r(s, 0UL);
+ }
+
+ static_assert(strlen_c("") == 0UL, "");
+ static_assert(strlen_c("1") == 1UL, "");
+ static_assert(strlen_c("example") == 7UL, "");
+ static_assert(strlen_c("another\0example") == 7UL, "");
+
+ }
+
+ namespace test_rvalue_references
+ {
+
+ template < int N >
+ struct answer
+ {
+ static constexpr int value = N;
+ };
+
+ answer<1> f(int&) { return answer<1>(); }
+ answer<2> f(const int&) { return answer<2>(); }
+ answer<3> f(int&&) { return answer<3>(); }
+
+ void
+ test()
+ {
+ int i = 0;
+ const int c = 0;
+ static_assert(decltype(f(i))::value == 1, "");
+ static_assert(decltype(f(c))::value == 2, "");
+ static_assert(decltype(f(0))::value == 3, "");
+ }
+
+ }
+
+ namespace test_uniform_initialization
+ {
+
+ struct test
+ {
+ static const int zero {};
+ static const int one {1};
+ };
+
+ static_assert(test::zero == 0, "");
+ static_assert(test::one == 1, "");
+
+ }
+
+ namespace test_lambdas
+ {
+
+ void
+ test1()
+ {
+ auto lambda1 = [](){};
+ auto lambda2 = lambda1;
+ lambda1();
+ lambda2();
+ }
+
+ int
+ test2()
+ {
+ auto a = [](int i, int j){ return i + j; }(1, 2);
+ auto b = []() -> int { return '0'; }();
+ auto c = [=](){ return a + b; }();
+ auto d = [&](){ return c; }();
+ auto e = [a, &b](int x) mutable {
+ const auto identity = [](int y){ return y; };
+ for (auto i = 0; i < a; ++i)
+ a += b--;
+ return x + identity(a + b);
+ }(0);
+ return a + b + c + d + e;
+ }
+
+ int
+ test3()
+ {
+ const auto nullary = [](){ return 0; };
+ const auto unary = [](int x){ return x; };
+ using nullary_t = decltype(nullary);
+ using unary_t = decltype(unary);
+ const auto higher1st = [](nullary_t f){ return f(); };
+ const auto higher2nd = [unary](nullary_t f1){
+ return [unary, f1](unary_t f2){ return f2(unary(f1())); };
+ };
+ return higher1st(nullary) + higher2nd(nullary)(unary);
+ }
+
+ }
+
+ namespace test_variadic_templates
+ {
+
+ template <int...>
+ struct sum;
+
+ template <int N0, int... N1toN>
+ struct sum<N0, N1toN...>
+ {
+ static constexpr auto value = N0 + sum<N1toN...>::value;
+ };
+
+ template <>
+ struct sum<>
+ {
+ static constexpr auto value = 0;
+ };
+
+ static_assert(sum<>::value == 0, "");
+ static_assert(sum<1>::value == 1, "");
+ static_assert(sum<23>::value == 23, "");
+ static_assert(sum<1, 2>::value == 3, "");
+ static_assert(sum<5, 5, 11>::value == 21, "");
+ static_assert(sum<2, 3, 5, 7, 11, 13>::value == 41, "");
+
+ }
+
+ // http://stackoverflow.com/questions/13728184/template-aliases-and-sfinae
+ // Clang 3.1 fails with headers of libstd++ 4.8.3 when using std::function
+ // because of this.
+ namespace test_template_alias_sfinae
+ {
+
+ struct foo {};
+
+ template<typename T>
+ using member = typename T::member_type;
+
+ template<typename T>
+ void func(...) {}
+
+ template<typename T>
+ void func(member<T>*) {}
+
+ void test();
+
+ void test() { func<foo>(0); }
+
+ }
+
+} // namespace cxx11
+
+#endif // __cplusplus >= 201103L
+
+]])
+
+
+dnl Tests for new features in C++14
+
+m4_define([_AX_CXX_COMPILE_STDCXX_testbody_new_in_14], [[
+
+// If the compiler admits that it is not ready for C++14, why torture it?
+// Hopefully, this will speed up the test.
+
+#ifndef __cplusplus
+
+#error "This is not a C++ compiler"
+
+#elif __cplusplus < 201402L && !defined _MSC_VER
+
+#error "This is not a C++14 compiler"
+
+#else
+
+namespace cxx14
+{
+
+ namespace test_polymorphic_lambdas
+ {
+
+ int
+ test()
+ {
+ const auto lambda = [](auto&&... args){
+ const auto istiny = [](auto x){
+ return (sizeof(x) == 1UL) ? 1 : 0;
+ };
+ const int aretiny[] = { istiny(args)... };
+ return aretiny[0];
+ };
+ return lambda(1, 1L, 1.0f, '1');
+ }
+
+ }
+
+ namespace test_binary_literals
+ {
+
+ constexpr auto ivii = 0b0000000000101010;
+ static_assert(ivii == 42, "wrong value");
+
+ }
+
+ namespace test_generalized_constexpr
+ {
+
+ template < typename CharT >
+ constexpr unsigned long
+ strlen_c(const CharT *const s) noexcept
+ {
+ auto length = 0UL;
+ for (auto p = s; *p; ++p)
+ ++length;
+ return length;
+ }
+
+ static_assert(strlen_c("") == 0UL, "");
+ static_assert(strlen_c("x") == 1UL, "");
+ static_assert(strlen_c("test") == 4UL, "");
+ static_assert(strlen_c("another\0test") == 7UL, "");
+
+ }
+
+ namespace test_lambda_init_capture
+ {
+
+ int
+ test()
+ {
+ auto x = 0;
+ const auto lambda1 = [a = x](int b){ return a + b; };
+ const auto lambda2 = [a = lambda1(x)](){ return a; };
+ return lambda2();
+ }
+
+ }
+
+ namespace test_digit_separators
+ {
+
+ constexpr auto ten_million = 100'000'000;
+ static_assert(ten_million == 100000000, "");
+
+ }
+
+ namespace test_return_type_deduction
+ {
+
+ auto f(int& x) { return x; }
+ decltype(auto) g(int& x) { return x; }
+
+ template < typename T1, typename T2 >
+ struct is_same
+ {
+ static constexpr auto value = false;
+ };
+
+ template < typename T >
+ struct is_same<T, T>
+ {
+ static constexpr auto value = true;
+ };
+
+ int
+ test()
+ {
+ auto x = 0;
+ static_assert(is_same<int, decltype(f(x))>::value, "");
+ static_assert(is_same<int&, decltype(g(x))>::value, "");
+ return x;
+ }
+
+ }
+
+} // namespace cxx14
+
+#endif // __cplusplus >= 201402L
+
+]])
+
+
+dnl Tests for new features in C++17
+
+m4_define([_AX_CXX_COMPILE_STDCXX_testbody_new_in_17], [[
+
+// If the compiler admits that it is not ready for C++17, why torture it?
+// Hopefully, this will speed up the test.
+
+#ifndef __cplusplus
+
+#error "This is not a C++ compiler"
+
+#elif __cplusplus < 201703L && !defined _MSC_VER
+
+#error "This is not a C++17 compiler"
+
+#else
+
+#include <initializer_list>
+#include <utility>
+#include <type_traits>
+
+namespace cxx17
+{
+
+ namespace test_constexpr_lambdas
+ {
+
+ constexpr int foo = [](){return 42;}();
+
+ }
+
+ namespace test::nested_namespace::definitions
+ {
+
+ }
+
+ namespace test_fold_expression
+ {
+
+ template<typename... Args>
+ int multiply(Args... args)
+ {
+ return (args * ... * 1);
+ }
+
+ template<typename... Args>
+ bool all(Args... args)
+ {
+ return (args && ...);
+ }
+
+ }
+
+ namespace test_extended_static_assert
+ {
+
+ static_assert (true);
+
+ }
+
+ namespace test_auto_brace_init_list
+ {
+
+ auto foo = {5};
+ auto bar {5};
+
+ static_assert(std::is_same<std::initializer_list<int>, decltype(foo)>::value);
+ static_assert(std::is_same<int, decltype(bar)>::value);
+ }
+
+ namespace test_typename_in_template_template_parameter
+ {
+
+ template<template<typename> typename X> struct D;
+
+ }
+
+ namespace test_fallthrough_nodiscard_maybe_unused_attributes
+ {
+
+ int f1()
+ {
+ return 42;
+ }
+
+ [[nodiscard]] int f2()
+ {
+ [[maybe_unused]] auto unused = f1();
+
+ switch (f1())
+ {
+ case 17:
+ f1();
+ [[fallthrough]];
+ case 42:
+ f1();
+ }
+ return f1();
+ }
+
+ }
+
+ namespace test_extended_aggregate_initialization
+ {
+
+ struct base1
+ {
+ int b1, b2 = 42;
+ };
+
+ struct base2
+ {
+ base2() {
+ b3 = 42;
+ }
+ int b3;
+ };
+
+ struct derived : base1, base2
+ {
+ int d;
+ };
+
+ derived d1 {{1, 2}, {}, 4}; // full initialization
+ derived d2 {{}, {}, 4}; // value-initialized bases
+
+ }
+
+ namespace test_general_range_based_for_loop
+ {
+
+ struct iter
+ {
+ int i;
+
+ int& operator* ()
+ {
+ return i;
+ }
+
+ const int& operator* () const
+ {
+ return i;
+ }
+
+ iter& operator++()
+ {
+ ++i;
+ return *this;
+ }
+ };
+
+ struct sentinel
+ {
+ int i;
+ };
+
+ bool operator== (const iter& i, const sentinel& s)
+ {
+ return i.i == s.i;
+ }
+
+ bool operator!= (const iter& i, const sentinel& s)
+ {
+ return !(i == s);
+ }
+
+ struct range
+ {
+ iter begin() const
+ {
+ return {0};
+ }
+
+ sentinel end() const
+ {
+ return {5};
+ }
+ };
+
+ void f()
+ {
+ range r {};
+
+ for (auto i : r)
+ {
+ [[maybe_unused]] auto v = i;
+ }
+ }
+
+ }
+
+ namespace test_lambda_capture_asterisk_this_by_value
+ {
+
+ struct t
+ {
+ int i;
+ int foo()
+ {
+ return [*this]()
+ {
+ return i;
+ }();
+ }
+ };
+
+ }
+
+ namespace test_enum_class_construction
+ {
+
+ enum class byte : unsigned char
+ {};
+
+ byte foo {42};
+
+ }
+
+ namespace test_constexpr_if
+ {
+
+ template <bool cond>
+ int f ()
+ {
+ if constexpr(cond)
+ {
+ return 13;
+ }
+ else
+ {
+ return 42;
+ }
+ }
+
+ }
+
+ namespace test_selection_statement_with_initializer
+ {
+
+ int f()
+ {
+ return 13;
+ }
+
+ int f2()
+ {
+ if (auto i = f(); i > 0)
+ {
+ return 3;
+ }
+
+ switch (auto i = f(); i + 4)
+ {
+ case 17:
+ return 2;
+
+ default:
+ return 1;
+ }
+ }
+
+ }
+
+ namespace test_template_argument_deduction_for_class_templates
+ {
+
+ template <typename T1, typename T2>
+ struct pair
+ {
+ pair (T1 p1, T2 p2)
+ : m1 {p1},
+ m2 {p2}
+ {}
+
+ T1 m1;
+ T2 m2;
+ };
+
+ void f()
+ {
+ [[maybe_unused]] auto p = pair{13, 42u};
+ }
+
+ }
+
+ namespace test_non_type_auto_template_parameters
+ {
+
+ template <auto n>
+ struct B
+ {};
+
+ B<5> b1;
+ B<'a'> b2;
+
+ }
+
+ namespace test_structured_bindings
+ {
+
+ int arr[2] = { 1, 2 };
+ std::pair<int, int> pr = { 1, 2 };
+
+ auto f1() -> int(&)[2]
+ {
+ return arr;
+ }
+
+ auto f2() -> std::pair<int, int>&
+ {
+ return pr;
+ }
+
+ struct S
+ {
+ int x1 : 2;
+ volatile double y1;
+ };
+
+ S f3()
+ {
+ return {};
+ }
+
+ auto [ x1, y1 ] = f1();
+ auto& [ xr1, yr1 ] = f1();
+ auto [ x2, y2 ] = f2();
+ auto& [ xr2, yr2 ] = f2();
+ const auto [ x3, y3 ] = f3();
+
+ }
+
+ namespace test_exception_spec_type_system
+ {
+
+ struct Good {};
+ struct Bad {};
+
+ void g1() noexcept;
+ void g2();
+
+ template<typename T>
+ Bad
+ f(T*, T*);
+
+ template<typename T1, typename T2>
+ Good
+ f(T1*, T2*);
+
+ static_assert (std::is_same_v<Good, decltype(f(g1, g2))>);
+
+ }
+
+ namespace test_inline_variables
+ {
+
+ template<class T> void f(T)
+ {}
+
+ template<class T> inline T g(T)
+ {
+ return T{};
+ }
+
+ template<> inline void f<>(int)
+ {}
+
+ template<> int g<>(int)
+ {
+ return 5;
+ }
+
+ }
+
+} // namespace cxx17
+
+#endif // __cplusplus < 201703L && !defined _MSC_VER
+
+]])
+
+
+dnl Tests for new features in C++20
+
+m4_define([_AX_CXX_COMPILE_STDCXX_testbody_new_in_20], [[
+
+#ifndef __cplusplus
+
+#error "This is not a C++ compiler"
+
+#elif __cplusplus < 202002L && !defined _MSC_VER
+
+#error "This is not a C++20 compiler"
+
+#else
+
+#include <version>
+
+namespace cxx20
+{
+
+// As C++20 supports feature test macros in the standard, there is no
+// immediate need to actually test for feature availability on the
+// Autoconf side.
+
+} // namespace cxx20
+
+#endif // __cplusplus < 202002L && !defined _MSC_VER
+
+]])
diff --git a/subprojects/c-ares/m4/ax_cxx_compile_stdcxx_14.m4 b/subprojects/c-ares/m4/ax_cxx_compile_stdcxx_14.m4
@@ -0,0 +1,34 @@
+# =============================================================================
+# https://www.gnu.org/software/autoconf-archive/ax_cxx_compile_stdcxx_14.html
+# =============================================================================
+#
+# SYNOPSIS
+#
+# AX_CXX_COMPILE_STDCXX_14([ext|noext], [mandatory|optional])
+#
+# DESCRIPTION
+#
+# Check for baseline language coverage in the compiler for the C++14
+# standard; if necessary, add switches to CXX and CXXCPP to enable
+# support.
+#
+# This macro is a convenience alias for calling the AX_CXX_COMPILE_STDCXX
+# macro with the version set to C++14. The two optional arguments are
+# forwarded literally as the second and third argument respectively.
+# Please see the documentation for the AX_CXX_COMPILE_STDCXX macro for
+# more information. If you want to use this macro, you also need to
+# download the ax_cxx_compile_stdcxx.m4 file.
+#
+# LICENSE
+#
+# Copyright (c) 2015 Moritz Klammler <moritz@klammler.eu>
+#
+# Copying and distribution of this file, with or without modification, are
+# permitted in any medium without royalty provided the copyright notice
+# and this notice are preserved. This file is offered as-is, without any
+# warranty.
+
+#serial 5
+
+AX_REQUIRE_DEFINED([AX_CXX_COMPILE_STDCXX])
+AC_DEFUN([AX_CXX_COMPILE_STDCXX_14], [AX_CXX_COMPILE_STDCXX([14], [$1], [$2])])
diff --git a/subprojects/c-ares/m4/ax_file_escapes.m4 b/subprojects/c-ares/m4/ax_file_escapes.m4
@@ -0,0 +1,30 @@
+# ===========================================================================
+# https://www.gnu.org/software/autoconf-archive/ax_file_escapes.html
+# ===========================================================================
+#
+# SYNOPSIS
+#
+# AX_FILE_ESCAPES
+#
+# DESCRIPTION
+#
+# Writes the specified data to the specified file.
+#
+# LICENSE
+#
+# Copyright (c) 2008 Tom Howard <tomhoward@users.sf.net>
+#
+# Copying and distribution of this file, with or without modification, are
+# permitted in any medium without royalty provided the copyright notice
+# and this notice are preserved. This file is offered as-is, without any
+# warranty.
+
+#serial 8
+
+AC_DEFUN([AX_FILE_ESCAPES],[
+AX_DOLLAR="\$"
+AX_SRB="\\135"
+AX_SLB="\\133"
+AX_BS="\\\\"
+AX_DQ="\""
+])
diff --git a/subprojects/c-ares/m4/ax_pthread.m4 b/subprojects/c-ares/m4/ax_pthread.m4
@@ -0,0 +1,522 @@
+# ===========================================================================
+# https://www.gnu.org/software/autoconf-archive/ax_pthread.html
+# ===========================================================================
+#
+# SYNOPSIS
+#
+# AX_PTHREAD([ACTION-IF-FOUND[, ACTION-IF-NOT-FOUND]])
+#
+# DESCRIPTION
+#
+# This macro figures out how to build C programs using POSIX threads. It
+# sets the PTHREAD_LIBS output variable to the threads library and linker
+# flags, and the PTHREAD_CFLAGS output variable to any special C compiler
+# flags that are needed. (The user can also force certain compiler
+# flags/libs to be tested by setting these environment variables.)
+#
+# Also sets PTHREAD_CC and PTHREAD_CXX to any special C compiler that is
+# needed for multi-threaded programs (defaults to the value of CC
+# respectively CXX otherwise). (This is necessary on e.g. AIX to use the
+# special cc_r/CC_r compiler alias.)
+#
+# NOTE: You are assumed to not only compile your program with these flags,
+# but also to link with them as well. For example, you might link with
+# $PTHREAD_CC $CFLAGS $PTHREAD_CFLAGS $LDFLAGS ... $PTHREAD_LIBS $LIBS
+# $PTHREAD_CXX $CXXFLAGS $PTHREAD_CFLAGS $LDFLAGS ... $PTHREAD_LIBS $LIBS
+#
+# If you are only building threaded programs, you may wish to use these
+# variables in your default LIBS, CFLAGS, and CC:
+#
+# LIBS="$PTHREAD_LIBS $LIBS"
+# CFLAGS="$CFLAGS $PTHREAD_CFLAGS"
+# CXXFLAGS="$CXXFLAGS $PTHREAD_CFLAGS"
+# CC="$PTHREAD_CC"
+# CXX="$PTHREAD_CXX"
+#
+# In addition, if the PTHREAD_CREATE_JOINABLE thread-attribute constant
+# has a nonstandard name, this macro defines PTHREAD_CREATE_JOINABLE to
+# that name (e.g. PTHREAD_CREATE_UNDETACHED on AIX).
+#
+# Also HAVE_PTHREAD_PRIO_INHERIT is defined if pthread is found and the
+# PTHREAD_PRIO_INHERIT symbol is defined when compiling with
+# PTHREAD_CFLAGS.
+#
+# ACTION-IF-FOUND is a list of shell commands to run if a threads library
+# is found, and ACTION-IF-NOT-FOUND is a list of commands to run it if it
+# is not found. If ACTION-IF-FOUND is not specified, the default action
+# will define HAVE_PTHREAD.
+#
+# Please let the authors know if this macro fails on any platform, or if
+# you have any other suggestions or comments. This macro was based on work
+# by SGJ on autoconf scripts for FFTW (http://www.fftw.org/) (with help
+# from M. Frigo), as well as ac_pthread and hb_pthread macros posted by
+# Alejandro Forero Cuervo to the autoconf macro repository. We are also
+# grateful for the helpful feedback of numerous users.
+#
+# Updated for Autoconf 2.68 by Daniel Richard G.
+#
+# LICENSE
+#
+# Copyright (c) 2008 Steven G. Johnson <stevenj@alum.mit.edu>
+# Copyright (c) 2011 Daniel Richard G. <skunk@iSKUNK.ORG>
+# Copyright (c) 2019 Marc Stevens <marc.stevens@cwi.nl>
+#
+# This program is free software: you can redistribute it and/or modify it
+# under the terms of the GNU General Public License as published by the
+# Free Software Foundation, either version 3 of the License, or (at your
+# option) any later version.
+#
+# This program is distributed in the hope that it will be useful, but
+# WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General
+# Public License for more details.
+#
+# You should have received a copy of the GNU General Public License along
+# with this program. If not, see <https://www.gnu.org/licenses/>.
+#
+# As a special exception, the respective Autoconf Macro's copyright owner
+# gives unlimited permission to copy, distribute and modify the configure
+# scripts that are the output of Autoconf when processing the Macro. You
+# need not follow the terms of the GNU General Public License when using
+# or distributing such scripts, even though portions of the text of the
+# Macro appear in them. The GNU General Public License (GPL) does govern
+# all other use of the material that constitutes the Autoconf Macro.
+#
+# This special exception to the GPL applies to versions of the Autoconf
+# Macro released by the Autoconf Archive. When you make and distribute a
+# modified version of the Autoconf Macro, you may extend this special
+# exception to the GPL to apply to your modified version as well.
+
+#serial 31
+
+AU_ALIAS([ACX_PTHREAD], [AX_PTHREAD])
+AC_DEFUN([AX_PTHREAD], [
+AC_REQUIRE([AC_CANONICAL_HOST])
+AC_REQUIRE([AC_PROG_CC])
+AC_REQUIRE([AC_PROG_SED])
+AC_LANG_PUSH([C])
+ax_pthread_ok=no
+
+# We used to check for pthread.h first, but this fails if pthread.h
+# requires special compiler flags (e.g. on Tru64 or Sequent).
+# It gets checked for in the link test anyway.
+
+# First of all, check if the user has set any of the PTHREAD_LIBS,
+# etcetera environment variables, and if threads linking works using
+# them:
+if test "x$PTHREAD_CFLAGS$PTHREAD_LIBS" != "x"; then
+ ax_pthread_save_CC="$CC"
+ ax_pthread_save_CFLAGS="$CFLAGS"
+ ax_pthread_save_LIBS="$LIBS"
+ AS_IF([test "x$PTHREAD_CC" != "x"], [CC="$PTHREAD_CC"])
+ AS_IF([test "x$PTHREAD_CXX" != "x"], [CXX="$PTHREAD_CXX"])
+ CFLAGS="$CFLAGS $PTHREAD_CFLAGS"
+ LIBS="$PTHREAD_LIBS $LIBS"
+ AC_MSG_CHECKING([for pthread_join using $CC $PTHREAD_CFLAGS $PTHREAD_LIBS])
+ AC_LINK_IFELSE([AC_LANG_CALL([], [pthread_join])], [ax_pthread_ok=yes])
+ AC_MSG_RESULT([$ax_pthread_ok])
+ if test "x$ax_pthread_ok" = "xno"; then
+ PTHREAD_LIBS=""
+ PTHREAD_CFLAGS=""
+ fi
+ CC="$ax_pthread_save_CC"
+ CFLAGS="$ax_pthread_save_CFLAGS"
+ LIBS="$ax_pthread_save_LIBS"
+fi
+
+# We must check for the threads library under a number of different
+# names; the ordering is very important because some systems
+# (e.g. DEC) have both -lpthread and -lpthreads, where one of the
+# libraries is broken (non-POSIX).
+
+# Create a list of thread flags to try. Items with a "," contain both
+# C compiler flags (before ",") and linker flags (after ","). Other items
+# starting with a "-" are C compiler flags, and remaining items are
+# library names, except for "none" which indicates that we try without
+# any flags at all, and "pthread-config" which is a program returning
+# the flags for the Pth emulation library.
+
+ax_pthread_flags="pthreads none -Kthread -pthread -pthreads -mthreads pthread --thread-safe -mt pthread-config"
+
+# The ordering *is* (sometimes) important. Some notes on the
+# individual items follow:
+
+# pthreads: AIX (must check this before -lpthread)
+# none: in case threads are in libc; should be tried before -Kthread and
+# other compiler flags to prevent continual compiler warnings
+# -Kthread: Sequent (threads in libc, but -Kthread needed for pthread.h)
+# -pthread: Linux/gcc (kernel threads), BSD/gcc (userland threads), Tru64
+# (Note: HP C rejects this with "bad form for `-t' option")
+# -pthreads: Solaris/gcc (Note: HP C also rejects)
+# -mt: Sun Workshop C (may only link SunOS threads [-lthread], but it
+# doesn't hurt to check since this sometimes defines pthreads and
+# -D_REENTRANT too), HP C (must be checked before -lpthread, which
+# is present but should not be used directly; and before -mthreads,
+# because the compiler interprets this as "-mt" + "-hreads")
+# -mthreads: Mingw32/gcc, Lynx/gcc
+# pthread: Linux, etcetera
+# --thread-safe: KAI C++
+# pthread-config: use pthread-config program (for GNU Pth library)
+
+case $host_os in
+
+ freebsd*)
+
+ # -kthread: FreeBSD kernel threads (preferred to -pthread since SMP-able)
+ # lthread: LinuxThreads port on FreeBSD (also preferred to -pthread)
+
+ ax_pthread_flags="-kthread lthread $ax_pthread_flags"
+ ;;
+
+ hpux*)
+
+ # From the cc(1) man page: "[-mt] Sets various -D flags to enable
+ # multi-threading and also sets -lpthread."
+
+ ax_pthread_flags="-mt -pthread pthread $ax_pthread_flags"
+ ;;
+
+ openedition*)
+
+ # IBM z/OS requires a feature-test macro to be defined in order to
+ # enable POSIX threads at all, so give the user a hint if this is
+ # not set. (We don't define these ourselves, as they can affect
+ # other portions of the system API in unpredictable ways.)
+
+ AC_EGREP_CPP([AX_PTHREAD_ZOS_MISSING],
+ [
+# if !defined(_OPEN_THREADS) && !defined(_UNIX03_THREADS)
+ AX_PTHREAD_ZOS_MISSING
+# endif
+ ],
+ [AC_MSG_WARN([IBM z/OS requires -D_OPEN_THREADS or -D_UNIX03_THREADS to enable pthreads support.])])
+ ;;
+
+ solaris*)
+
+ # On Solaris (at least, for some versions), libc contains stubbed
+ # (non-functional) versions of the pthreads routines, so link-based
+ # tests will erroneously succeed. (N.B.: The stubs are missing
+ # pthread_cleanup_push, or rather a function called by this macro,
+ # so we could check for that, but who knows whether they'll stub
+ # that too in a future libc.) So we'll check first for the
+ # standard Solaris way of linking pthreads (-mt -lpthread).
+
+ ax_pthread_flags="-mt,-lpthread pthread $ax_pthread_flags"
+ ;;
+esac
+
+# Are we compiling with Clang?
+
+AC_CACHE_CHECK([whether $CC is Clang],
+ [ax_cv_PTHREAD_CLANG],
+ [ax_cv_PTHREAD_CLANG=no
+ # Note that Autoconf sets GCC=yes for Clang as well as GCC
+ if test "x$GCC" = "xyes"; then
+ AC_EGREP_CPP([AX_PTHREAD_CC_IS_CLANG],
+ [/* Note: Clang 2.7 lacks __clang_[a-z]+__ */
+# if defined(__clang__) && defined(__llvm__)
+ AX_PTHREAD_CC_IS_CLANG
+# endif
+ ],
+ [ax_cv_PTHREAD_CLANG=yes])
+ fi
+ ])
+ax_pthread_clang="$ax_cv_PTHREAD_CLANG"
+
+
+# GCC generally uses -pthread, or -pthreads on some platforms (e.g. SPARC)
+
+# Note that for GCC and Clang -pthread generally implies -lpthread,
+# except when -nostdlib is passed.
+# This is problematic using libtool to build C++ shared libraries with pthread:
+# [1] https://gcc.gnu.org/bugzilla/show_bug.cgi?id=25460
+# [2] https://bugzilla.redhat.com/show_bug.cgi?id=661333
+# [3] https://bugs.debian.org/cgi-bin/bugreport.cgi?bug=468555
+# To solve this, first try -pthread together with -lpthread for GCC
+
+AS_IF([test "x$GCC" = "xyes"],
+ [ax_pthread_flags="-pthread,-lpthread -pthread -pthreads $ax_pthread_flags"])
+
+# Clang takes -pthread (never supported any other flag), but we'll try with -lpthread first
+
+AS_IF([test "x$ax_pthread_clang" = "xyes"],
+ [ax_pthread_flags="-pthread,-lpthread -pthread"])
+
+
+# The presence of a feature test macro requesting re-entrant function
+# definitions is, on some systems, a strong hint that pthreads support is
+# correctly enabled
+
+case $host_os in
+ darwin* | hpux* | linux* | osf* | solaris*)
+ ax_pthread_check_macro="_REENTRANT"
+ ;;
+
+ aix*)
+ ax_pthread_check_macro="_THREAD_SAFE"
+ ;;
+
+ *)
+ ax_pthread_check_macro="--"
+ ;;
+esac
+AS_IF([test "x$ax_pthread_check_macro" = "x--"],
+ [ax_pthread_check_cond=0],
+ [ax_pthread_check_cond="!defined($ax_pthread_check_macro)"])
+
+
+if test "x$ax_pthread_ok" = "xno"; then
+for ax_pthread_try_flag in $ax_pthread_flags; do
+
+ case $ax_pthread_try_flag in
+ none)
+ AC_MSG_CHECKING([whether pthreads work without any flags])
+ ;;
+
+ *,*)
+ PTHREAD_CFLAGS=`echo $ax_pthread_try_flag | sed "s/^\(.*\),\(.*\)$/\1/"`
+ PTHREAD_LIBS=`echo $ax_pthread_try_flag | sed "s/^\(.*\),\(.*\)$/\2/"`
+ AC_MSG_CHECKING([whether pthreads work with "$PTHREAD_CFLAGS" and "$PTHREAD_LIBS"])
+ ;;
+
+ -*)
+ AC_MSG_CHECKING([whether pthreads work with $ax_pthread_try_flag])
+ PTHREAD_CFLAGS="$ax_pthread_try_flag"
+ ;;
+
+ pthread-config)
+ AC_CHECK_PROG([ax_pthread_config], [pthread-config], [yes], [no])
+ AS_IF([test "x$ax_pthread_config" = "xno"], [continue])
+ PTHREAD_CFLAGS="`pthread-config --cflags`"
+ PTHREAD_LIBS="`pthread-config --ldflags` `pthread-config --libs`"
+ ;;
+
+ *)
+ AC_MSG_CHECKING([for the pthreads library -l$ax_pthread_try_flag])
+ PTHREAD_LIBS="-l$ax_pthread_try_flag"
+ ;;
+ esac
+
+ ax_pthread_save_CFLAGS="$CFLAGS"
+ ax_pthread_save_LIBS="$LIBS"
+ CFLAGS="$CFLAGS $PTHREAD_CFLAGS"
+ LIBS="$PTHREAD_LIBS $LIBS"
+
+ # Check for various functions. We must include pthread.h,
+ # since some functions may be macros. (On the Sequent, we
+ # need a special flag -Kthread to make this header compile.)
+ # We check for pthread_join because it is in -lpthread on IRIX
+ # while pthread_create is in libc. We check for pthread_attr_init
+ # due to DEC craziness with -lpthreads. We check for
+ # pthread_cleanup_push because it is one of the few pthread
+ # functions on Solaris that doesn't have a non-functional libc stub.
+ # We try pthread_create on general principles.
+
+ AC_LINK_IFELSE([AC_LANG_PROGRAM([#include <pthread.h>
+# if $ax_pthread_check_cond
+# error "$ax_pthread_check_macro must be defined"
+# endif
+ static void *some_global = NULL;
+ static void routine(void *a)
+ {
+ /* To avoid any unused-parameter or
+ unused-but-set-parameter warning. */
+ some_global = a;
+ }
+ static void *start_routine(void *a) { return a; }],
+ [pthread_t th; pthread_attr_t attr;
+ pthread_create(&th, 0, start_routine, 0);
+ pthread_join(th, 0);
+ pthread_attr_init(&attr);
+ pthread_cleanup_push(routine, 0);
+ pthread_cleanup_pop(0) /* ; */])],
+ [ax_pthread_ok=yes],
+ [])
+
+ CFLAGS="$ax_pthread_save_CFLAGS"
+ LIBS="$ax_pthread_save_LIBS"
+
+ AC_MSG_RESULT([$ax_pthread_ok])
+ AS_IF([test "x$ax_pthread_ok" = "xyes"], [break])
+
+ PTHREAD_LIBS=""
+ PTHREAD_CFLAGS=""
+done
+fi
+
+
+# Clang needs special handling, because older versions handle the -pthread
+# option in a rather... idiosyncratic way
+
+if test "x$ax_pthread_clang" = "xyes"; then
+
+ # Clang takes -pthread; it has never supported any other flag
+
+ # (Note 1: This will need to be revisited if a system that Clang
+ # supports has POSIX threads in a separate library. This tends not
+ # to be the way of modern systems, but it's conceivable.)
+
+ # (Note 2: On some systems, notably Darwin, -pthread is not needed
+ # to get POSIX threads support; the API is always present and
+ # active. We could reasonably leave PTHREAD_CFLAGS empty. But
+ # -pthread does define _REENTRANT, and while the Darwin headers
+ # ignore this macro, third-party headers might not.)
+
+ # However, older versions of Clang make a point of warning the user
+ # that, in an invocation where only linking and no compilation is
+ # taking place, the -pthread option has no effect ("argument unused
+ # during compilation"). They expect -pthread to be passed in only
+ # when source code is being compiled.
+ #
+ # Problem is, this is at odds with the way Automake and most other
+ # C build frameworks function, which is that the same flags used in
+ # compilation (CFLAGS) are also used in linking. Many systems
+ # supported by AX_PTHREAD require exactly this for POSIX threads
+ # support, and in fact it is often not straightforward to specify a
+ # flag that is used only in the compilation phase and not in
+ # linking. Such a scenario is extremely rare in practice.
+ #
+ # Even though use of the -pthread flag in linking would only print
+ # a warning, this can be a nuisance for well-run software projects
+ # that build with -Werror. So if the active version of Clang has
+ # this misfeature, we search for an option to squash it.
+
+ AC_CACHE_CHECK([whether Clang needs flag to prevent "argument unused" warning when linking with -pthread],
+ [ax_cv_PTHREAD_CLANG_NO_WARN_FLAG],
+ [ax_cv_PTHREAD_CLANG_NO_WARN_FLAG=unknown
+ # Create an alternate version of $ac_link that compiles and
+ # links in two steps (.c -> .o, .o -> exe) instead of one
+ # (.c -> exe), because the warning occurs only in the second
+ # step
+ ax_pthread_save_ac_link="$ac_link"
+ ax_pthread_sed='s/conftest\.\$ac_ext/conftest.$ac_objext/g'
+ ax_pthread_link_step=`AS_ECHO(["$ac_link"]) | sed "$ax_pthread_sed"`
+ ax_pthread_2step_ac_link="($ac_compile) && (echo ==== >&5) && ($ax_pthread_link_step)"
+ ax_pthread_save_CFLAGS="$CFLAGS"
+ for ax_pthread_try in '' -Qunused-arguments -Wno-unused-command-line-argument unknown; do
+ AS_IF([test "x$ax_pthread_try" = "xunknown"], [break])
+ CFLAGS="-Werror -Wunknown-warning-option $ax_pthread_try -pthread $ax_pthread_save_CFLAGS"
+ ac_link="$ax_pthread_save_ac_link"
+ AC_LINK_IFELSE([AC_LANG_SOURCE([[int main(void){return 0;}]])],
+ [ac_link="$ax_pthread_2step_ac_link"
+ AC_LINK_IFELSE([AC_LANG_SOURCE([[int main(void){return 0;}]])],
+ [break])
+ ])
+ done
+ ac_link="$ax_pthread_save_ac_link"
+ CFLAGS="$ax_pthread_save_CFLAGS"
+ AS_IF([test "x$ax_pthread_try" = "x"], [ax_pthread_try=no])
+ ax_cv_PTHREAD_CLANG_NO_WARN_FLAG="$ax_pthread_try"
+ ])
+
+ case "$ax_cv_PTHREAD_CLANG_NO_WARN_FLAG" in
+ no | unknown) ;;
+ *) PTHREAD_CFLAGS="$ax_cv_PTHREAD_CLANG_NO_WARN_FLAG $PTHREAD_CFLAGS" ;;
+ esac
+
+fi # $ax_pthread_clang = yes
+
+
+
+# Various other checks:
+if test "x$ax_pthread_ok" = "xyes"; then
+ ax_pthread_save_CFLAGS="$CFLAGS"
+ ax_pthread_save_LIBS="$LIBS"
+ CFLAGS="$CFLAGS $PTHREAD_CFLAGS"
+ LIBS="$PTHREAD_LIBS $LIBS"
+
+ # Detect AIX lossage: JOINABLE attribute is called UNDETACHED.
+ AC_CACHE_CHECK([for joinable pthread attribute],
+ [ax_cv_PTHREAD_JOINABLE_ATTR],
+ [ax_cv_PTHREAD_JOINABLE_ATTR=unknown
+ for ax_pthread_attr in PTHREAD_CREATE_JOINABLE PTHREAD_CREATE_UNDETACHED; do
+ AC_LINK_IFELSE([AC_LANG_PROGRAM([#include <pthread.h>],
+ [int attr = $ax_pthread_attr; return attr /* ; */])],
+ [ax_cv_PTHREAD_JOINABLE_ATTR=$ax_pthread_attr; break],
+ [])
+ done
+ ])
+ AS_IF([test "x$ax_cv_PTHREAD_JOINABLE_ATTR" != "xunknown" && \
+ test "x$ax_cv_PTHREAD_JOINABLE_ATTR" != "xPTHREAD_CREATE_JOINABLE" && \
+ test "x$ax_pthread_joinable_attr_defined" != "xyes"],
+ [AC_DEFINE_UNQUOTED([PTHREAD_CREATE_JOINABLE],
+ [$ax_cv_PTHREAD_JOINABLE_ATTR],
+ [Define to necessary symbol if this constant
+ uses a non-standard name on your system.])
+ ax_pthread_joinable_attr_defined=yes
+ ])
+
+ AC_CACHE_CHECK([whether more special flags are required for pthreads],
+ [ax_cv_PTHREAD_SPECIAL_FLAGS],
+ [ax_cv_PTHREAD_SPECIAL_FLAGS=no
+ case $host_os in
+ solaris*)
+ ax_cv_PTHREAD_SPECIAL_FLAGS="-D_POSIX_PTHREAD_SEMANTICS"
+ ;;
+ esac
+ ])
+ AS_IF([test "x$ax_cv_PTHREAD_SPECIAL_FLAGS" != "xno" && \
+ test "x$ax_pthread_special_flags_added" != "xyes"],
+ [PTHREAD_CFLAGS="$ax_cv_PTHREAD_SPECIAL_FLAGS $PTHREAD_CFLAGS"
+ ax_pthread_special_flags_added=yes])
+
+ AC_CACHE_CHECK([for PTHREAD_PRIO_INHERIT],
+ [ax_cv_PTHREAD_PRIO_INHERIT],
+ [AC_LINK_IFELSE([AC_LANG_PROGRAM([[#include <pthread.h>]],
+ [[int i = PTHREAD_PRIO_INHERIT;
+ return i;]])],
+ [ax_cv_PTHREAD_PRIO_INHERIT=yes],
+ [ax_cv_PTHREAD_PRIO_INHERIT=no])
+ ])
+ AS_IF([test "x$ax_cv_PTHREAD_PRIO_INHERIT" = "xyes" && \
+ test "x$ax_pthread_prio_inherit_defined" != "xyes"],
+ [AC_DEFINE([HAVE_PTHREAD_PRIO_INHERIT], [1], [Have PTHREAD_PRIO_INHERIT.])
+ ax_pthread_prio_inherit_defined=yes
+ ])
+
+ CFLAGS="$ax_pthread_save_CFLAGS"
+ LIBS="$ax_pthread_save_LIBS"
+
+ # More AIX lossage: compile with *_r variant
+ if test "x$GCC" != "xyes"; then
+ case $host_os in
+ aix*)
+ AS_CASE(["x/$CC"],
+ [x*/c89|x*/c89_128|x*/c99|x*/c99_128|x*/cc|x*/cc128|x*/xlc|x*/xlc_v6|x*/xlc128|x*/xlc128_v6],
+ [#handle absolute path differently from PATH based program lookup
+ AS_CASE(["x$CC"],
+ [x/*],
+ [
+ AS_IF([AS_EXECUTABLE_P([${CC}_r])],[PTHREAD_CC="${CC}_r"])
+ AS_IF([test "x${CXX}" != "x"], [AS_IF([AS_EXECUTABLE_P([${CXX}_r])],[PTHREAD_CXX="${CXX}_r"])])
+ ],
+ [
+ AC_CHECK_PROGS([PTHREAD_CC],[${CC}_r],[$CC])
+ AS_IF([test "x${CXX}" != "x"], [AC_CHECK_PROGS([PTHREAD_CXX],[${CXX}_r],[$CXX])])
+ ]
+ )
+ ])
+ ;;
+ esac
+ fi
+fi
+
+test -n "$PTHREAD_CC" || PTHREAD_CC="$CC"
+test -n "$PTHREAD_CXX" || PTHREAD_CXX="$CXX"
+
+AC_SUBST([PTHREAD_LIBS])
+AC_SUBST([PTHREAD_CFLAGS])
+AC_SUBST([PTHREAD_CC])
+AC_SUBST([PTHREAD_CXX])
+
+# Finally, execute ACTION-IF-FOUND/ACTION-IF-NOT-FOUND:
+if test "x$ax_pthread_ok" = "xyes"; then
+ ifelse([$1],,[AC_DEFINE([HAVE_PTHREAD],[1],[Define if you have POSIX threads libraries and header files.])],[$1])
+ :
+else
+ ax_pthread_ok=no
+ $2
+fi
+AC_LANG_POP
+])dnl AX_PTHREAD
diff --git a/subprojects/c-ares/m4/ax_require_defined.m4 b/subprojects/c-ares/m4/ax_require_defined.m4
@@ -0,0 +1,37 @@
+# ===========================================================================
+# https://www.gnu.org/software/autoconf-archive/ax_require_defined.html
+# ===========================================================================
+#
+# SYNOPSIS
+#
+# AX_REQUIRE_DEFINED(MACRO)
+#
+# DESCRIPTION
+#
+# AX_REQUIRE_DEFINED is a simple helper for making sure other macros have
+# been defined and thus are available for use. This avoids random issues
+# where a macro isn't expanded. Instead the configure script emits a
+# non-fatal:
+#
+# ./configure: line 1673: AX_CFLAGS_WARN_ALL: command not found
+#
+# It's like AC_REQUIRE except it doesn't expand the required macro.
+#
+# Here's an example:
+#
+# AX_REQUIRE_DEFINED([AX_CHECK_LINK_FLAG])
+#
+# LICENSE
+#
+# Copyright (c) 2014 Mike Frysinger <vapier@gentoo.org>
+#
+# Copying and distribution of this file, with or without modification, are
+# permitted in any medium without royalty provided the copyright notice
+# and this notice are preserved. This file is offered as-is, without any
+# warranty.
+
+#serial 2
+
+AC_DEFUN([AX_REQUIRE_DEFINED], [dnl
+ m4_ifndef([$1], [m4_fatal([macro ]$1[ is not defined; is a m4 file missing?])])
+])dnl AX_REQUIRE_DEFINED
diff --git a/subprojects/c-ares/m4/pkg.m4 b/subprojects/c-ares/m4/pkg.m4
@@ -0,0 +1,275 @@
+# pkg.m4 - Macros to locate and utilise pkg-config. -*- Autoconf -*-
+# serial 12 (pkg-config-0.29.2)
+
+dnl Copyright © 2004 Scott James Remnant <scott@netsplit.com>.
+dnl Copyright © 2012-2015 Dan Nicholson <dbn.lists@gmail.com>
+dnl
+dnl This program is free software; you can redistribute it and/or modify
+dnl it under the terms of the GNU General Public License as published by
+dnl the Free Software Foundation; either version 2 of the License, or
+dnl (at your option) any later version.
+dnl
+dnl This program is distributed in the hope that it will be useful, but
+dnl WITHOUT ANY WARRANTY; without even the implied warranty of
+dnl MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
+dnl General Public License for more details.
+dnl
+dnl You should have received a copy of the GNU General Public License
+dnl along with this program; if not, write to the Free Software
+dnl Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA
+dnl 02111-1307, USA.
+dnl
+dnl As a special exception to the GNU General Public License, if you
+dnl distribute this file as part of a program that contains a
+dnl configuration script generated by Autoconf, you may include it under
+dnl the same distribution terms that you use for the rest of that
+dnl program.
+
+dnl PKG_PREREQ(MIN-VERSION)
+dnl -----------------------
+dnl Since: 0.29
+dnl
+dnl Verify that the version of the pkg-config macros are at least
+dnl MIN-VERSION. Unlike PKG_PROG_PKG_CONFIG, which checks the user's
+dnl installed version of pkg-config, this checks the developer's version
+dnl of pkg.m4 when generating configure.
+dnl
+dnl To ensure that this macro is defined, also add:
+dnl m4_ifndef([PKG_PREREQ],
+dnl [m4_fatal([must install pkg-config 0.29 or later before running autoconf/autogen])])
+dnl
+dnl See the "Since" comment for each macro you use to see what version
+dnl of the macros you require.
+m4_defun([PKG_PREREQ],
+[m4_define([PKG_MACROS_VERSION], [0.29.2])
+m4_if(m4_version_compare(PKG_MACROS_VERSION, [$1]), -1,
+ [m4_fatal([pkg.m4 version $1 or higher is required but ]PKG_MACROS_VERSION[ found])])
+])dnl PKG_PREREQ
+
+dnl PKG_PROG_PKG_CONFIG([MIN-VERSION])
+dnl ----------------------------------
+dnl Since: 0.16
+dnl
+dnl Search for the pkg-config tool and set the PKG_CONFIG variable to
+dnl first found in the path. Checks that the version of pkg-config found
+dnl is at least MIN-VERSION. If MIN-VERSION is not specified, 0.9.0 is
+dnl used since that's the first version where most current features of
+dnl pkg-config existed.
+AC_DEFUN([PKG_PROG_PKG_CONFIG],
+[m4_pattern_forbid([^_?PKG_[A-Z_]+$])
+m4_pattern_allow([^PKG_CONFIG(_(PATH|LIBDIR|SYSROOT_DIR|ALLOW_SYSTEM_(CFLAGS|LIBS)))?$])
+m4_pattern_allow([^PKG_CONFIG_(DISABLE_UNINSTALLED|TOP_BUILD_DIR|DEBUG_SPEW)$])
+AC_ARG_VAR([PKG_CONFIG], [path to pkg-config utility])
+AC_ARG_VAR([PKG_CONFIG_PATH], [directories to add to pkg-config's search path])
+AC_ARG_VAR([PKG_CONFIG_LIBDIR], [path overriding pkg-config's built-in search path])
+
+if test "x$ac_cv_env_PKG_CONFIG_set" != "xset"; then
+ AC_PATH_TOOL([PKG_CONFIG], [pkg-config])
+fi
+if test -n "$PKG_CONFIG"; then
+ _pkg_min_version=m4_default([$1], [0.9.0])
+ AC_MSG_CHECKING([pkg-config is at least version $_pkg_min_version])
+ if $PKG_CONFIG --atleast-pkgconfig-version $_pkg_min_version; then
+ AC_MSG_RESULT([yes])
+ else
+ AC_MSG_RESULT([no])
+ PKG_CONFIG=""
+ fi
+fi[]dnl
+])dnl PKG_PROG_PKG_CONFIG
+
+dnl PKG_CHECK_EXISTS(MODULES, [ACTION-IF-FOUND], [ACTION-IF-NOT-FOUND])
+dnl -------------------------------------------------------------------
+dnl Since: 0.18
+dnl
+dnl Check to see whether a particular set of modules exists. Similar to
+dnl PKG_CHECK_MODULES(), but does not set variables or print errors.
+dnl
+dnl Please remember that m4 expands AC_REQUIRE([PKG_PROG_PKG_CONFIG])
+dnl only at the first occurence in configure.ac, so if the first place
+dnl it's called might be skipped (such as if it is within an "if", you
+dnl have to call PKG_CHECK_EXISTS manually
+AC_DEFUN([PKG_CHECK_EXISTS],
+[AC_REQUIRE([PKG_PROG_PKG_CONFIG])dnl
+if test -n "$PKG_CONFIG" && \
+ AC_RUN_LOG([$PKG_CONFIG --exists --print-errors "$1"]); then
+ m4_default([$2], [:])
+m4_ifvaln([$3], [else
+ $3])dnl
+fi])
+
+dnl _PKG_CONFIG([VARIABLE], [COMMAND], [MODULES])
+dnl ---------------------------------------------
+dnl Internal wrapper calling pkg-config via PKG_CONFIG and setting
+dnl pkg_failed based on the result.
+m4_define([_PKG_CONFIG],
+[if test -n "$$1"; then
+ pkg_cv_[]$1="$$1"
+ elif test -n "$PKG_CONFIG"; then
+ PKG_CHECK_EXISTS([$3],
+ [pkg_cv_[]$1=`$PKG_CONFIG --[]$2 "$3" 2>/dev/null`
+ test "x$?" != "x0" && pkg_failed=yes ],
+ [pkg_failed=yes])
+ else
+ pkg_failed=untried
+fi[]dnl
+])dnl _PKG_CONFIG
+
+dnl _PKG_SHORT_ERRORS_SUPPORTED
+dnl ---------------------------
+dnl Internal check to see if pkg-config supports short errors.
+AC_DEFUN([_PKG_SHORT_ERRORS_SUPPORTED],
+[AC_REQUIRE([PKG_PROG_PKG_CONFIG])
+if $PKG_CONFIG --atleast-pkgconfig-version 0.20; then
+ _pkg_short_errors_supported=yes
+else
+ _pkg_short_errors_supported=no
+fi[]dnl
+])dnl _PKG_SHORT_ERRORS_SUPPORTED
+
+
+dnl PKG_CHECK_MODULES(VARIABLE-PREFIX, MODULES, [ACTION-IF-FOUND],
+dnl [ACTION-IF-NOT-FOUND])
+dnl --------------------------------------------------------------
+dnl Since: 0.4.0
+dnl
+dnl Note that if there is a possibility the first call to
+dnl PKG_CHECK_MODULES might not happen, you should be sure to include an
+dnl explicit call to PKG_PROG_PKG_CONFIG in your configure.ac
+AC_DEFUN([PKG_CHECK_MODULES],
+[AC_REQUIRE([PKG_PROG_PKG_CONFIG])dnl
+AC_ARG_VAR([$1][_CFLAGS], [C compiler flags for $1, overriding pkg-config])dnl
+AC_ARG_VAR([$1][_LIBS], [linker flags for $1, overriding pkg-config])dnl
+
+pkg_failed=no
+AC_MSG_CHECKING([for $2])
+
+_PKG_CONFIG([$1][_CFLAGS], [cflags], [$2])
+_PKG_CONFIG([$1][_LIBS], [libs], [$2])
+
+m4_define([_PKG_TEXT], [Alternatively, you may set the environment variables $1[]_CFLAGS
+and $1[]_LIBS to avoid the need to call pkg-config.
+See the pkg-config man page for more details.])
+
+if test $pkg_failed = yes; then
+ AC_MSG_RESULT([no])
+ _PKG_SHORT_ERRORS_SUPPORTED
+ if test $_pkg_short_errors_supported = yes; then
+ $1[]_PKG_ERRORS=`$PKG_CONFIG --short-errors --print-errors --cflags --libs "$2" 2>&1`
+ else
+ $1[]_PKG_ERRORS=`$PKG_CONFIG --print-errors --cflags --libs "$2" 2>&1`
+ fi
+ # Put the nasty error message in config.log where it belongs
+ echo "$$1[]_PKG_ERRORS" >&AS_MESSAGE_LOG_FD
+
+ m4_default([$4], [AC_MSG_ERROR(
+[Package requirements ($2) were not met:
+
+$$1_PKG_ERRORS
+
+Consider adjusting the PKG_CONFIG_PATH environment variable if you
+installed software in a non-standard prefix.
+
+_PKG_TEXT])[]dnl
+ ])
+elif test $pkg_failed = untried; then
+ AC_MSG_RESULT([no])
+ m4_default([$4], [AC_MSG_FAILURE(
+[The pkg-config script could not be found or is too old. Make sure it
+is in your PATH or set the PKG_CONFIG environment variable to the full
+path to pkg-config.
+
+_PKG_TEXT
+
+To get pkg-config, see <http://pkg-config.freedesktop.org/>.])[]dnl
+ ])
+else
+ $1[]_CFLAGS=$pkg_cv_[]$1[]_CFLAGS
+ $1[]_LIBS=$pkg_cv_[]$1[]_LIBS
+ AC_MSG_RESULT([yes])
+ $3
+fi[]dnl
+])dnl PKG_CHECK_MODULES
+
+
+dnl PKG_CHECK_MODULES_STATIC(VARIABLE-PREFIX, MODULES, [ACTION-IF-FOUND],
+dnl [ACTION-IF-NOT-FOUND])
+dnl ---------------------------------------------------------------------
+dnl Since: 0.29
+dnl
+dnl Checks for existence of MODULES and gathers its build flags with
+dnl static libraries enabled. Sets VARIABLE-PREFIX_CFLAGS from --cflags
+dnl and VARIABLE-PREFIX_LIBS from --libs.
+dnl
+dnl Note that if there is a possibility the first call to
+dnl PKG_CHECK_MODULES_STATIC might not happen, you should be sure to
+dnl include an explicit call to PKG_PROG_PKG_CONFIG in your
+dnl configure.ac.
+AC_DEFUN([PKG_CHECK_MODULES_STATIC],
+[AC_REQUIRE([PKG_PROG_PKG_CONFIG])dnl
+_save_PKG_CONFIG=$PKG_CONFIG
+PKG_CONFIG="$PKG_CONFIG --static"
+PKG_CHECK_MODULES($@)
+PKG_CONFIG=$_save_PKG_CONFIG[]dnl
+])dnl PKG_CHECK_MODULES_STATIC
+
+
+dnl PKG_INSTALLDIR([DIRECTORY])
+dnl -------------------------
+dnl Since: 0.27
+dnl
+dnl Substitutes the variable pkgconfigdir as the location where a module
+dnl should install pkg-config .pc files. By default the directory is
+dnl $libdir/pkgconfig, but the default can be changed by passing
+dnl DIRECTORY. The user can override through the --with-pkgconfigdir
+dnl parameter.
+AC_DEFUN([PKG_INSTALLDIR],
+[m4_pushdef([pkg_default], [m4_default([$1], ['${libdir}/pkgconfig'])])
+m4_pushdef([pkg_description],
+ [pkg-config installation directory @<:@]pkg_default[@:>@])
+AC_ARG_WITH([pkgconfigdir],
+ [AS_HELP_STRING([--with-pkgconfigdir], pkg_description)],,
+ [with_pkgconfigdir=]pkg_default)
+AC_SUBST([pkgconfigdir], [$with_pkgconfigdir])
+m4_popdef([pkg_default])
+m4_popdef([pkg_description])
+])dnl PKG_INSTALLDIR
+
+
+dnl PKG_NOARCH_INSTALLDIR([DIRECTORY])
+dnl --------------------------------
+dnl Since: 0.27
+dnl
+dnl Substitutes the variable noarch_pkgconfigdir as the location where a
+dnl module should install arch-independent pkg-config .pc files. By
+dnl default the directory is $datadir/pkgconfig, but the default can be
+dnl changed by passing DIRECTORY. The user can override through the
+dnl --with-noarch-pkgconfigdir parameter.
+AC_DEFUN([PKG_NOARCH_INSTALLDIR],
+[m4_pushdef([pkg_default], [m4_default([$1], ['${datadir}/pkgconfig'])])
+m4_pushdef([pkg_description],
+ [pkg-config arch-independent installation directory @<:@]pkg_default[@:>@])
+AC_ARG_WITH([noarch-pkgconfigdir],
+ [AS_HELP_STRING([--with-noarch-pkgconfigdir], pkg_description)],,
+ [with_noarch_pkgconfigdir=]pkg_default)
+AC_SUBST([noarch_pkgconfigdir], [$with_noarch_pkgconfigdir])
+m4_popdef([pkg_default])
+m4_popdef([pkg_description])
+])dnl PKG_NOARCH_INSTALLDIR
+
+
+dnl PKG_CHECK_VAR(VARIABLE, MODULE, CONFIG-VARIABLE,
+dnl [ACTION-IF-FOUND], [ACTION-IF-NOT-FOUND])
+dnl -------------------------------------------
+dnl Since: 0.28
+dnl
+dnl Retrieves the value of the pkg-config variable for the given module.
+AC_DEFUN([PKG_CHECK_VAR],
+[AC_REQUIRE([PKG_PROG_PKG_CONFIG])dnl
+AC_ARG_VAR([$1], [value of $3 for $2, overriding pkg-config])dnl
+
+_PKG_CONFIG([$1], [variable="][$3]["], [$2])
+AS_VAR_COPY([$1], [pkg_cv_][$1])
+
+AS_VAR_IF([$1], [""], [$5], [$4])dnl
+])dnl PKG_CHECK_VAR
diff --git a/subprojects/c-ares/maketgz b/subprojects/c-ares/maketgz
@@ -0,0 +1,71 @@
+#!/usr/bin/env perl
+# Copyright (C) Daniel Stenberg
+# SPDX-License-Identifier: MIT
+
+$version = $ARGV[0];
+
+if($version eq "") {
+ print "Enter version number!\n";
+ exit;
+}
+
+if(!-f "include/ares.h") {
+ print "run this script in the ares source root dir\n";
+ exit;
+}
+
+my ($major, $minor, $patch)=split(/\./, $version);
+
+$major += 0;
+$minor += 0;
+$patch += 0;
+
+open(VER, "<include/ares_version.h") ||
+ die "can't open include/ares_version.h";
+open(NEWV, ">include/ares_version.h.dist");
+while(<VER>) {
+ $_ =~ s/^\#define ARES_VERSION_MAJOR .*/\#define ARES_VERSION_MAJOR $major/;
+ $_ =~ s/^\#define ARES_VERSION_MINOR .*/\#define ARES_VERSION_MINOR $minor/;
+ $_ =~ s/^\#define ARES_VERSION_PATCH .*/\#define ARES_VERSION_PATCH $patch/;
+ $_ =~ s/^\#define ARES_VERSION_STR .*/\#define ARES_VERSION_STR \"$version\"/;
+
+ print NEWV $_;
+}
+close(VER);
+close(NEWV);
+print "include/ares_version.h.dist created\n";
+
+if(!-f "configure") {
+ print "running buildconf\n";
+ `./buildconf`;
+}
+print "adding $version in the configure.ac file\n";
+`sed -e 's/AC_INIT.*/AC_INIT([c-ares], [$version],/' < configure.ac > configure.ac.dist`;
+
+print "adding $version in the CMakeLists.txt file\n";
+`sed -e 's/SET.*CARES_VERSION.*/SET (CARES_VERSION "$version")/' < CMakeLists.txt > CMakeLists.txt.dist && rm -f CMakeLists.txt && mv CMakeLists.txt.dist CMakeLists.txt`;
+
+# now make a new configure script with this
+print "makes a new configure script\n";
+`autoconf configure.ac.dist >configure`;
+
+# now run this new configure to get a fine makefile
+print "running configure\n";
+`./configure`;
+
+print "produce CHANGES\n";
+`git log --pretty=fuller --no-color --date=short --decorate=full -1000 | ./git2changes.pl > CHANGES.dist`;
+
+# now make the actual tarball
+print "running make dist\n";
+`make dist VERSION=$version`;
+
+# remove temporary sourced man pages
+`make -s clean-sourced-manpages`;
+
+print "removing temporary configure.ac file\n";
+`rm configure.ac.dist`;
+print "removing temporary ares_version.h file\n";
+`rm include/ares_version.h.dist`;
+
+print "NOTE: now tag this release!\n";
diff --git a/subprojects/c-ares/msvc_ver.inc b/subprojects/c-ares/msvc_ver.inc
@@ -0,0 +1,26 @@
+# Copyright (C) The c-ares project and its contributors
+# SPDX-License-Identifier: MIT
+# -----------------------------------------------
+# Detect NMAKE version deducing old MSVC versions
+# -----------------------------------------------
+
+!IFNDEF _NMAKE_VER
+! MESSAGE Macro _NMAKE_VER not defined.
+! MESSAGE Use MSVC's NMAKE to process this makefile.
+! ERROR See previous message.
+!ENDIF
+
+!IF "$(_NMAKE_VER)" == "6.00.8168.0"
+CC_VERS_NUM = 60
+!ELSEIF "$(_NMAKE_VER)" == "6.00.9782.0"
+CC_VERS_NUM = 60
+!ELSEIF "$(_NMAKE_VER)" == "7.00.8882"
+CC_VERS_NUM = 70
+!ELSEIF "$(_NMAKE_VER)" == "7.00.9466"
+CC_VERS_NUM = 70
+!ELSEIF "$(_NMAKE_VER)" == "7.00.9955"
+CC_VERS_NUM = 70
+!ELSE
+# Pick an arbitrary bigger number for all later versions
+CC_VERS_NUM = 199
+!ENDIF
diff --git a/subprojects/c-ares/sonar-project.properties b/subprojects/c-ares/sonar-project.properties
@@ -0,0 +1,33 @@
+# Copyright (C) The c-ares project and its contributors
+# SPDX-License-Identifier: MIT
+sonar.projectKey=c-ares_c-ares
+sonar.organization=c-ares
+
+# This is the name and version displayed in the SonarCloud UI.
+sonar.projectName=c-ares
+sonar.projectVersion=1.0
+
+# Path is relative to the sonar-project.properties file. Replace "\" by "/" on Windows.
+sonar.sources=src/lib, src/tools
+sonar.tests=test/
+sonar.exclusions=test/
+
+# Encoding of the source code. Default is default system encoding
+sonar.sourceEncoding=UTF-8
+
+
+sonar.issue.ignore.multicriteria=m1,m2,m3
+# c:S5955 Loop variables should be declared in the minimal possible scope
+# Not possible in C89
+sonar.issue.ignore.multicriteria.m1.ruleKey=c:S5955
+sonar.issue.ignore.multicriteria.m1.resourceKey=**/*
+
+# c:S924 Reduce the number of nested "goto" statements from 2 to 1 authorized.
+# This is a common practice in error handling, don't understand this recommendation.
+sonar.issue.ignore.multicriteria.m2.ruleKey=c:S924
+sonar.issue.ignore.multicriteria.m2.resourceKey=**/*
+
+# php:S105 Tabulation characters should not be used
+# Required for MSVC Makefiles
+sonar.issue.ignore.multicriteria.m3.ruleKey=php:S105
+sonar.issue.ignore.multicriteria.m3.resourceKey=**/Makefile.inc
diff --git a/subprojects/c-ares/src/CMakeLists.txt b/subprojects/c-ares/src/CMakeLists.txt
@@ -0,0 +1,4 @@
+# Copyright (C) The c-ares project and its contributors
+# SPDX-License-Identifier: MIT
+ADD_SUBDIRECTORY (lib)
+ADD_SUBDIRECTORY (tools)
diff --git a/subprojects/c-ares/src/Makefile.am b/subprojects/c-ares/src/Makefile.am
@@ -0,0 +1,4 @@
+# Copyright (C) The c-ares project and its contributors
+# SPDX-License-Identifier: MIT
+EXTRA_DIST=CMakeLists.txt
+SUBDIRS=lib tools
diff --git a/subprojects/c-ares/src/lib/CMakeLists.txt b/subprojects/c-ares/src/lib/CMakeLists.txt
@@ -0,0 +1,136 @@
+# Copyright (C) The c-ares project and its contributors
+# SPDX-License-Identifier: MIT
+
+# Transform Makefile.inc
+transform_makefile_inc("Makefile.inc" "${PROJECT_BINARY_DIR}/src/lib/Makefile.inc.cmake")
+include(${PROJECT_BINARY_DIR}/src/lib/Makefile.inc.cmake)
+
+# Write ares_config.h configuration file. This is used only for the build.
+CONFIGURE_FILE (ares_config.h.cmake ${PROJECT_BINARY_DIR}/ares_config.h)
+
+# Build the dynamic/shared library
+IF (CARES_SHARED)
+ ADD_LIBRARY (${PROJECT_NAME} SHARED ${CSOURCES})
+
+ # Include resource file in windows builds for versioned DLLs
+ IF (WIN32)
+ TARGET_SOURCES (${PROJECT_NAME} PRIVATE cares.rc)
+ ENDIF()
+
+ # Convert CARES_LIB_VERSIONINFO libtool version format into VERSION and SOVERSION
+ # Convert from ":" separated into CMake list format using ";"
+ STRING (REPLACE ":" ";" CARES_LIB_VERSIONINFO ${CARES_LIB_VERSIONINFO})
+ LIST (GET CARES_LIB_VERSIONINFO 0 CARES_LIB_VERSION_CURRENT)
+ LIST (GET CARES_LIB_VERSIONINFO 1 CARES_LIB_VERSION_REVISION)
+ LIST (GET CARES_LIB_VERSIONINFO 2 CARES_LIB_VERSION_AGE)
+ MATH (EXPR CARES_LIB_VERSION_MAJOR "${CARES_LIB_VERSION_CURRENT} - ${CARES_LIB_VERSION_AGE}")
+ SET (CARES_LIB_VERSION_MINOR "${CARES_LIB_VERSION_AGE}")
+ SET (CARES_LIB_VERSION_RELEASE "${CARES_LIB_VERSION_REVISION}")
+
+ SET_TARGET_PROPERTIES (${PROJECT_NAME} PROPERTIES
+ EXPORT_NAME cares
+ OUTPUT_NAME cares
+ COMPILE_PDB_NAME cares
+ COMPILE_PDB_OUTPUT_DIRECTORY ${CMAKE_RUNTIME_OUTPUT_DIRECTORY}
+ SOVERSION ${CARES_LIB_VERSION_MAJOR}
+ VERSION "${CARES_LIB_VERSION_MAJOR}.${CARES_LIB_VERSION_MINOR}.${CARES_LIB_VERSION_RELEASE}"
+ C_STANDARD 90
+ )
+
+ IF (CARES_SYMBOL_HIDING)
+ SET_TARGET_PROPERTIES (${PROJECT_NAME} PROPERTIES
+ C_VISIBILITY_PRESET hidden
+ VISIBILITY_INLINES_HIDDEN YES
+ )
+ ENDIF ()
+
+ TARGET_INCLUDE_DIRECTORIES (${PROJECT_NAME}
+ PUBLIC "$<BUILD_INTERFACE:${PROJECT_BINARY_DIR}>"
+ "$<BUILD_INTERFACE:${PROJECT_SOURCE_DIR}>"
+ "$<BUILD_INTERFACE:${CARES_TOPLEVEL_DIR}/include>"
+ "$<INSTALL_INTERFACE:${CMAKE_INSTALL_INCLUDEDIR}>"
+ PRIVATE "${CMAKE_CURRENT_SOURCE_DIR}"
+ )
+
+ TARGET_COMPILE_DEFINITIONS (${PROJECT_NAME} PRIVATE HAVE_CONFIG_H=1 CARES_BUILDING_LIBRARY)
+
+ TARGET_LINK_LIBRARIES (${PROJECT_NAME}
+ PUBLIC ${CARES_DEPENDENT_LIBS}
+ PRIVATE ${CMAKE_THREAD_LIBS_INIT}
+ )
+
+ IF (CARES_INSTALL)
+ INSTALL (TARGETS ${PROJECT_NAME}
+ EXPORT ${PROJECT_NAME}-targets
+ COMPONENT Library
+ ${TARGETS_INST_DEST}
+ )
+ INSTALL(FILES ${CMAKE_RUNTIME_OUTPUT_DIRECTORY}/cares.pdb
+ DESTINATION ${CMAKE_INSTALL_BINDIR}
+ COMPONENT Library
+ OPTIONAL
+ )
+ ENDIF ()
+ SET (STATIC_SUFFIX "_static")
+
+ # For chain building: add alias targets that look like import libs that would be returned by find_package(c-ares).
+ ADD_LIBRARY (${PROJECT_NAME}::cares_shared ALIAS ${PROJECT_NAME})
+ ADD_LIBRARY (${PROJECT_NAME}::cares ALIAS ${PROJECT_NAME})
+ENDIF ()
+
+# Build the static library
+IF (CARES_STATIC)
+ SET (LIBNAME ${PROJECT_NAME}${STATIC_SUFFIX})
+
+ ADD_LIBRARY (${LIBNAME} STATIC ${CSOURCES})
+
+ SET_TARGET_PROPERTIES (${LIBNAME} PROPERTIES
+ EXPORT_NAME cares${STATIC_SUFFIX}
+ OUTPUT_NAME cares${STATIC_SUFFIX}
+ COMPILE_PDB_NAME cares${STATIC_SUFFIX}
+ COMPILE_PDB_OUTPUT_DIRECTORY ${CMAKE_RUNTIME_OUTPUT_DIRECTORY}
+ C_STANDARD 90
+ )
+
+ IF (CARES_STATIC_PIC)
+ SET_TARGET_PROPERTIES (${LIBNAME} PROPERTIES POSITION_INDEPENDENT_CODE True)
+ ENDIF ()
+
+ TARGET_INCLUDE_DIRECTORIES (${LIBNAME}
+ PUBLIC "$<BUILD_INTERFACE:${PROJECT_BINARY_DIR}>"
+ "$<BUILD_INTERFACE:${PROJECT_SOURCE_DIR}>"
+ "$<BUILD_INTERFACE:${CARES_TOPLEVEL_DIR}/include>"
+ "$<INSTALL_INTERFACE:${CMAKE_INSTALL_INCLUDEDIR}>"
+ PRIVATE "${CMAKE_CURRENT_SOURCE_DIR}"
+ )
+
+ TARGET_COMPILE_DEFINITIONS (${LIBNAME} PRIVATE HAVE_CONFIG_H=1 CARES_BUILDING_LIBRARY)
+
+ # Only matters on Windows
+ IF (WIN32 OR CYGWIN)
+ TARGET_COMPILE_DEFINITIONS (${LIBNAME} PUBLIC CARES_STATICLIB)
+ ENDIF()
+
+ TARGET_LINK_LIBRARIES (${LIBNAME} PUBLIC ${CARES_DEPENDENT_LIBS})
+ IF (CARES_INSTALL)
+ INSTALL (TARGETS ${LIBNAME} EXPORT ${PROJECT_NAME}-targets COMPONENT Devel
+ ${TARGETS_INST_DEST}
+ )
+ INSTALL(FILES ${CMAKE_RUNTIME_OUTPUT_DIRECTORY}/cares${STATIC_SUFFIX}.pdb
+ DESTINATION ${CMAKE_INSTALL_BINDIR}
+ COMPONENT Library
+ OPTIONAL
+ )
+ ENDIF ()
+
+ # For chain building: add alias targets that look like import libs that would be returned by find_package(c-ares).
+ ADD_LIBRARY (${PROJECT_NAME}::cares_static ALIAS ${LIBNAME})
+ IF (NOT TARGET ${PROJECT_NAME}::cares)
+ # Only use static for the generic alias if shared lib wasn't built.
+ ADD_LIBRARY (${PROJECT_NAME}::cares ALIAS ${LIBNAME})
+ ENDIF ()
+ENDIF ()
+
+
+
+
diff --git a/subprojects/c-ares/src/lib/Makefile.am b/subprojects/c-ares/src/lib/Makefile.am
@@ -0,0 +1,56 @@
+# Copyright (C) The c-ares project and its contributors
+# SPDX-License-Identifier: MIT
+AUTOMAKE_OPTIONS = foreign subdir-objects nostdinc 1.9.6
+ACLOCAL_AMFLAGS = -I m4 --install
+
+# Specify our include paths here, and do it relative to $(top_srcdir) and
+# $(top_builddir), to ensure that these paths which belong to the library
+# being currently built and tested are searched before the library which
+# might possibly already be installed in the system.
+
+AM_CPPFLAGS = -I$(top_builddir)/include \
+ -I$(top_builddir)/src/lib \
+ -I$(top_srcdir)/include \
+ -I$(top_srcdir)/src/lib
+
+lib_LTLIBRARIES = libcares.la
+
+man_MANS = $(MANPAGES)
+
+# adig and ahost are just sample programs and thus not mentioned with the
+# regular sources and headers
+EXTRA_DIST = Makefile.inc config-win32.h CMakeLists.txt \
+ ares_config.h.in ares_config.h.cmake cares.rc \
+ $(CSOURCES) $(HHEADERS) config-dos.h
+
+DISTCLEANFILES = ares_config.h
+
+DIST_SUBDIRS =
+
+libcares_la_LDFLAGS = -version-info @CARES_VERSION_INFO@
+if CARES_USE_NO_UNDEFINED
+libcares_la_LDFLAGS += -no-undefined
+endif
+
+libcares_la_CFLAGS_EXTRA =
+
+libcares_la_CPPFLAGS_EXTRA = -DCARES_BUILDING_LIBRARY
+
+if CARES_SYMBOL_HIDING
+libcares_la_CFLAGS_EXTRA += @CARES_SYMBOL_HIDING_CFLAG@
+libcares_la_CPPFLAGS_EXTRA += -DCARES_SYMBOL_HIDING
+endif
+
+include $(top_srcdir)/aminclude_static.am
+libcares_la_LIBS = $(CODE_COVERAGE_LIBS)
+libcares_la_CFLAGS_EXTRA += $(CODE_COVERAGE_CFLAGS)
+libcares_la_CPPFLAGS_EXTRA += $(CODE_COVERAGE_CPPFLAGS)
+
+libcares_la_CFLAGS = $(AM_CFLAGS) $(libcares_la_CFLAGS_EXTRA)
+
+libcares_la_CPPFLAGS = $(AM_CPPFLAGS) $(libcares_la_CPPFLAGS_EXTRA)
+
+# Makefile.inc provides the CSOURCES and HHEADERS defines
+include Makefile.inc
+
+libcares_la_SOURCES = $(CSOURCES) $(HHEADERS)
diff --git a/subprojects/c-ares/src/lib/Makefile.inc b/subprojects/c-ares/src/lib/Makefile.inc
@@ -0,0 +1,101 @@
+# Copyright (C) The c-ares project and its contributors
+# SPDX-License-Identifier: MIT
+
+CSOURCES = ares__addrinfo2hostent.c \
+ ares__addrinfo_localhost.c \
+ ares__buf.c \
+ ares__close_sockets.c \
+ ares__hosts_file.c \
+ ares__htable.c \
+ ares__htable_asvp.c \
+ ares__htable_strvp.c \
+ ares__htable_szvp.c \
+ ares__iface_ips.c \
+ ares__llist.c \
+ ares__parse_into_addrinfo.c \
+ ares__read_line.c \
+ ares__slist.c \
+ ares__socket.c \
+ ares__sortaddrinfo.c \
+ ares__threads.c \
+ ares__timeval.c \
+ ares_android.c \
+ ares_cancel.c \
+ ares_data.c \
+ ares_destroy.c \
+ ares_dns_mapping.c \
+ ares_dns_name.c \
+ ares_dns_parse.c \
+ ares_dns_record.c \
+ ares_dns_write.c \
+ ares_expand_name.c \
+ ares_expand_string.c \
+ ares_fds.c \
+ ares_free_hostent.c \
+ ares_free_string.c \
+ ares_freeaddrinfo.c \
+ ares_getaddrinfo.c \
+ ares_getenv.c \
+ ares_gethostbyaddr.c \
+ ares_gethostbyname.c \
+ ares_getnameinfo.c \
+ ares_getsock.c \
+ ares_init.c \
+ ares_library_init.c \
+ ares_math.c \
+ ares_mkquery.c \
+ ares_create_query.c \
+ ares_options.c \
+ ares_parse_a_reply.c \
+ ares_parse_aaaa_reply.c \
+ ares_parse_caa_reply.c \
+ ares_parse_mx_reply.c \
+ ares_parse_naptr_reply.c \
+ ares_parse_ns_reply.c \
+ ares_parse_ptr_reply.c \
+ ares_parse_soa_reply.c \
+ ares_parse_srv_reply.c \
+ ares_parse_txt_reply.c \
+ ares_parse_uri_reply.c \
+ ares_platform.c \
+ ares_process.c \
+ ares_qcache.c \
+ ares_query.c \
+ ares_rand.c \
+ ares_search.c \
+ ares_send.c \
+ ares_strcasecmp.c \
+ ares_str.c \
+ ares_strerror.c \
+ ares_strsplit.c \
+ ares_sysconfig.c \
+ ares_sysconfig_files.c \
+ ares_timeout.c \
+ ares_update_servers.c \
+ ares_version.c \
+ inet_net_pton.c \
+ inet_ntop.c \
+ windows_port.c
+
+HHEADERS = ares__buf.h \
+ ares__htable.h \
+ ares__htable_asvp.h \
+ ares__htable_strvp.h \
+ ares__htable_szvp.h \
+ ares__iface_ips.h \
+ ares__llist.h \
+ ares__slist.h \
+ ares_android.h \
+ ares_data.h \
+ ares_dns_private.h \
+ ares_getenv.h \
+ ares_inet_net_pton.h \
+ ares_ipv6.h \
+ ares_platform.h \
+ ares_private.h \
+ ares_strcasecmp.h \
+ ares_str.h \
+ ares_strsplit.h \
+ ares_setup.h \
+ setup_once.h
+
diff --git a/subprojects/c-ares/src/lib/ares__addrinfo2hostent.c b/subprojects/c-ares/src/lib/ares__addrinfo2hostent.c
@@ -0,0 +1,278 @@
+/* MIT License
+ *
+ * Copyright (c) 1998 Massachusetts Institute of Technology
+ * Copyright (c) 2005 Dominick Meglio
+ * Copyright (c) 2019 Andrew Selivanov
+ * Copyright (c) 2021 Brad House
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice (including the next
+ * paragraph) shall be included in all copies or substantial portions of the
+ * Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ *
+ * SPDX-License-Identifier: MIT
+ */
+
+#include "ares_setup.h"
+
+#ifdef HAVE_NETINET_IN_H
+# include <netinet/in.h>
+#endif
+#ifdef HAVE_NETDB_H
+# include <netdb.h>
+#endif
+#ifdef HAVE_ARPA_INET_H
+# include <arpa/inet.h>
+#endif
+
+#include "ares_nameser.h"
+
+#ifdef HAVE_STRINGS_H
+# include <strings.h>
+#endif
+
+#ifdef HAVE_LIMITS_H
+# include <limits.h>
+#endif
+
+#include "ares.h"
+#include "ares_dns.h"
+#include "ares_inet_net_pton.h"
+#include "ares_private.h"
+
+ares_status_t ares__addrinfo2hostent(const struct ares_addrinfo *ai, int family,
+ struct hostent **host)
+{
+ struct ares_addrinfo_node *next;
+ struct ares_addrinfo_cname *next_cname;
+ char **aliases = NULL;
+ char *addrs = NULL;
+ size_t naliases = 0;
+ size_t naddrs = 0;
+ size_t alias = 0;
+ size_t i;
+
+ if (ai == NULL || host == NULL) {
+ return ARES_EBADQUERY;
+ }
+
+ /* Use the first node of the response as the family, since hostent can only
+ * represent one family. We assume getaddrinfo() returned a sorted list if
+ * the user requested AF_UNSPEC. */
+ if (family == AF_UNSPEC && ai->nodes) {
+ family = ai->nodes->ai_family;
+ }
+
+ if (family != AF_INET && family != AF_INET6) {
+ return ARES_EBADQUERY;
+ }
+
+ *host = ares_malloc(sizeof(**host));
+ if (!(*host)) {
+ goto enomem;
+ }
+ memset(*host, 0, sizeof(**host));
+
+ next = ai->nodes;
+ while (next) {
+ if (next->ai_family == family) {
+ ++naddrs;
+ }
+ next = next->ai_next;
+ }
+
+ next_cname = ai->cnames;
+ while (next_cname) {
+ if (next_cname->alias) {
+ ++naliases;
+ }
+ next_cname = next_cname->next;
+ }
+
+ aliases = ares_malloc((naliases + 1) * sizeof(char *));
+ if (!aliases) {
+ goto enomem;
+ }
+ (*host)->h_aliases = aliases;
+ memset(aliases, 0, (naliases + 1) * sizeof(char *));
+
+ if (naliases) {
+ for (next_cname = ai->cnames; next_cname != NULL;
+ next_cname = next_cname->next) {
+ if (next_cname->alias == NULL) {
+ continue;
+ }
+ aliases[alias] = ares_strdup(next_cname->alias);
+ if (!aliases[alias]) {
+ goto enomem;
+ }
+ alias++;
+ }
+ }
+
+
+ (*host)->h_addr_list = ares_malloc((naddrs + 1) * sizeof(char *));
+ if (!(*host)->h_addr_list) {
+ goto enomem;
+ }
+
+ memset((*host)->h_addr_list, 0, (naddrs + 1) * sizeof(char *));
+
+ if (ai->cnames) {
+ (*host)->h_name = ares_strdup(ai->cnames->name);
+ if ((*host)->h_name == NULL && ai->cnames->name) {
+ goto enomem;
+ }
+ } else {
+ (*host)->h_name = ares_strdup(ai->name);
+ if ((*host)->h_name == NULL && ai->name) {
+ goto enomem;
+ }
+ }
+
+ (*host)->h_addrtype = (HOSTENT_ADDRTYPE_TYPE)family;
+
+ if (family == AF_INET) {
+ (*host)->h_length = sizeof(struct in_addr);
+ }
+
+ if (family == AF_INET6) {
+ (*host)->h_length = sizeof(struct ares_in6_addr);
+ }
+
+ if (naddrs) {
+ addrs = ares_malloc(naddrs * (size_t)(*host)->h_length);
+ if (!addrs) {
+ goto enomem;
+ }
+
+ i = 0;
+ for (next = ai->nodes; next != NULL; next = next->ai_next) {
+ if (next->ai_family != family) {
+ continue;
+ }
+ (*host)->h_addr_list[i] = addrs + (i * (size_t)(*host)->h_length);
+ if (family == AF_INET6) {
+ memcpy(
+ (*host)->h_addr_list[i],
+ &(CARES_INADDR_CAST(struct sockaddr_in6 *, next->ai_addr)->sin6_addr),
+ (size_t)(*host)->h_length);
+ }
+ if (family == AF_INET) {
+ memcpy(
+ (*host)->h_addr_list[i],
+ &(CARES_INADDR_CAST(struct sockaddr_in *, next->ai_addr)->sin_addr),
+ (size_t)(*host)->h_length);
+ }
+ ++i;
+ }
+
+ if (i == 0) {
+ ares_free(addrs);
+ }
+ }
+
+ if (naddrs == 0 && naliases == 0) {
+ ares_free_hostent(*host);
+ *host = NULL;
+ return ARES_ENODATA;
+ }
+
+ return ARES_SUCCESS;
+
+enomem:
+ ares_free_hostent(*host);
+ *host = NULL;
+ return ARES_ENOMEM;
+}
+
+ares_status_t ares__addrinfo2addrttl(const struct ares_addrinfo *ai, int family,
+ size_t req_naddrttls,
+ struct ares_addrttl *addrttls,
+ struct ares_addr6ttl *addr6ttls,
+ size_t *naddrttls)
+{
+ struct ares_addrinfo_node *next;
+ struct ares_addrinfo_cname *next_cname;
+ int cname_ttl = INT_MAX;
+
+ if (family != AF_INET && family != AF_INET6) {
+ return ARES_EBADQUERY;
+ }
+
+ if (ai == NULL || naddrttls == NULL) {
+ return ARES_EBADQUERY;
+ }
+
+ if (family == AF_INET && addrttls == NULL) {
+ return ARES_EBADQUERY;
+ }
+
+ if (family == AF_INET6 && addr6ttls == NULL) {
+ return ARES_EBADQUERY;
+ }
+
+ if (req_naddrttls == 0) {
+ return ARES_EBADQUERY;
+ }
+
+ *naddrttls = 0;
+
+ next_cname = ai->cnames;
+ while (next_cname) {
+ if (next_cname->ttl < cname_ttl) {
+ cname_ttl = next_cname->ttl;
+ }
+ next_cname = next_cname->next;
+ }
+
+ for (next = ai->nodes; next != NULL; next = next->ai_next) {
+ if (next->ai_family != family) {
+ continue;
+ }
+
+ if (*naddrttls >= req_naddrttls) {
+ break;
+ }
+
+ if (family == AF_INET6) {
+ if (next->ai_ttl > cname_ttl) {
+ addr6ttls[*naddrttls].ttl = cname_ttl;
+ } else {
+ addr6ttls[*naddrttls].ttl = next->ai_ttl;
+ }
+
+ memcpy(
+ &addr6ttls[*naddrttls].ip6addr,
+ &(CARES_INADDR_CAST(struct sockaddr_in6 *, next->ai_addr)->sin6_addr),
+ sizeof(struct ares_in6_addr));
+ } else {
+ if (next->ai_ttl > cname_ttl) {
+ addrttls[*naddrttls].ttl = cname_ttl;
+ } else {
+ addrttls[*naddrttls].ttl = next->ai_ttl;
+ }
+ memcpy(
+ &addrttls[*naddrttls].ipaddr,
+ &(CARES_INADDR_CAST(struct sockaddr_in *, next->ai_addr)->sin_addr),
+ sizeof(struct in_addr));
+ }
+ (*naddrttls)++;
+ }
+
+ return ARES_SUCCESS;
+}
diff --git a/subprojects/c-ares/src/lib/ares__addrinfo_localhost.c b/subprojects/c-ares/src/lib/ares__addrinfo_localhost.c
@@ -0,0 +1,236 @@
+/* MIT License
+ *
+ * Copyright (c) Massachusetts Institute of Technology
+ * Copyright (c) Daniel Stenberg
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice (including the next
+ * paragraph) shall be included in all copies or substantial portions of the
+ * Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ *
+ * SPDX-License-Identifier: MIT
+ */
+
+#include "ares_setup.h"
+
+#ifdef HAVE_NETINET_IN_H
+# include <netinet/in.h>
+#endif
+#ifdef HAVE_NETDB_H
+# include <netdb.h>
+#endif
+#ifdef HAVE_ARPA_INET_H
+# include <arpa/inet.h>
+#endif
+
+#if defined(_WIN32) && defined(_WIN32_WINNT) && _WIN32_WINNT >= 0x0600
+# include <ws2ipdef.h>
+#endif
+
+#if defined(USE_WINSOCK)
+# if defined(HAVE_IPHLPAPI_H)
+# include <iphlpapi.h>
+# endif
+# if defined(HAVE_NETIOAPI_H)
+# include <netioapi.h>
+# endif
+#endif
+
+#include "ares.h"
+#include "ares_inet_net_pton.h"
+#include "ares_private.h"
+
+ares_status_t ares_append_ai_node(int aftype, unsigned short port,
+ unsigned int ttl, const void *adata,
+ struct ares_addrinfo_node **nodes)
+{
+ struct ares_addrinfo_node *node;
+
+ node = ares__append_addrinfo_node(nodes);
+ if (!node) {
+ return ARES_ENOMEM;
+ }
+
+ memset(node, 0, sizeof(*node));
+
+ if (aftype == AF_INET) {
+ struct sockaddr_in *sin = ares_malloc(sizeof(*sin));
+ if (!sin) {
+ return ARES_ENOMEM;
+ }
+
+ memset(sin, 0, sizeof(*sin));
+ memcpy(&sin->sin_addr.s_addr, adata, sizeof(sin->sin_addr.s_addr));
+ sin->sin_family = AF_INET;
+ sin->sin_port = htons(port);
+
+ node->ai_addr = (struct sockaddr *)sin;
+ node->ai_family = AF_INET;
+ node->ai_addrlen = sizeof(*sin);
+ node->ai_addr = (struct sockaddr *)sin;
+ node->ai_ttl = (int)ttl;
+ }
+
+ if (aftype == AF_INET6) {
+ struct sockaddr_in6 *sin6 = ares_malloc(sizeof(*sin6));
+ if (!sin6) {
+ return ARES_ENOMEM;
+ }
+
+ memset(sin6, 0, sizeof(*sin6));
+ memcpy(&sin6->sin6_addr.s6_addr, adata, sizeof(sin6->sin6_addr.s6_addr));
+ sin6->sin6_family = AF_INET6;
+ sin6->sin6_port = htons(port);
+
+ node->ai_addr = (struct sockaddr *)sin6;
+ node->ai_family = AF_INET6;
+ node->ai_addrlen = sizeof(*sin6);
+ node->ai_addr = (struct sockaddr *)sin6;
+ node->ai_ttl = (int)ttl;
+ }
+
+ return ARES_SUCCESS;
+}
+
+static ares_status_t
+ ares__default_loopback_addrs(int aftype, unsigned short port,
+ struct ares_addrinfo_node **nodes)
+{
+ ares_status_t status = ARES_SUCCESS;
+
+ if (aftype == AF_UNSPEC || aftype == AF_INET6) {
+ struct ares_in6_addr addr6;
+ ares_inet_pton(AF_INET6, "::1", &addr6);
+ status = ares_append_ai_node(AF_INET6, port, 0, &addr6, nodes);
+ if (status != ARES_SUCCESS) {
+ return status;
+ }
+ }
+
+ if (aftype == AF_UNSPEC || aftype == AF_INET) {
+ struct in_addr addr4;
+ ares_inet_pton(AF_INET, "127.0.0.1", &addr4);
+ status = ares_append_ai_node(AF_INET, port, 0, &addr4, nodes);
+ if (status != ARES_SUCCESS) {
+ return status;
+ }
+ }
+
+ return status;
+}
+
+static ares_status_t
+ ares__system_loopback_addrs(int aftype, unsigned short port,
+ struct ares_addrinfo_node **nodes)
+{
+#if defined(_WIN32) && defined(_WIN32_WINNT) && _WIN32_WINNT >= 0x0600 && \
+ !defined(__WATCOMC__)
+ PMIB_UNICASTIPADDRESS_TABLE table;
+ unsigned int i;
+ ares_status_t status;
+
+ *nodes = NULL;
+
+ if (GetUnicastIpAddressTable((ADDRESS_FAMILY)aftype, &table) != NO_ERROR) {
+ return ARES_ENOTFOUND;
+ }
+
+ for (i = 0; i < table->NumEntries; i++) {
+ if (table->Table[i].InterfaceLuid.Info.IfType !=
+ IF_TYPE_SOFTWARE_LOOPBACK) {
+ continue;
+ }
+
+ if (table->Table[i].Address.si_family == AF_INET) {
+ status =
+ ares_append_ai_node(table->Table[i].Address.si_family, port, 0,
+ &table->Table[i].Address.Ipv4.sin_addr, nodes);
+ } else if (table->Table[i].Address.si_family == AF_INET6) {
+ status =
+ ares_append_ai_node(table->Table[i].Address.si_family, port, 0,
+ &table->Table[i].Address.Ipv6.sin6_addr, nodes);
+ } else {
+ /* Ignore any others */
+ continue;
+ }
+
+ if (status != ARES_SUCCESS) {
+ goto fail;
+ }
+ }
+
+ if (*nodes == NULL) {
+ status = ARES_ENOTFOUND;
+ }
+
+fail:
+ FreeMibTable(table);
+
+ if (status != ARES_SUCCESS) {
+ ares__freeaddrinfo_nodes(*nodes);
+ *nodes = NULL;
+ }
+
+ return status;
+
+#else
+ (void)aftype;
+ (void)port;
+ (void)nodes;
+ /* Not supported on any other OS at this time */
+ return ARES_ENOTFOUND;
+#endif
+}
+
+ares_status_t ares__addrinfo_localhost(const char *name, unsigned short port,
+ const struct ares_addrinfo_hints *hints,
+ struct ares_addrinfo *ai)
+{
+ struct ares_addrinfo_node *nodes = NULL;
+ ares_status_t status;
+
+ /* Validate family */
+ switch (hints->ai_family) {
+ case AF_INET:
+ case AF_INET6:
+ case AF_UNSPEC:
+ break;
+ default:
+ return ARES_EBADFAMILY;
+ }
+
+ ai->name = ares_strdup(name);
+ if (!ai->name) {
+ goto enomem;
+ }
+
+ status = ares__system_loopback_addrs(hints->ai_family, port, &nodes);
+
+ if (status == ARES_ENOTFOUND) {
+ status = ares__default_loopback_addrs(hints->ai_family, port, &nodes);
+ }
+
+ ares__addrinfo_cat_nodes(&ai->nodes, nodes);
+
+ return status;
+
+enomem:
+ ares__freeaddrinfo_nodes(nodes);
+ ares_free(ai->name);
+ ai->name = NULL;
+ return ARES_ENOMEM;
+}
diff --git a/subprojects/c-ares/src/lib/ares__buf.c b/subprojects/c-ares/src/lib/ares__buf.c
@@ -0,0 +1,1152 @@
+/* MIT License
+ *
+ * Copyright (c) 2023 Brad House
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice (including the next
+ * paragraph) shall be included in all copies or substantial portions of the
+ * Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ *
+ * SPDX-License-Identifier: MIT
+ */
+#include "ares_setup.h"
+#include "ares.h"
+#include "ares_private.h"
+#include "ares__buf.h"
+#include <limits.h>
+#ifdef HAVE_STDINT_H
+# include <stdint.h>
+#endif
+
+struct ares__buf {
+ const unsigned char *data; /*!< pointer to start of data buffer */
+ size_t data_len; /*!< total size of data in buffer */
+
+ unsigned char *alloc_buf; /*!< Pointer to allocated data buffer,
+ * not used for const buffers */
+ size_t alloc_buf_len; /*!< Size of allocated data buffer */
+
+ size_t offset; /*!< Current working offset in buffer */
+ size_t tag_offset; /*!< Tagged offset in buffer. Uses
+ * SIZE_MAX if not set. */
+};
+
+ares_bool_t ares__isprint(int ch)
+{
+ if (ch >= 0x20 && ch <= 0x7E) {
+ return ARES_TRUE;
+ }
+ return ARES_FALSE;
+}
+
+/* Character set allowed by hostnames. This is to include the normal
+ * domain name character set plus:
+ * - underscores which are used in SRV records.
+ * - Forward slashes such as are used for classless in-addr.arpa
+ * delegation (CNAMEs)
+ * - Asterisks may be used for wildcard domains in CNAMEs as seen in the
+ * real world.
+ * While RFC 2181 section 11 does state not to do validation,
+ * that applies to servers, not clients. Vulnerabilities have been
+ * reported when this validation is not performed. Security is more
+ * important than edge-case compatibility (which is probably invalid
+ * anyhow). */
+ares_bool_t ares__is_hostnamech(int ch)
+{
+ /* [A-Za-z0-9-*._/]
+ * Don't use isalnum() as it is locale-specific
+ */
+ if (ch >= 'A' && ch <= 'Z') {
+ return ARES_TRUE;
+ }
+ if (ch >= 'a' && ch <= 'z') {
+ return ARES_TRUE;
+ }
+ if (ch >= '0' && ch <= '9') {
+ return ARES_TRUE;
+ }
+ if (ch == '-' || ch == '.' || ch == '_' || ch == '/' || ch == '*') {
+ return ARES_TRUE;
+ }
+
+ return ARES_FALSE;
+}
+
+ares__buf_t *ares__buf_create(void)
+{
+ ares__buf_t *buf = ares_malloc_zero(sizeof(*buf));
+ if (buf == NULL) {
+ return NULL;
+ }
+
+ buf->tag_offset = SIZE_MAX;
+ return buf;
+}
+
+ares__buf_t *ares__buf_create_const(const unsigned char *data, size_t data_len)
+{
+ ares__buf_t *buf;
+
+ if (data == NULL || data_len == 0) {
+ return NULL;
+ }
+
+ buf = ares__buf_create();
+ if (buf == NULL) {
+ return NULL;
+ }
+
+ buf->data = data;
+ buf->data_len = data_len;
+
+ return buf;
+}
+
+void ares__buf_destroy(ares__buf_t *buf)
+{
+ if (buf == NULL) {
+ return;
+ }
+ ares_free(buf->alloc_buf);
+ ares_free(buf);
+}
+
+static ares_bool_t ares__buf_is_const(const ares__buf_t *buf)
+{
+ if (buf == NULL) {
+ return ARES_FALSE;
+ }
+
+ if (buf->data != NULL && buf->alloc_buf == NULL) {
+ return ARES_TRUE;
+ }
+
+ return ARES_FALSE;
+}
+
+void ares__buf_reclaim(ares__buf_t *buf)
+{
+ size_t prefix_size;
+ size_t data_size;
+
+ if (buf == NULL) {
+ return;
+ }
+
+ if (ares__buf_is_const(buf)) {
+ return;
+ }
+
+ /* Silence coverity. All lengths are zero so would bail out later but
+ * coverity doesn't know this */
+ if (buf->alloc_buf == NULL) {
+ return;
+ }
+
+ if (buf->tag_offset != SIZE_MAX && buf->tag_offset < buf->offset) {
+ prefix_size = buf->tag_offset;
+ } else {
+ prefix_size = buf->offset;
+ }
+
+ if (prefix_size == 0) {
+ return;
+ }
+
+ data_size = buf->data_len - prefix_size;
+
+ memmove(buf->alloc_buf, buf->alloc_buf + prefix_size, data_size);
+ buf->data = buf->alloc_buf;
+ buf->data_len = data_size;
+ buf->offset -= prefix_size;
+ if (buf->tag_offset != SIZE_MAX) {
+ buf->tag_offset -= prefix_size;
+ }
+
+ return;
+}
+
+static ares_status_t ares__buf_ensure_space(ares__buf_t *buf,
+ size_t needed_size)
+{
+ size_t remaining_size;
+ size_t alloc_size;
+ unsigned char *ptr;
+
+ if (buf == NULL) {
+ return ARES_EFORMERR;
+ }
+
+ if (ares__buf_is_const(buf)) {
+ return ARES_EFORMERR;
+ }
+
+ /* When calling ares__buf_finish_str() we end up adding a null terminator,
+ * so we want to ensure the size is always sufficient for this as we don't
+ * want an ARES_ENOMEM at that point */
+ needed_size++;
+
+ /* No need to do an expensive move operation, we have enough to just append */
+ remaining_size = buf->alloc_buf_len - buf->data_len;
+ if (remaining_size >= needed_size) {
+ return ARES_SUCCESS;
+ }
+
+ /* See if just moving consumed data frees up enough space */
+ ares__buf_reclaim(buf);
+
+ remaining_size = buf->alloc_buf_len - buf->data_len;
+ if (remaining_size >= needed_size) {
+ return ARES_SUCCESS;
+ }
+
+ alloc_size = buf->alloc_buf_len;
+
+ /* Not yet started */
+ if (alloc_size == 0) {
+ alloc_size = 16; /* Always shifts 1, so ends up being 32 minimum */
+ }
+
+ /* Increase allocation by powers of 2 */
+ do {
+ alloc_size <<= 1;
+ remaining_size = alloc_size - buf->data_len;
+ } while (remaining_size < needed_size);
+
+ ptr = ares_realloc(buf->alloc_buf, alloc_size);
+ if (ptr == NULL) {
+ return ARES_ENOMEM;
+ }
+
+ buf->alloc_buf = ptr;
+ buf->alloc_buf_len = alloc_size;
+ buf->data = ptr;
+
+ return ARES_SUCCESS;
+}
+
+ares_status_t ares__buf_set_length(ares__buf_t *buf, size_t len)
+{
+ if (buf == NULL || ares__buf_is_const(buf)) {
+ return ARES_EFORMERR;
+ }
+
+ if (len >= buf->alloc_buf_len - buf->offset) {
+ return ARES_EFORMERR;
+ }
+
+ buf->data_len = len;
+ return ARES_SUCCESS;
+}
+
+ares_status_t ares__buf_append(ares__buf_t *buf, const unsigned char *data,
+ size_t data_len)
+{
+ ares_status_t status;
+
+ if (data == NULL || data_len == 0) {
+ return ARES_EFORMERR;
+ }
+
+ status = ares__buf_ensure_space(buf, data_len);
+ if (status != ARES_SUCCESS) {
+ return status;
+ }
+
+ memcpy(buf->alloc_buf + buf->data_len, data, data_len);
+ buf->data_len += data_len;
+ return ARES_SUCCESS;
+}
+
+ares_status_t ares__buf_append_byte(ares__buf_t *buf, unsigned char byte)
+{
+ return ares__buf_append(buf, &byte, 1);
+}
+
+ares_status_t ares__buf_append_be16(ares__buf_t *buf, unsigned short u16)
+{
+ ares_status_t status;
+
+ status = ares__buf_append_byte(buf, (unsigned char)((u16 >> 8) & 0xff));
+ if (status != ARES_SUCCESS) {
+ return status;
+ }
+
+ status = ares__buf_append_byte(buf, (unsigned char)(u16 & 0xff));
+ if (status != ARES_SUCCESS) {
+ return status;
+ }
+
+ return ARES_SUCCESS;
+}
+
+ares_status_t ares__buf_append_be32(ares__buf_t *buf, unsigned int u32)
+{
+ ares_status_t status;
+
+ status = ares__buf_append_byte(buf, ((unsigned char)(u32 >> 24) & 0xff));
+ if (status != ARES_SUCCESS) {
+ return status;
+ }
+
+ status = ares__buf_append_byte(buf, ((unsigned char)(u32 >> 16) & 0xff));
+ if (status != ARES_SUCCESS) {
+ return status;
+ }
+
+ status = ares__buf_append_byte(buf, ((unsigned char)(u32 >> 8) & 0xff));
+ if (status != ARES_SUCCESS) {
+ return status;
+ }
+
+ status = ares__buf_append_byte(buf, ((unsigned char)u32 & 0xff));
+ if (status != ARES_SUCCESS) {
+ return status;
+ }
+
+ return ARES_SUCCESS;
+}
+
+unsigned char *ares__buf_append_start(ares__buf_t *buf, size_t *len)
+{
+ ares_status_t status;
+
+ if (len == NULL || *len == 0) {
+ return NULL;
+ }
+
+ status = ares__buf_ensure_space(buf, *len);
+ if (status != ARES_SUCCESS) {
+ return NULL;
+ }
+
+ /* -1 for possible null terminator for ares__buf_finish_str() */
+ *len = buf->alloc_buf_len - buf->data_len - 1;
+ return buf->alloc_buf + buf->data_len;
+}
+
+void ares__buf_append_finish(ares__buf_t *buf, size_t len)
+{
+ if (buf == NULL) {
+ return;
+ }
+
+ buf->data_len += len;
+}
+
+unsigned char *ares__buf_finish_bin(ares__buf_t *buf, size_t *len)
+{
+ unsigned char *ptr = NULL;
+ if (buf == NULL || len == NULL || ares__buf_is_const(buf)) {
+ return NULL;
+ }
+
+ ares__buf_reclaim(buf);
+
+ /* We don't want to return NULL except on failure, may be zero-length */
+ if (buf->alloc_buf == NULL &&
+ ares__buf_ensure_space(buf, 1) != ARES_SUCCESS) {
+ return NULL;
+ }
+ ptr = buf->alloc_buf;
+ *len = buf->data_len;
+ ares_free(buf);
+ return ptr;
+}
+
+char *ares__buf_finish_str(ares__buf_t *buf, size_t *len)
+{
+ char *ptr;
+ size_t mylen;
+
+ ptr = (char *)ares__buf_finish_bin(buf, &mylen);
+ if (ptr == NULL) {
+ return NULL;
+ }
+
+ if (len != NULL) {
+ *len = mylen;
+ }
+
+ /* NOTE: ensured via ares__buf_ensure_space() that there is always at least
+ * 1 extra byte available for this specific use-case */
+ ptr[mylen] = 0;
+
+ return ptr;
+}
+
+void ares__buf_tag(ares__buf_t *buf)
+{
+ if (buf == NULL) {
+ return;
+ }
+
+ buf->tag_offset = buf->offset;
+}
+
+ares_status_t ares__buf_tag_rollback(ares__buf_t *buf)
+{
+ if (buf == NULL || buf->tag_offset == SIZE_MAX) {
+ return ARES_EFORMERR;
+ }
+
+ buf->offset = buf->tag_offset;
+ buf->tag_offset = SIZE_MAX;
+ return ARES_SUCCESS;
+}
+
+ares_status_t ares__buf_tag_clear(ares__buf_t *buf)
+{
+ if (buf == NULL || buf->tag_offset == SIZE_MAX) {
+ return ARES_EFORMERR;
+ }
+
+ buf->tag_offset = SIZE_MAX;
+ return ARES_SUCCESS;
+}
+
+const unsigned char *ares__buf_tag_fetch(const ares__buf_t *buf, size_t *len)
+{
+ if (buf == NULL || buf->tag_offset == SIZE_MAX || len == NULL) {
+ return NULL;
+ }
+
+ *len = buf->offset - buf->tag_offset;
+ return buf->data + buf->tag_offset;
+}
+
+size_t ares__buf_tag_length(const ares__buf_t *buf)
+{
+ if (buf == NULL || buf->tag_offset == SIZE_MAX) {
+ return 0;
+ }
+ return buf->offset - buf->tag_offset;
+}
+
+ares_status_t ares__buf_tag_fetch_bytes(const ares__buf_t *buf,
+ unsigned char *bytes, size_t *len)
+{
+ size_t ptr_len = 0;
+ const unsigned char *ptr = ares__buf_tag_fetch(buf, &ptr_len);
+
+ if (ptr == NULL || bytes == NULL || len == NULL) {
+ return ARES_EFORMERR;
+ }
+
+ if (*len < ptr_len) {
+ return ARES_EFORMERR;
+ }
+
+ *len = ptr_len;
+
+ if (ptr_len > 0) {
+ memcpy(bytes, ptr, ptr_len);
+ }
+ return ARES_SUCCESS;
+}
+
+ares_status_t ares__buf_tag_fetch_string(const ares__buf_t *buf, char *str,
+ size_t len)
+{
+ size_t out_len;
+ ares_status_t status;
+ size_t i;
+
+ if (str == NULL || len == 0) {
+ return ARES_EFORMERR;
+ }
+
+ /* Space for NULL terminator */
+ out_len = len - 1;
+
+ status = ares__buf_tag_fetch_bytes(buf, (unsigned char *)str, &out_len);
+ if (status != ARES_SUCCESS) {
+ return status;
+ }
+
+ /* NULL terminate */
+ str[out_len] = 0;
+
+ /* Validate string is printable */
+ for (i = 0; i < out_len; i++) {
+ if (!ares__isprint(str[i])) {
+ return ARES_EBADSTR;
+ }
+ }
+
+ return ARES_SUCCESS;
+}
+
+static const unsigned char *ares__buf_fetch(const ares__buf_t *buf, size_t *len)
+{
+ if (len != NULL) {
+ *len = 0;
+ }
+
+ if (buf == NULL || len == NULL || buf->data == NULL) {
+ return NULL;
+ }
+
+ *len = buf->data_len - buf->offset;
+ if (*len == 0) {
+ return NULL;
+ }
+
+ return buf->data + buf->offset;
+}
+
+ares_status_t ares__buf_consume(ares__buf_t *buf, size_t len)
+{
+ size_t remaining_len = ares__buf_len(buf);
+
+ if (remaining_len < len) {
+ return ARES_EBADRESP;
+ }
+
+ buf->offset += len;
+ return ARES_SUCCESS;
+}
+
+ares_status_t ares__buf_fetch_be16(ares__buf_t *buf, unsigned short *u16)
+{
+ size_t remaining_len;
+ const unsigned char *ptr = ares__buf_fetch(buf, &remaining_len);
+ unsigned int u32;
+
+ if (buf == NULL || u16 == NULL || remaining_len < sizeof(*u16)) {
+ return ARES_EBADRESP;
+ }
+
+ /* Do math in an unsigned int in order to prevent warnings due to automatic
+ * conversion by the compiler from short to int during shifts */
+ u32 = ((unsigned int)(ptr[0]) << 8 | (unsigned int)ptr[1]);
+ *u16 = (unsigned short)(u32 & 0xFFFF);
+
+ return ares__buf_consume(buf, sizeof(*u16));
+}
+
+ares_status_t ares__buf_fetch_be32(ares__buf_t *buf, unsigned int *u32)
+{
+ size_t remaining_len;
+ const unsigned char *ptr = ares__buf_fetch(buf, &remaining_len);
+
+ if (buf == NULL || u32 == NULL || remaining_len < sizeof(*u32)) {
+ return ARES_EBADRESP;
+ }
+
+ *u32 = ((unsigned int)(ptr[0]) << 24 | (unsigned int)(ptr[1]) << 16 |
+ (unsigned int)(ptr[2]) << 8 | (unsigned int)(ptr[3]));
+
+ return ares__buf_consume(buf, sizeof(*u32));
+}
+
+ares_status_t ares__buf_fetch_bytes(ares__buf_t *buf, unsigned char *bytes,
+ size_t len)
+{
+ size_t remaining_len;
+ const unsigned char *ptr = ares__buf_fetch(buf, &remaining_len);
+
+ if (buf == NULL || bytes == NULL || len == 0 || remaining_len < len) {
+ return ARES_EBADRESP;
+ }
+
+ memcpy(bytes, ptr, len);
+ return ares__buf_consume(buf, len);
+}
+
+ares_status_t ares__buf_fetch_bytes_dup(ares__buf_t *buf, size_t len,
+ ares_bool_t null_term,
+ unsigned char **bytes)
+{
+ size_t remaining_len;
+ const unsigned char *ptr = ares__buf_fetch(buf, &remaining_len);
+
+ if (buf == NULL || bytes == NULL || len == 0 || remaining_len < len) {
+ return ARES_EBADRESP;
+ }
+
+ *bytes = ares_malloc(null_term ? len + 1 : len);
+ if (*bytes == NULL) {
+ return ARES_ENOMEM;
+ }
+
+ memcpy(*bytes, ptr, len);
+ if (null_term) {
+ (*bytes)[len] = 0;
+ }
+ return ares__buf_consume(buf, len);
+}
+
+ares_status_t ares__buf_fetch_str_dup(ares__buf_t *buf, size_t len, char **str)
+{
+ size_t remaining_len;
+ const unsigned char *ptr = ares__buf_fetch(buf, &remaining_len);
+
+ if (buf == NULL || str == NULL || len == 0 || remaining_len < len) {
+ return ARES_EBADRESP;
+ }
+
+ *str = ares_malloc(len + 1);
+ if (*str == NULL) {
+ return ARES_ENOMEM;
+ }
+
+ memcpy(*str, ptr, len);
+ (*str)[len] = 0;
+
+ return ares__buf_consume(buf, len);
+}
+
+ares_status_t ares__buf_fetch_bytes_into_buf(ares__buf_t *buf,
+ ares__buf_t *dest, size_t len)
+{
+ size_t remaining_len;
+ const unsigned char *ptr = ares__buf_fetch(buf, &remaining_len);
+ ares_status_t status;
+
+ if (buf == NULL || dest == NULL || len == 0 || remaining_len < len) {
+ return ARES_EBADRESP;
+ }
+
+ status = ares__buf_append(dest, ptr, len);
+ if (status != ARES_SUCCESS) {
+ return status;
+ }
+
+ return ares__buf_consume(buf, len);
+}
+
+size_t ares__buf_consume_whitespace(ares__buf_t *buf,
+ ares_bool_t include_linefeed)
+{
+ size_t remaining_len = 0;
+ const unsigned char *ptr = ares__buf_fetch(buf, &remaining_len);
+ size_t i;
+
+ if (ptr == NULL) {
+ return 0;
+ }
+
+ for (i = 0; i < remaining_len; i++) {
+ switch (ptr[i]) {
+ case '\r':
+ case '\t':
+ case ' ':
+ case '\v':
+ case '\f':
+ break;
+ case '\n':
+ if (!include_linefeed) {
+ goto done;
+ }
+ break;
+ default:
+ goto done;
+ }
+ }
+
+done:
+ if (i > 0) {
+ ares__buf_consume(buf, i);
+ }
+ return i;
+}
+
+size_t ares__buf_consume_nonwhitespace(ares__buf_t *buf)
+{
+ size_t remaining_len = 0;
+ const unsigned char *ptr = ares__buf_fetch(buf, &remaining_len);
+ size_t i;
+
+ if (ptr == NULL) {
+ return 0;
+ }
+
+ for (i = 0; i < remaining_len; i++) {
+ switch (ptr[i]) {
+ case '\r':
+ case '\t':
+ case ' ':
+ case '\v':
+ case '\f':
+ case '\n':
+ goto done;
+ default:
+ break;
+ }
+ }
+
+done:
+ if (i > 0) {
+ ares__buf_consume(buf, i);
+ }
+ return i;
+}
+
+size_t ares__buf_consume_line(ares__buf_t *buf, ares_bool_t include_linefeed)
+{
+ size_t remaining_len = 0;
+ const unsigned char *ptr = ares__buf_fetch(buf, &remaining_len);
+ size_t i;
+
+ if (ptr == NULL) {
+ return 0;
+ }
+
+ for (i = 0; i < remaining_len; i++) {
+ if (ptr[i] == '\n') {
+ goto done;
+ }
+ }
+
+done:
+ if (include_linefeed && i < remaining_len && ptr[i] == '\n') {
+ i++;
+ }
+
+ if (i > 0) {
+ ares__buf_consume(buf, i);
+ }
+ return i;
+}
+
+size_t ares__buf_consume_until_charset(ares__buf_t *buf,
+ const unsigned char *charset, size_t len,
+ ares_bool_t require_charset)
+{
+ size_t remaining_len = 0;
+ const unsigned char *ptr = ares__buf_fetch(buf, &remaining_len);
+ size_t i;
+ ares_bool_t found = ARES_FALSE;
+
+ if (ptr == NULL || charset == NULL || len == 0) {
+ return 0;
+ }
+
+ for (i = 0; i < remaining_len; i++) {
+ size_t j;
+ for (j = 0; j < len; j++) {
+ if (ptr[i] == charset[j]) {
+ found = ARES_TRUE;
+ goto done;
+ }
+ }
+ }
+
+done:
+ if (require_charset && !found) {
+ return 0;
+ }
+
+ if (i > 0) {
+ ares__buf_consume(buf, i);
+ }
+ return i;
+}
+
+size_t ares__buf_consume_charset(ares__buf_t *buf, const unsigned char *charset,
+ size_t len)
+{
+ size_t remaining_len = 0;
+ const unsigned char *ptr = ares__buf_fetch(buf, &remaining_len);
+ size_t i;
+
+ if (ptr == NULL || charset == NULL || len == 0) {
+ return 0;
+ }
+
+ for (i = 0; i < remaining_len; i++) {
+ size_t j;
+ for (j = 0; j < len; j++) {
+ if (ptr[i] == charset[j]) {
+ break;
+ }
+ }
+ /* Not found */
+ if (j == len) {
+ break;
+ }
+ }
+
+ if (i > 0) {
+ ares__buf_consume(buf, i);
+ }
+ return i;
+}
+
+static void ares__buf_destroy_cb(void *arg)
+{
+ ares__buf_destroy(arg);
+}
+
+static ares_bool_t ares__buf_split_isduplicate(ares__llist_t *list,
+ const unsigned char *val,
+ size_t len,
+ ares__buf_split_t flags)
+{
+ ares__llist_node_t *node;
+
+ for (node = ares__llist_node_first(list); node != NULL;
+ node = ares__llist_node_next(node)) {
+ ares__buf_t *buf = ares__llist_node_val(node);
+ size_t plen = 0;
+ const unsigned char *ptr = ares__buf_peek(buf, &plen);
+
+ /* Can't be duplicate if lengths mismatch */
+ if (plen != len) {
+ continue;
+ }
+
+ if (flags & ARES_BUF_SPLIT_CASE_INSENSITIVE) {
+ if (ares__memeq_ci(ptr, val, len)) {
+ return ARES_TRUE;
+ }
+ } else {
+ if (memcmp(ptr, val, len) == 0) {
+ return ARES_TRUE;
+ }
+ }
+ }
+ return ARES_FALSE;
+}
+
+ares_status_t ares__buf_split(ares__buf_t *buf, const unsigned char *delims,
+ size_t delims_len, ares__buf_split_t flags,
+ ares__llist_t **list)
+{
+ ares_status_t status = ARES_SUCCESS;
+ ares_bool_t first = ARES_TRUE;
+
+ if (buf == NULL || delims == NULL || delims_len == 0 || list == NULL) {
+ return ARES_EFORMERR;
+ }
+
+ *list = ares__llist_create(ares__buf_destroy_cb);
+ if (*list == NULL) {
+ status = ARES_ENOMEM;
+ goto done;
+ }
+
+ while (ares__buf_len(buf)) {
+ size_t len;
+
+ ares__buf_tag(buf);
+
+ len = ares__buf_consume_until_charset(buf, delims, delims_len, ARES_FALSE);
+
+ /* Don't treat a delimiter as part of the length */
+ if (!first && len && flags & ARES_BUF_SPLIT_DONT_CONSUME_DELIMS) {
+ len--;
+ }
+
+ if (len != 0 || flags & ARES_BUF_SPLIT_ALLOW_BLANK) {
+ const unsigned char *ptr = ares__buf_tag_fetch(buf, &len);
+ ares__buf_t *data;
+
+ if (!(flags & ARES_BUF_SPLIT_NO_DUPLICATES) ||
+ !ares__buf_split_isduplicate(*list, ptr, len, flags)) {
+ /* Since we don't allow const buffers of 0 length, and user wants
+ * 0-length buffers, swap what we do here */
+ if (len) {
+ data = ares__buf_create_const(ptr, len);
+ } else {
+ data = ares__buf_create();
+ }
+
+ if (data == NULL) {
+ status = ARES_ENOMEM;
+ goto done;
+ }
+
+ if (ares__llist_insert_last(*list, data) == NULL) {
+ ares__buf_destroy(data);
+ status = ARES_ENOMEM;
+ goto done;
+ }
+ }
+ }
+
+ if (!(flags & ARES_BUF_SPLIT_DONT_CONSUME_DELIMS) &&
+ ares__buf_len(buf) != 0) {
+ /* Consume delimiter */
+ ares__buf_consume(buf, 1);
+ }
+
+ first = ARES_FALSE;
+ }
+
+done:
+ if (status != ARES_SUCCESS) {
+ ares__llist_destroy(*list);
+ *list = NULL;
+ }
+
+ return status;
+}
+
+ares_bool_t ares__buf_begins_with(const ares__buf_t *buf,
+ const unsigned char *data, size_t data_len)
+{
+ size_t remaining_len = 0;
+ const unsigned char *ptr = ares__buf_fetch(buf, &remaining_len);
+
+ if (ptr == NULL || data == NULL || data_len == 0) {
+ return ARES_FALSE;
+ }
+
+ if (data_len > remaining_len) {
+ return ARES_FALSE;
+ }
+
+ if (memcmp(ptr, data, data_len) != 0) {
+ return ARES_FALSE;
+ }
+
+ return ARES_TRUE;
+}
+
+size_t ares__buf_len(const ares__buf_t *buf)
+{
+ if (buf == NULL) {
+ return 0;
+ }
+
+ return buf->data_len - buf->offset;
+}
+
+const unsigned char *ares__buf_peek(const ares__buf_t *buf, size_t *len)
+{
+ return ares__buf_fetch(buf, len);
+}
+
+size_t ares__buf_get_position(const ares__buf_t *buf)
+{
+ if (buf == NULL) {
+ return 0;
+ }
+ return buf->offset;
+}
+
+ares_status_t ares__buf_set_position(ares__buf_t *buf, size_t idx)
+{
+ if (buf == NULL) {
+ return ARES_EFORMERR;
+ }
+
+ if (idx > buf->data_len) {
+ return ARES_EFORMERR;
+ }
+
+ buf->offset = idx;
+ return ARES_SUCCESS;
+}
+
+ares_status_t ares__buf_parse_dns_binstr(ares__buf_t *buf, size_t remaining_len,
+ unsigned char **bin, size_t *bin_len,
+ ares_bool_t allow_multiple)
+{
+ unsigned char len;
+ ares_status_t status;
+ ares__buf_t *binbuf = NULL;
+ size_t orig_len = ares__buf_len(buf);
+
+ if (buf == NULL) {
+ return ARES_EFORMERR;
+ }
+
+ if (remaining_len == 0) {
+ return ARES_EBADRESP;
+ }
+
+ binbuf = ares__buf_create();
+ if (binbuf == NULL) {
+ return ARES_ENOMEM;
+ }
+
+ while (orig_len - ares__buf_len(buf) < remaining_len) {
+ status = ares__buf_fetch_bytes(buf, &len, 1);
+ if (status != ARES_SUCCESS) {
+ break;
+ }
+
+ if (len) {
+ /* XXX: Maybe we should scan to make sure it is printable? */
+ if (bin != NULL) {
+ status = ares__buf_fetch_bytes_into_buf(buf, binbuf, len);
+ } else {
+ status = ares__buf_consume(buf, len);
+ }
+ if (status != ARES_SUCCESS) {
+ break;
+ }
+ }
+
+ if (!allow_multiple) {
+ break;
+ }
+ }
+
+
+ if (status != ARES_SUCCESS) {
+ ares__buf_destroy(binbuf);
+ } else {
+ if (bin != NULL) {
+ size_t mylen = 0;
+ /* NOTE: we use ares__buf_finish_str() here as we guarantee NULL
+ * Termination even though we are technically returning binary data.
+ */
+ *bin = (unsigned char *)ares__buf_finish_str(binbuf, &mylen);
+ *bin_len = mylen;
+ }
+ }
+
+ return status;
+}
+
+ares_status_t ares__buf_parse_dns_str(ares__buf_t *buf, size_t remaining_len,
+ char **str, ares_bool_t allow_multiple)
+{
+ size_t len;
+ return ares__buf_parse_dns_binstr(buf, remaining_len, (unsigned char **)str,
+ &len, allow_multiple);
+}
+
+ares_status_t ares__buf_append_num_dec(ares__buf_t *buf, size_t num, size_t len)
+{
+ size_t i;
+ size_t mod;
+
+ if (len == 0) {
+ len = ares__count_digits(num);
+ }
+
+ mod = ares__pow(10, len);
+
+ for (i = len; i > 0; i--) {
+ size_t digit = (num % mod);
+ ares_status_t status;
+
+ mod /= 10;
+
+ /* Silence coverity. Shouldn't be possible since we calculate it above */
+ if (mod == 0) {
+ return ARES_EFORMERR;
+ }
+
+ digit /= mod;
+ status = ares__buf_append_byte(buf, '0' + (unsigned char)(digit & 0xFF));
+ if (status != ARES_SUCCESS) {
+ return status;
+ }
+ }
+ return ARES_SUCCESS;
+}
+
+ares_status_t ares__buf_append_num_hex(ares__buf_t *buf, size_t num, size_t len)
+{
+ size_t i;
+ static const unsigned char hexbytes[] = "0123456789ABCDEF";
+
+ if (len == 0) {
+ len = ares__count_hexdigits(num);
+ }
+
+ for (i = len; i > 0; i--) {
+ ares_status_t status;
+ status = ares__buf_append_byte(buf, hexbytes[(num >> ((i - 1) * 4)) & 0xF]);
+ if (status != ARES_SUCCESS) {
+ return status;
+ }
+ }
+ return ARES_SUCCESS;
+}
+
+ares_status_t ares__buf_append_str(ares__buf_t *buf, const char *str)
+{
+ return ares__buf_append(buf, (const unsigned char *)str, ares_strlen(str));
+}
+
+static ares_status_t ares__buf_hexdump_line(ares__buf_t *buf, size_t idx,
+ const unsigned char *data,
+ size_t len)
+{
+ size_t i;
+ ares_status_t status;
+
+ /* Address */
+ status = ares__buf_append_num_hex(buf, idx, 6);
+ if (status != ARES_SUCCESS) {
+ return status;
+ }
+
+ /* | */
+ status = ares__buf_append_str(buf, " | ");
+ if (status != ARES_SUCCESS) {
+ return status;
+ }
+
+ for (i = 0; i < 16; i++) {
+ if (i >= len) {
+ status = ares__buf_append_str(buf, " ");
+ } else {
+ status = ares__buf_append_num_hex(buf, data[i], 2);
+ }
+ if (status != ARES_SUCCESS) {
+ return status;
+ }
+
+ status = ares__buf_append_byte(buf, ' ');
+ if (status != ARES_SUCCESS) {
+ return status;
+ }
+ }
+
+ /* | */
+ status = ares__buf_append_str(buf, " | ");
+ if (status != ARES_SUCCESS) {
+ return status;
+ }
+
+ for (i = 0; i < 16; i++) {
+ if (i >= len) {
+ break;
+ }
+ status = ares__buf_append_byte(buf, ares__isprint(data[i]) ? data[i] : '.');
+ if (status != ARES_SUCCESS) {
+ return status;
+ }
+ }
+
+ return ares__buf_append_byte(buf, '\n');
+}
+
+ares_status_t ares__buf_hexdump(ares__buf_t *buf, const unsigned char *data,
+ size_t len)
+{
+ size_t i;
+
+ /* Each line is 16 bytes */
+ for (i = 0; i < len; i += 16) {
+ ares_status_t status;
+ status = ares__buf_hexdump_line(buf, i, data + i, len - i);
+ if (status != ARES_SUCCESS) {
+ return status;
+ }
+ }
+
+ return ARES_SUCCESS;
+}
diff --git a/subprojects/c-ares/src/lib/ares__buf.h b/subprojects/c-ares/src/lib/ares__buf.h
@@ -0,0 +1,572 @@
+/* MIT License
+ *
+ * Copyright (c) 2023 Brad House
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice (including the next
+ * paragraph) shall be included in all copies or substantial portions of the
+ * Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ *
+ * SPDX-License-Identifier: MIT
+ */
+#ifndef __ARES__BUF_H
+#define __ARES__BUF_H
+
+/*! \addtogroup ares__buf Safe Data Builder and buffer
+ *
+ * This is a buffer building and parsing framework with a focus on security over
+ * performance. All data to be read from the buffer will perform explicit length
+ * validation and return a success/fail result. There are also various helpers
+ * for writing data to the buffer which dynamically grows.
+ *
+ * All operations that fetch or consume data from the buffer will move forward
+ * the internal pointer, thus marking the data as processed which may no longer
+ * be accessible after certain operations (such as append).
+ *
+ * The helpers for this object are meant to be added as needed. If you can't
+ * find it, write it!
+ *
+ * @{
+ */
+struct ares__buf;
+
+/*! Opaque data type for generic hash table implementation */
+typedef struct ares__buf ares__buf_t;
+
+/*! Create a new buffer object that dynamically allocates buffers for data.
+ *
+ * \return initialized buffer object or NULL if out of memory.
+ */
+ares__buf_t *ares__buf_create(void);
+
+/*! Create a new buffer object that uses a user-provided data pointer. The
+ * data provided will not be manipulated, and cannot be appended to. This
+ * is strictly used for parsing.
+ *
+ * \param[in] data Data to provide to buffer, must not be NULL.
+ * \param[in] data_len Size of buffer provided, must be > 0
+ *
+ * \return initialized buffer object or NULL if out of memory or misuse.
+ */
+ares__buf_t *ares__buf_create_const(const unsigned char *data, size_t data_len);
+
+
+/*! Destroy an initialized buffer object.
+ *
+ * \param[in] buf Initialized buf object
+ */
+void ares__buf_destroy(ares__buf_t *buf);
+
+
+/*! Append multiple bytes to a dynamic buffer object
+ *
+ * \param[in] buf Initialized buffer object
+ * \param[in] data Data to copy to buffer object
+ * \param[in] data_len Length of data to copy to buffer object.
+ * \return ARES_SUCCESS or one of the c-ares error codes
+ */
+ares_status_t ares__buf_append(ares__buf_t *buf, const unsigned char *data,
+ size_t data_len);
+
+/*! Append a single byte to the dynamic buffer object
+ *
+ * \param[in] buf Initialized buffer object
+ * \param[in] byte Single byte to append to buffer object.
+ * \return ARES_SUCCESS or one of the c-ares error codes
+ */
+ares_status_t ares__buf_append_byte(ares__buf_t *buf, unsigned char byte);
+
+/*! Append a null-terminated string to the dynamic buffer object
+ *
+ * \param[in] buf Initialized buffer object
+ * \param[in] str String to append to buffer object.
+ * \return ARES_SUCCESS or one of the c-ares error codes
+ */
+ares_status_t ares__buf_append_str(ares__buf_t *buf, const char *str);
+
+/*! Append a 16bit Big Endian number to the buffer.
+ *
+ * \param[in] buf Initialized buffer object
+ * \param[out] u16 16bit integer
+ * \return ARES_SUCCESS or one of the c-ares error codes
+ */
+ares_status_t ares__buf_append_be16(ares__buf_t *buf, unsigned short u16);
+
+/*! Append a 32bit Big Endian number to the buffer.
+ *
+ * \param[in] buf Initialized buffer object
+ * \param[out] u32 32bit integer
+ * \return ARES_SUCCESS or one of the c-ares error codes
+ */
+ares_status_t ares__buf_append_be32(ares__buf_t *buf, unsigned int u32);
+
+/*! Append a number in ASCII decimal form.
+ *
+ * \param[in] buf Initialized buffer object
+ * \param[in] num Number to print
+ * \param[in] len Length to output, use 0 for no padding
+ * \return ARES_SUCCESS on success
+ */
+ares_status_t ares__buf_append_num_dec(ares__buf_t *buf, size_t num,
+ size_t len);
+
+/*! Append a number in ASCII hexadecimal form.
+ *
+ * \param[in] buf Initialized buffer object
+ * \param[in] num Number to print
+ * \param[in] len Length to output, use 0 for no padding
+ * \return ARES_SUCCESS on success
+ */
+ares_status_t ares__buf_append_num_hex(ares__buf_t *buf, size_t num,
+ size_t len);
+
+/*! Sets the current buffer length. This *may* be used if there is a need to
+ * override a prior position in the buffer, such as if there is a length
+ * prefix that isn't easily predictable, and you must go back and overwrite
+ * that position.
+ *
+ * Only valid on non-const buffers. Length provided must not exceed current
+ * allocated buffer size, but otherwise there are very few protections on
+ * this function. Use cautiously.
+ *
+ * \param[in] buf Initialized buffer object
+ * \param[in] len Length to set
+ * \return ARES_SUCCESS or one of the c-ares error codes
+ */
+ares_status_t ares__buf_set_length(ares__buf_t *buf, size_t len);
+
+
+/*! Start a dynamic append operation that returns a buffer suitable for
+ * writing. A desired minimum length is passed in, and the actual allocated
+ * buffer size is returned which may be greater than the requested size.
+ * No operation other than ares__buf_append_finish() is allowed on the
+ * buffer after this request.
+ *
+ * \param[in] buf Initialized buffer object
+ * \param[in,out] len Desired non-zero length passed in, actual buffer size
+ * returned.
+ * \return Pointer to writable buffer or NULL on failure (usage, out of mem)
+ */
+unsigned char *ares__buf_append_start(ares__buf_t *buf, size_t *len);
+
+/*! Finish a dynamic append operation. Called after
+ * ares__buf_append_start() once desired data is written.
+ *
+ * \param[in] buf Initialized buffer object.
+ * \param[in] len Length of data written. May be zero to terminate
+ * operation. Must not be greater than returned from
+ * ares__buf_append_start().
+ */
+void ares__buf_append_finish(ares__buf_t *buf, size_t len);
+
+/*! Write the data provided to the buffer in a hexdump format.
+ *
+ * \param[in] buf Initialized buffer object.
+ * \param[in] data Data to hex dump
+ * \param[in] data_len Length of data to hexdump
+ * \return ARES_SUCCESS on success.
+ */
+ares_status_t ares__buf_hexdump(ares__buf_t *buf, const unsigned char *data,
+ size_t len);
+
+/*! Clean up ares__buf_t and return allocated pointer to unprocessed data. It
+ * is the responsibility of the caller to ares_free() the returned buffer.
+ * The passed in buf parameter is invalidated by this call.
+ *
+ * \param[in] buf Initialized buffer object. Can not be a "const" buffer.
+ * \param[out] len Length of data returned
+ * \return pointer to unprocessed data (may be zero length) or NULL on error.
+ */
+unsigned char *ares__buf_finish_bin(ares__buf_t *buf, size_t *len);
+
+/*! Clean up ares__buf_t and return allocated pointer to unprocessed data and
+ * return it as a string (null terminated). It is the responsibility of the
+ * caller to ares_free() the returned buffer. The passed in buf parameter is
+ * invalidated by this call.
+ *
+ * This function in no way validates the data in this buffer is actually
+ * a string, that characters are printable, or that there aren't multiple
+ * NULL terminators. It is assumed that the caller will either validate that
+ * themselves or has built this buffer with only a valid character set.
+ *
+ * \param[in] buf Initialized buffer object. Can not be a "const" buffer.
+ * \param[out] len Optional. Length of data returned, or NULL if not needed.
+ * \return pointer to unprocessed data or NULL on error.
+ */
+char *ares__buf_finish_str(ares__buf_t *buf, size_t *len);
+
+/*! Tag a position to save in the buffer in case parsing needs to rollback,
+ * such as if insufficient data is available, but more data may be added in
+ * the future. Only a single tag can be set per buffer object. Setting a
+ * tag will override any pre-existing tag.
+ *
+ * \param[in] buf Initialized buffer object
+ */
+void ares__buf_tag(ares__buf_t *buf);
+
+/*! Rollback to a tagged position. Will automatically clear the tag.
+ *
+ * \param[in] buf Initialized buffer object
+ * \return ARES_SUCCESS or one of the c-ares error codes
+ */
+ares_status_t ares__buf_tag_rollback(ares__buf_t *buf);
+
+/*! Clear the tagged position without rolling back. You should do this any
+ * time a tag is no longer needed as future append operations can reclaim
+ * buffer space.
+ *
+ * \param[in] buf Initialized buffer object
+ * \return ARES_SUCCESS or one of the c-ares error codes
+ */
+ares_status_t ares__buf_tag_clear(ares__buf_t *buf);
+
+/*! Fetch the buffer and length of data starting from the tagged position up
+ * to the _current_ position. It will not unset the tagged position. The
+ * data may be invalidated by any future ares__buf_*() calls.
+ *
+ * \param[in] buf Initialized buffer object
+ * \param[out] len Length between tag and current offset in buffer
+ * \return NULL on failure (such as no tag), otherwise pointer to start of
+ * buffer
+ */
+const unsigned char *ares__buf_tag_fetch(const ares__buf_t *buf, size_t *len);
+
+/*! Get the length of the current tag offset to the current position.
+ *
+ * \param[in] buf Initialized buffer object
+ * \return length
+ */
+size_t ares__buf_tag_length(const ares__buf_t *buf);
+
+/*! Fetch the bytes starting from the tagged position up to the _current_
+ * position using the provided buffer. It will not unset the tagged position.
+ *
+ * \param[in] buf Initialized buffer object
+ * \param[in,out] bytes Buffer to hold data
+ * \param[in,out] len On input, buffer size, on output, bytes place in
+ * buffer.
+ * \return ARES_SUCCESS if fetched, ARES_EFORMERR if insufficient buffer size
+ */
+ares_status_t ares__buf_tag_fetch_bytes(const ares__buf_t *buf,
+ unsigned char *bytes, size_t *len);
+
+/*! Fetch the bytes starting from the tagged position up to the _current_
+ * position as a NULL-terminated string using the provided buffer. The data
+ * is validated to be ASCII-printable data. It will not unset the tagged
+ * poition.
+ *
+ * \param[in] buf Initialized buffer object
+ * \param[in,out] str Buffer to hold data
+ * \param[in] len On input, buffer size, on output, bytes place in
+ * buffer.
+ * \return ARES_SUCCESS if fetched, ARES_EFORMERR if insufficient buffer size,
+ * ARES_EBADSTR if not printable ASCII
+ */
+ares_status_t ares__buf_tag_fetch_string(const ares__buf_t *buf, char *str,
+ size_t len);
+
+/*! Consume the given number of bytes without reading them.
+ *
+ * \param[in] buf Initialized buffer object
+ * \param[in] len Length to consume
+ * \return ARES_SUCCESS or one of the c-ares error codes
+ */
+ares_status_t ares__buf_consume(ares__buf_t *buf, size_t len);
+
+/*! Fetch a 16bit Big Endian number from the buffer.
+ *
+ * \param[in] buf Initialized buffer object
+ * \param[out] u16 Buffer to hold 16bit integer
+ * \return ARES_SUCCESS or one of the c-ares error codes
+ */
+ares_status_t ares__buf_fetch_be16(ares__buf_t *buf, unsigned short *u16);
+
+/*! Fetch a 32bit Big Endian number from the buffer.
+ *
+ * \param[in] buf Initialized buffer object
+ * \param[out] u32 Buffer to hold 32bit integer
+ * \return ARES_SUCCESS or one of the c-ares error codes
+ */
+ares_status_t ares__buf_fetch_be32(ares__buf_t *buf, unsigned int *u32);
+
+
+/*! Fetch the requested number of bytes into the provided buffer
+ *
+ * \param[in] buf Initialized buffer object
+ * \param[out] bytes Buffer to hold data
+ * \param[in] len Requested number of bytes (must be > 0)
+ * \return ARES_SUCCESS or one of the c-ares error codes
+ */
+ares_status_t ares__buf_fetch_bytes(ares__buf_t *buf, unsigned char *bytes,
+ size_t len);
+
+
+/*! Fetch the requested number of bytes and return a new buffer that must be
+ * ares_free()'d by the caller.
+ *
+ * \param[in] buf Initialized buffer object
+ * \param[in] len Requested number of bytes (must be > 0)
+ * \param[in] null_term Even though this is considered binary data, the user
+ * knows it may be a vald string, so add a null
+ * terminator.
+ * \param[out] bytes Pointer passed by reference. Will be allocated.
+ * \return ARES_SUCCESS or one of the c-ares error codes
+ */
+ares_status_t ares__buf_fetch_bytes_dup(ares__buf_t *buf, size_t len,
+ ares_bool_t null_term,
+ unsigned char **bytes);
+
+/*! Fetch the requested number of bytes and place them into the provided
+ * dest buffer object.
+ *
+ * \param[in] buf Initialized buffer object
+ * \param[out] dest Buffer object to append bytes.
+ * \param[in] len Requested number of bytes (must be > 0)
+ * \return ARES_SUCCESS or one of the c-ares error codes
+ */
+ares_status_t ares__buf_fetch_bytes_into_buf(ares__buf_t *buf,
+ ares__buf_t *dest, size_t len);
+
+/*! Fetch the requested number of bytes and return a new buffer that must be
+ * ares_free()'d by the caller. The returned buffer is a null terminated
+ * string.
+ *
+ * \param[in] buf Initialized buffer object
+ * \param[in] len Requested number of bytes (must be > 0)
+ * \param[out] str Pointer passed by reference. Will be allocated.
+ * \return ARES_SUCCESS or one of the c-ares error codes
+ */
+ares_status_t ares__buf_fetch_str_dup(ares__buf_t *buf, size_t len, char **str);
+
+/*! Consume whitespace characters (0x09, 0x0B, 0x0C, 0x0D, 0x20, and optionally
+ * 0x0A).
+ *
+ * \param[in] buf Initialized buffer object
+ * \param[in] include_linefeed ARES_TRUE to include consuming 0x0A,
+ * ARES_FALSE otherwise.
+ * \return number of whitespace characters consumed
+ */
+size_t ares__buf_consume_whitespace(ares__buf_t *buf,
+ ares_bool_t include_linefeed);
+
+
+/*! Consume any non-whitespace character (anything other than 0x09, 0x0B, 0x0C,
+ * 0x0D, 0x20, and 0x0A).
+ *
+ * \param[in] buf Initialized buffer object
+ * \return number of characters consumed
+ */
+size_t ares__buf_consume_nonwhitespace(ares__buf_t *buf);
+
+
+/*! Consume until a character in the character set provided is reached
+ *
+ * \param[in] buf Initialized buffer object
+ * \param[in] charset character set
+ * \param[in] len length of character set
+ * \param[in] require_charset require we find a character from the charset.
+ * if ARES_FALSE it will simply consume the
+ * rest of the buffer. If ARES_TRUE will return
+ * 0 if not found.
+ * \return number of characters consumed
+ */
+size_t ares__buf_consume_until_charset(ares__buf_t *buf,
+ const unsigned char *charset, size_t len,
+ ares_bool_t require_charset);
+
+
+/*! Consume while the characters match the characters in the provided set.
+ *
+ * \param[in] buf Initialized buffer object
+ * \param[in] charset character set
+ * \param[in] len length of character set
+ * \return number of characters consumed
+ */
+size_t ares__buf_consume_charset(ares__buf_t *buf, const unsigned char *charset,
+ size_t len);
+
+
+/*! Consume from the current position until the end of the line, and optionally
+ * the end of line character (0x0A) itself.
+ *
+ * \param[in] buf Initialized buffer object
+ * \param[in] include_linefeed ARES_TRUE to include consuming 0x0A,
+ * ARES_FALSE otherwise.
+ * \return number of characters consumed
+ */
+size_t ares__buf_consume_line(ares__buf_t *buf, ares_bool_t include_linefeed);
+
+typedef enum {
+ /*! No flags */
+ ARES_BUF_SPLIT_NONE = 0,
+ /*! The delimiter will be the first character in the buffer, except the
+ * first buffer since the start doesn't have a delimiter
+ */
+ ARES_BUF_SPLIT_DONT_CONSUME_DELIMS = 1 << 0,
+ /*! Allow blank sections, by default blank sections are not emitted. If using
+ * ARES_BUF_SPLIT_DONT_CONSUME_DELIMS, the delimiter is not counted as part
+ * of the section */
+ ARES_BUF_SPLIT_ALLOW_BLANK = 1 << 1,
+ /*! Remove duplicate entries */
+ ARES_BUF_SPLIT_NO_DUPLICATES = 1 << 2,
+ /*! Perform case-insensitive matching when comparing values */
+ ARES_BUF_SPLIT_CASE_INSENSITIVE = 1 << 3
+} ares__buf_split_t;
+
+/*! Split the provided buffer into multiple sub-buffers stored in the variable
+ * pointed to by the linked list. The sub buffers are const buffers pointing
+ * into the buf provided.
+ *
+ * \param[in] buf Initialized buffer object
+ * \param[in] delims Possible delimiters
+ * \param[in] delims_len Length of possible delimiters
+ * \param[in] flags One more more flags
+ * \param[out] list Result. Depending on flags, this may be a
+ * valid list with no elements. Use
+ * ares__llist_destroy() to free the memory which
+ * will also free the contained ares__buf_t
+ * objects.
+ * \return ARES_SUCCESS on success, or error like ARES_ENOMEM.
+ */
+ares_status_t ares__buf_split(ares__buf_t *buf, const unsigned char *delims,
+ size_t delims_len, ares__buf_split_t flags,
+ ares__llist_t **list);
+
+
+/*! Check the unprocessed buffer to see if it begins with the sequence of
+ * characters provided.
+ *
+ * \param[in] buf Initialized buffer object
+ * \param[in] data Bytes of data to compare.
+ * \param[in] data_len Length of data to compare.
+ * \return ARES_TRUE on match, ARES_FALSE otherwise.
+ */
+ares_bool_t ares__buf_begins_with(const ares__buf_t *buf,
+ const unsigned char *data, size_t data_len);
+
+
+/*! Size of unprocessed remaining data length
+ *
+ * \param[in] buf Initialized buffer object
+ * \return length remaining
+ */
+size_t ares__buf_len(const ares__buf_t *buf);
+
+/*! Retrieve a pointer to the currently unprocessed data. Generally this isn't
+ * recommended to be used in practice. The returned pointer may be invalidated
+ * by any future ares__buf_*() calls.
+ *
+ * \param[in] buf Initialized buffer object
+ * \param[out] len Length of available data
+ * \return Pointer to buffer of unprocessed data
+ */
+const unsigned char *ares__buf_peek(const ares__buf_t *buf, size_t *len);
+
+
+/*! Wipe any processed data from the beginning of the buffer. This will
+ * move any remaining data to the front of the internally allocated buffer.
+ *
+ * Can not be used on const buffer objects.
+ *
+ * Typically not needed to call, as any new append operation will automatically
+ * call this function if there is insufficient space to append the data in
+ * order to try to avoid another memory allocation.
+ *
+ * It may be useful to call in order to ensure the current message being
+ * processed is in the beginning of the buffer if there is an intent to use
+ * ares__buf_set_position() and ares__buf_get_position() as may be necessary
+ * when processing DNS compressed names.
+ *
+ * If there is an active tag, it will NOT clear the tag, it will use the tag
+ * as the start of the unprocessed data rather than the current offset. If
+ * a prior tag is no longer needed, may be wise to call ares__buf_tag_clear().
+ *
+ * \param[in] buf Initialized buffer object
+ */
+void ares__buf_reclaim(ares__buf_t *buf);
+
+/*! Set the current offset within the internal buffer.
+ *
+ * Typically this should not be used, if possible, use the ares__buf_tag*()
+ * operations instead.
+ *
+ * One exception is DNS name compression which may backwards reference to
+ * an index in the message. It may be necessary in such a case to call
+ * ares__buf_reclaim() if using a dynamic (non-const) buffer before processing
+ * such a message.
+ *
+ * \param[in] buf Initialized buffer object
+ * \param[in] idx Index to set position
+ * \return ARES_SUCCESS if valid index
+ */
+ares_status_t ares__buf_set_position(ares__buf_t *buf, size_t idx);
+
+/*! Get the current offset within the internal buffer.
+ *
+ * Typically this should not be used, if possible, use the ares__buf_tag*()
+ * operations instead.
+ *
+ * This can be used to get the current position, useful for saving if a
+ * jump via ares__buf_set_position() is performed and need to restore the
+ * current position for future operations.
+ *
+ * \param[in] buf Initialized buffer object
+ * \return index of current position
+ */
+size_t ares__buf_get_position(const ares__buf_t *buf);
+
+/*! Parse a character-string as defined in RFC1035, as a null-terminated
+ * string.
+ *
+ * \param[in] buf initialized buffer object
+ * \param[in] remaining_len maximum length that should be used for parsing
+ * the string, this is often less than the remaining
+ * buffer and is based on the RR record length.
+ * \param[out] str Pointer passed by reference to be filled in with
+ * allocated string of the parsed that must be
+ * ares_free()'d by the caller.
+ * \param[in] allow_multiple ARES_TRUE if it should attempt to parse multiple
+ * strings back to back, and will concatenate in
+ * the returned str.
+ * \return ARES_SUCCESS on success
+ */
+ares_status_t ares__buf_parse_dns_str(ares__buf_t *buf, size_t remaining_len,
+ char **name, ares_bool_t allow_multiple);
+
+/*! Parse a character-string as defined in RFC1035, as binary, however for
+ * convenience this does guarantee a NULL terminator (that is not included
+ * in the returned length).
+ *
+ * \param[in] buf initialized buffer object
+ * \param[in] remaining_len maximum length that should be used for parsing
+ * the string, this is often less than the remaining
+ * buffer and is based on the RR record length.
+ * \param[out] bin Pointer passed by reference to be filled in with
+ * allocated string of the parsed that must be
+ * ares_free()'d by the caller.
+ * \param[out] bin_len Length of returned string.
+ * \param[in] allow_multiple ARES_TRUE if it should attempt to parse multiple
+ * strings back to back, and will concatenate in
+ * the returned str.
+ * \return ARES_SUCCESS on success
+ */
+ares_status_t ares__buf_parse_dns_binstr(ares__buf_t *buf, size_t remaining_len,
+ unsigned char **bin, size_t *bin_len,
+ ares_bool_t allow_multiple);
+/*! @} */
+
+#endif /* __ARES__BUF_H */
diff --git a/subprojects/c-ares/src/lib/ares__close_sockets.c b/subprojects/c-ares/src/lib/ares__close_sockets.c
@@ -0,0 +1,111 @@
+/* MIT License
+ *
+ * Copyright (c) 1998 Massachusetts Institute of Technology
+ * Copyright (c) The c-ares project and its contributors
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice (including the next
+ * paragraph) shall be included in all copies or substantial portions of the
+ * Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ *
+ * SPDX-License-Identifier: MIT
+ */
+
+#include "ares_setup.h"
+
+#include "ares.h"
+#include "ares_private.h"
+#include <assert.h>
+
+static void ares__requeue_queries(struct server_connection *conn)
+{
+ struct query *query;
+ struct timeval now = ares__tvnow();
+
+ while ((query = ares__llist_first_val(conn->queries_to_conn)) != NULL) {
+ ares__requeue_query(query, &now);
+ }
+}
+
+void ares__close_connection(struct server_connection *conn)
+{
+ struct server_state *server = conn->server;
+ ares_channel_t *channel = server->channel;
+
+ /* Unlink */
+ ares__llist_node_claim(
+ ares__htable_asvp_get_direct(channel->connnode_by_socket, conn->fd));
+ ares__htable_asvp_remove(channel->connnode_by_socket, conn->fd);
+
+ if (conn->is_tcp) {
+ /* Reset any existing input and output buffer. */
+ ares__buf_consume(server->tcp_parser, ares__buf_len(server->tcp_parser));
+ ares__buf_consume(server->tcp_send, ares__buf_len(server->tcp_send));
+ server->tcp_conn = NULL;
+ }
+
+ /* Requeue queries to other connections */
+ ares__requeue_queries(conn);
+
+ ares__llist_destroy(conn->queries_to_conn);
+
+ SOCK_STATE_CALLBACK(channel, conn->fd, 0, 0);
+ ares__close_socket(channel, conn->fd);
+
+ ares_free(conn);
+}
+
+void ares__close_sockets(struct server_state *server)
+{
+ ares__llist_node_t *node;
+
+ while ((node = ares__llist_node_first(server->connections)) != NULL) {
+ struct server_connection *conn = ares__llist_node_val(node);
+ ares__close_connection(conn);
+ }
+}
+
+void ares__check_cleanup_conn(const ares_channel_t *channel,
+ struct server_connection *conn)
+{
+ ares_bool_t do_cleanup = ARES_FALSE;
+
+ if (channel == NULL || conn == NULL) {
+ return;
+ }
+
+ if (ares__llist_len(conn->queries_to_conn)) {
+ return;
+ }
+
+ /* If we are configured not to stay open, close it out */
+ if (!(channel->flags & ARES_FLAG_STAYOPEN)) {
+ do_cleanup = ARES_TRUE;
+ }
+
+ /* If the udp connection hit its max queries, always close it */
+ if (!conn->is_tcp && channel->udp_max_queries > 0 &&
+ conn->total_queries >= channel->udp_max_queries) {
+ do_cleanup = ARES_TRUE;
+ }
+
+ if (!do_cleanup) {
+ return;
+ }
+
+ ares__close_connection(conn);
+}
diff --git a/subprojects/c-ares/src/lib/ares__hosts_file.c b/subprojects/c-ares/src/lib/ares__hosts_file.c
@@ -0,0 +1,1119 @@
+/* MIT License
+ *
+ * Copyright (c) 2023 Brad House
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice (including the next
+ * paragraph) shall be included in all copies or substantial portions of the
+ * Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ *
+ * SPDX-License-Identifier: MIT
+ */
+#include "ares_setup.h"
+#include "ares.h"
+#include "ares_private.h"
+#ifdef HAVE_SYS_TYPES_H
+# include <sys/types.h>
+#endif
+#ifdef HAVE_SYS_STAT_H
+# include <sys/stat.h>
+#endif
+#ifdef HAVE_NETINET_IN_H
+# include <netinet/in.h>
+#endif
+#ifdef HAVE_NETDB_H
+# include <netdb.h>
+#endif
+#ifdef HAVE_ARPA_INET_H
+# include <arpa/inet.h>
+#endif
+#include <time.h>
+#include "ares_platform.h"
+
+/* HOSTS FILE PROCESSING OVERVIEW
+ * ==============================
+ * The hosts file on the system contains static entries to be processed locally
+ * rather than querying the nameserver. Each row is an IP address followed by
+ * a list of space delimited hostnames that match the ip address. This is used
+ * for both forward and reverse lookups.
+ *
+ * We are caching the entire parsed hosts file for performance reasons. Some
+ * files may be quite sizable and as per Issue #458 can approach 1/2MB in size,
+ * and the parse overhead on a rapid succession of queries can be quite large.
+ * The entries are stored in forwards and backwards hashtables so we can get
+ * O(1) performance on lookup. The file is cached until the file modification
+ * timestamp changes.
+ *
+ * The hosts file processing is quite unique. It has to merge all related hosts
+ * and ips into a single entry due to file formatting requirements. For
+ * instance take the below:
+ *
+ * 127.0.0.1 localhost.localdomain localhost
+ * ::1 localhost.localdomain localhost
+ * 192.168.1.1 host.example.com host
+ * 192.168.1.5 host.example.com host
+ * 2620:1234::1 host.example.com host6.example.com host6 host
+ *
+ * This will yield 2 entries.
+ * 1) ips: 127.0.0.1,::1
+ * hosts: localhost.localdomain,localhost
+ * 2) ips: 192.168.1.1,192.168.1.5,2620:1234::1
+ * hosts: host.example.com,host,host6.example.com,host6
+ *
+ * It could be argued that if searching for 192.168.1.1 that the 'host6'
+ * hostnames should not be returned, but this implementation will return them
+ * since they are related. It is unlikely this will matter in the real world.
+ */
+
+struct ares_hosts_file {
+ time_t ts;
+ /*! cache the filename so we know if the filename changes it automatically
+ * invalidates the cache */
+ char *filename;
+ /*! iphash is the owner of the 'entry' object as there is only ever a single
+ * match to the object. */
+ ares__htable_strvp_t *iphash;
+ /*! hosthash does not own the entry so won't free on destruction */
+ ares__htable_strvp_t *hosthash;
+};
+
+struct ares_hosts_entry {
+ size_t refcnt; /*! If the entry is stored multiple times in the
+ * ip address hash, we have to reference count it */
+ ares__llist_t *ips;
+ ares__llist_t *hosts;
+};
+
+static ares_status_t ares__read_file_into_buf(const char *filename,
+ ares__buf_t *buf)
+{
+ FILE *fp = NULL;
+ unsigned char *ptr = NULL;
+ size_t len = 0;
+ size_t ptr_len = 0;
+ long ftell_len = 0;
+ ares_status_t status;
+
+ if (filename == NULL || buf == NULL) {
+ return ARES_EFORMERR;
+ }
+
+ fp = fopen(filename, "rb");
+ if (fp == NULL) {
+ int error = ERRNO;
+ switch (error) {
+ case ENOENT:
+ case ESRCH:
+ status = ARES_ENOTFOUND;
+ goto done;
+ default:
+ DEBUGF(fprintf(stderr, "fopen() failed with error: %d %s\n", error,
+ strerror(error)));
+ DEBUGF(fprintf(stderr, "Error opening file: %s\n", filename));
+ status = ARES_EFILE;
+ goto done;
+ }
+ }
+
+ /* Get length portably, fstat() is POSIX, not C */
+ if (fseek(fp, 0, SEEK_END) != 0) {
+ status = ARES_EFILE;
+ goto done;
+ }
+
+ ftell_len = ftell(fp);
+ if (ftell_len < 0) {
+ status = ARES_EFILE;
+ goto done;
+ }
+ len = (size_t)ftell_len;
+
+ if (fseek(fp, 0, SEEK_SET) != 0) {
+ status = ARES_EFILE;
+ goto done;
+ }
+
+ if (len == 0) {
+ status = ARES_SUCCESS;
+ goto done;
+ }
+
+ /* Read entire data into buffer */
+ ptr_len = len;
+ ptr = ares__buf_append_start(buf, &ptr_len);
+ if (ptr == NULL) {
+ status = ARES_ENOMEM;
+ goto done;
+ }
+
+ ptr_len = fread(ptr, 1, len, fp);
+ if (ptr_len != len) {
+ status = ARES_EFILE;
+ goto done;
+ }
+
+ ares__buf_append_finish(buf, len);
+ status = ARES_SUCCESS;
+
+done:
+ if (fp != NULL) {
+ fclose(fp);
+ }
+ return status;
+}
+
+static ares_bool_t ares__is_hostname(const char *str)
+{
+ size_t i;
+ for (i = 0; str[i] != 0; i++) {
+ if (!ares__is_hostnamech(str[i])) {
+ return ARES_FALSE;
+ }
+ }
+ return ARES_TRUE;
+}
+
+const void *ares_dns_pton(const char *ipaddr, struct ares_addr *addr,
+ size_t *out_len)
+{
+ const void *ptr = NULL;
+ size_t ptr_len = 0;
+
+ if (ipaddr == NULL || addr == NULL || out_len == NULL) {
+ return NULL;
+ }
+
+ *out_len = 0;
+
+ if (addr->family == AF_INET &&
+ ares_inet_pton(AF_INET, ipaddr, &addr->addr.addr4) > 0) {
+ ptr = &addr->addr.addr4;
+ ptr_len = sizeof(addr->addr.addr4);
+ } else if (addr->family == AF_INET6 &&
+ ares_inet_pton(AF_INET6, ipaddr, &addr->addr.addr6) > 0) {
+ ptr = &addr->addr.addr6;
+ ptr_len = sizeof(addr->addr.addr6);
+ } else if (addr->family == AF_UNSPEC) {
+ if (ares_inet_pton(AF_INET, ipaddr, &addr->addr.addr4) > 0) {
+ addr->family = AF_INET;
+ ptr = &addr->addr.addr4;
+ ptr_len = sizeof(addr->addr.addr4);
+ } else if (ares_inet_pton(AF_INET6, ipaddr, &addr->addr.addr6) > 0) {
+ addr->family = AF_INET6;
+ ptr = &addr->addr.addr6;
+ ptr_len = sizeof(addr->addr.addr6);
+ }
+ }
+
+ *out_len = ptr_len;
+ return ptr;
+}
+
+static ares_bool_t ares__normalize_ipaddr(const char *ipaddr, char *out,
+ size_t out_len)
+{
+ struct ares_addr data;
+ const void *addr;
+ size_t addr_len = 0;
+
+ memset(&data, 0, sizeof(data));
+ data.family = AF_UNSPEC;
+
+ addr = ares_dns_pton(ipaddr, &data, &addr_len);
+ if (addr == NULL) {
+ return ARES_FALSE;
+ }
+
+ if (!ares_inet_ntop(data.family, addr, out, (ares_socklen_t)out_len)) {
+ return ARES_FALSE;
+ }
+
+ return ARES_TRUE;
+}
+
+static void ares__hosts_entry_destroy(ares_hosts_entry_t *entry)
+{
+ if (entry == NULL) {
+ return;
+ }
+
+ /* Honor reference counting */
+ if (entry->refcnt != 0) {
+ entry->refcnt--;
+ }
+
+ if (entry->refcnt > 0) {
+ return;
+ }
+
+ ares__llist_destroy(entry->hosts);
+ ares__llist_destroy(entry->ips);
+ ares_free(entry);
+}
+
+static void ares__hosts_entry_destroy_cb(void *entry)
+{
+ ares__hosts_entry_destroy(entry);
+}
+
+void ares__hosts_file_destroy(ares_hosts_file_t *hf)
+{
+ if (hf == NULL) {
+ return;
+ }
+
+ ares_free(hf->filename);
+ ares__htable_strvp_destroy(hf->hosthash);
+ ares__htable_strvp_destroy(hf->iphash);
+ ares_free(hf);
+}
+
+static ares_hosts_file_t *ares__hosts_file_create(const char *filename)
+{
+ ares_hosts_file_t *hf = ares_malloc_zero(sizeof(*hf));
+ if (hf == NULL) {
+ goto fail;
+ }
+
+ hf->ts = time(NULL);
+
+ hf->filename = ares_strdup(filename);
+ if (hf->filename == NULL) {
+ goto fail;
+ }
+
+ hf->iphash = ares__htable_strvp_create(ares__hosts_entry_destroy_cb);
+ if (hf->iphash == NULL) {
+ goto fail;
+ }
+
+ hf->hosthash = ares__htable_strvp_create(NULL);
+ if (hf->hosthash == NULL) {
+ goto fail;
+ }
+
+ return hf;
+
+fail:
+ ares__hosts_file_destroy(hf);
+ return NULL;
+}
+
+typedef enum {
+ ARES_MATCH_NONE = 0,
+ ARES_MATCH_IPADDR = 1,
+ ARES_MATCH_HOST = 2
+} ares_hosts_file_match_t;
+
+static ares_status_t ares__hosts_file_merge_entry(
+ const ares_hosts_file_t *hf, ares_hosts_entry_t *existing,
+ ares_hosts_entry_t *entry, ares_hosts_file_match_t matchtype)
+{
+ ares__llist_node_t *node;
+
+ /* If we matched on IP address, we know there can only be 1, so there's no
+ * reason to do anything */
+ if (matchtype != ARES_MATCH_IPADDR) {
+ while ((node = ares__llist_node_first(entry->ips)) != NULL) {
+ const char *ipaddr = ares__llist_node_val(node);
+
+ if (ares__htable_strvp_get_direct(hf->iphash, ipaddr) != NULL) {
+ ares__llist_node_destroy(node);
+ continue;
+ }
+
+ ares__llist_node_move_parent_last(node, existing->ips);
+ }
+ }
+
+
+ while ((node = ares__llist_node_first(entry->hosts)) != NULL) {
+ const char *hostname = ares__llist_node_val(node);
+
+ if (ares__htable_strvp_get_direct(hf->hosthash, hostname) != NULL) {
+ ares__llist_node_destroy(node);
+ continue;
+ }
+
+ ares__llist_node_move_parent_last(node, existing->hosts);
+ }
+
+ ares__hosts_entry_destroy(entry);
+ return ARES_SUCCESS;
+}
+
+static ares_hosts_file_match_t
+ ares__hosts_file_match(const ares_hosts_file_t *hf, ares_hosts_entry_t *entry,
+ ares_hosts_entry_t **match)
+{
+ ares__llist_node_t *node;
+ *match = NULL;
+
+ for (node = ares__llist_node_first(entry->ips); node != NULL;
+ node = ares__llist_node_next(node)) {
+ const char *ipaddr = ares__llist_node_val(node);
+ *match = ares__htable_strvp_get_direct(hf->iphash, ipaddr);
+ if (*match != NULL) {
+ return ARES_MATCH_IPADDR;
+ }
+ }
+
+ for (node = ares__llist_node_first(entry->hosts); node != NULL;
+ node = ares__llist_node_next(node)) {
+ const char *host = ares__llist_node_val(node);
+ *match = ares__htable_strvp_get_direct(hf->hosthash, host);
+ if (*match != NULL) {
+ return ARES_MATCH_HOST;
+ }
+ }
+
+ return ARES_MATCH_NONE;
+}
+
+/*! entry is invalidated upon calling this function, always, even on error */
+static ares_status_t ares__hosts_file_add(ares_hosts_file_t *hosts,
+ ares_hosts_entry_t *entry)
+{
+ ares_hosts_entry_t *match = NULL;
+ ares_status_t status = ARES_SUCCESS;
+ ares__llist_node_t *node;
+ ares_hosts_file_match_t matchtype;
+ size_t num_hostnames;
+
+ /* Record the number of hostnames in this entry file. If we merge into an
+ * existing record, these will be *appended* to the entry, so we'll count
+ * backwards when adding to the hosts hashtable */
+ num_hostnames = ares__llist_len(entry->hosts);
+
+ matchtype = ares__hosts_file_match(hosts, entry, &match);
+
+ if (matchtype != ARES_MATCH_NONE) {
+ status = ares__hosts_file_merge_entry(hosts, match, entry, matchtype);
+ if (status != ARES_SUCCESS) {
+ ares__hosts_entry_destroy(entry);
+ return status;
+ }
+ /* entry was invalidated above by merging */
+ entry = match;
+ }
+
+ if (matchtype != ARES_MATCH_IPADDR) {
+ const char *ipaddr = ares__llist_last_val(entry->ips);
+
+ if (!ares__htable_strvp_get(hosts->iphash, ipaddr, NULL)) {
+ if (!ares__htable_strvp_insert(hosts->iphash, ipaddr, entry)) {
+ ares__hosts_entry_destroy(entry);
+ return ARES_ENOMEM;
+ }
+ entry->refcnt++;
+ }
+ }
+
+ /* Go backwards, on a merge, hostnames are appended. Breakout once we've
+ * consumed all the hosts that we appended */
+ for (node = ares__llist_node_last(entry->hosts); node != NULL;
+ node = ares__llist_node_prev(node)) {
+ const char *val = ares__llist_node_val(node);
+
+ if (num_hostnames == 0) {
+ break;
+ }
+
+ num_hostnames--;
+
+ /* first hostname match wins. If we detect a duplicate hostname for another
+ * ip it will automatically be added to the same entry */
+ if (ares__htable_strvp_get(hosts->hosthash, val, NULL)) {
+ continue;
+ }
+
+ if (!ares__htable_strvp_insert(hosts->hosthash, val, entry)) {
+ return ARES_ENOMEM;
+ }
+ }
+
+ return ARES_SUCCESS;
+}
+
+static ares_bool_t ares__hosts_entry_isdup(ares_hosts_entry_t *entry,
+ const char *host)
+{
+ ares__llist_node_t *node;
+
+ for (node = ares__llist_node_first(entry->ips); node != NULL;
+ node = ares__llist_node_next(node)) {
+ const char *myhost = ares__llist_node_val(node);
+ if (strcasecmp(myhost, host) == 0) {
+ return ARES_TRUE;
+ }
+ }
+
+ return ARES_FALSE;
+}
+
+static ares_status_t ares__parse_hosts_hostnames(ares__buf_t *buf,
+ ares_hosts_entry_t *entry)
+{
+ entry->hosts = ares__llist_create(ares_free);
+ if (entry->hosts == NULL) {
+ return ARES_ENOMEM;
+ }
+
+ /* Parse hostnames and aliases */
+ while (ares__buf_len(buf)) {
+ char hostname[256];
+ char *temp;
+ ares_status_t status;
+ unsigned char comment = '#';
+
+ ares__buf_consume_whitespace(buf, ARES_FALSE);
+
+ if (ares__buf_len(buf) == 0) {
+ break;
+ }
+
+ /* See if it is a comment, if so stop processing */
+ if (ares__buf_begins_with(buf, &comment, 1)) {
+ break;
+ }
+
+ ares__buf_tag(buf);
+
+ /* Must be at end of line */
+ if (ares__buf_consume_nonwhitespace(buf) == 0) {
+ break;
+ }
+
+ status = ares__buf_tag_fetch_string(buf, hostname, sizeof(hostname));
+ if (status != ARES_SUCCESS) {
+ /* Bad entry, just ignore as long as its not the first. If its the first,
+ * it must be valid */
+ if (ares__llist_len(entry->hosts) == 0) {
+ return ARES_EBADSTR;
+ }
+
+ continue;
+ }
+
+ /* Validate it is a valid hostname characterset */
+ if (!ares__is_hostname(hostname)) {
+ continue;
+ }
+
+ /* Don't add a duplicate to the same entry */
+ if (ares__hosts_entry_isdup(entry, hostname)) {
+ continue;
+ }
+
+ /* Add to list */
+ temp = ares_strdup(hostname);
+ if (temp == NULL) {
+ return ARES_ENOMEM;
+ }
+
+ if (ares__llist_insert_last(entry->hosts, temp) == NULL) {
+ ares_free(temp);
+ return ARES_ENOMEM;
+ }
+ }
+
+ /* Must have at least 1 entry */
+ if (ares__llist_len(entry->hosts) == 0) {
+ return ARES_EBADSTR;
+ }
+
+ return ARES_SUCCESS;
+}
+
+static ares_status_t ares__parse_hosts_ipaddr(ares__buf_t *buf,
+ ares_hosts_entry_t **entry_out)
+{
+ char addr[INET6_ADDRSTRLEN];
+ char *temp;
+ ares_hosts_entry_t *entry = NULL;
+ ares_status_t status;
+
+ *entry_out = NULL;
+
+ ares__buf_tag(buf);
+ ares__buf_consume_nonwhitespace(buf);
+ status = ares__buf_tag_fetch_string(buf, addr, sizeof(addr));
+ if (status != ARES_SUCCESS) {
+ return status;
+ }
+
+ /* Validate and normalize the ip address format */
+ if (!ares__normalize_ipaddr(addr, addr, sizeof(addr))) {
+ return ARES_EBADSTR;
+ }
+
+ entry = ares_malloc_zero(sizeof(*entry));
+ if (entry == NULL) {
+ return ARES_ENOMEM;
+ }
+
+ entry->ips = ares__llist_create(ares_free);
+ if (entry->ips == NULL) {
+ ares__hosts_entry_destroy(entry);
+ return ARES_ENOMEM;
+ }
+
+ temp = ares_strdup(addr);
+ if (temp == NULL) {
+ ares__hosts_entry_destroy(entry);
+ return ARES_ENOMEM;
+ }
+
+ if (ares__llist_insert_first(entry->ips, temp) == NULL) {
+ ares_free(temp);
+ ares__hosts_entry_destroy(entry);
+ return ARES_ENOMEM;
+ }
+
+ *entry_out = entry;
+
+ return ARES_SUCCESS;
+}
+
+static ares_status_t ares__parse_hosts(const char *filename,
+ ares_hosts_file_t **out)
+{
+ ares__buf_t *buf = NULL;
+ ares_status_t status = ARES_EBADRESP;
+ ares_hosts_file_t *hf = NULL;
+ ares_hosts_entry_t *entry = NULL;
+
+ *out = NULL;
+
+ buf = ares__buf_create();
+ if (buf == NULL) {
+ status = ARES_ENOMEM;
+ goto done;
+ }
+
+ status = ares__read_file_into_buf(filename, buf);
+ if (status != ARES_SUCCESS) {
+ goto done;
+ }
+
+ hf = ares__hosts_file_create(filename);
+ if (hf == NULL) {
+ status = ARES_ENOMEM;
+ goto done;
+ }
+
+ while (ares__buf_len(buf)) {
+ unsigned char comment = '#';
+
+ /* -- Start of new line here -- */
+
+ /* Consume any leading whitespace */
+ ares__buf_consume_whitespace(buf, ARES_FALSE);
+
+ if (ares__buf_len(buf) == 0) {
+ break;
+ }
+
+ /* See if it is a comment, if so, consume remaining line */
+ if (ares__buf_begins_with(buf, &comment, 1)) {
+ ares__buf_consume_line(buf, ARES_TRUE);
+ continue;
+ }
+
+ /* Pull off ip address */
+ status = ares__parse_hosts_ipaddr(buf, &entry);
+ if (status == ARES_ENOMEM) {
+ goto done;
+ }
+ if (status != ARES_SUCCESS) {
+ /* Bad line, consume and go onto next */
+ ares__buf_consume_line(buf, ARES_TRUE);
+ continue;
+ }
+
+ /* Parse of the hostnames */
+ status = ares__parse_hosts_hostnames(buf, entry);
+ if (status == ARES_ENOMEM) {
+ goto done;
+ } else if (status != ARES_SUCCESS) {
+ /* Bad line, consume and go onto next */
+ ares__hosts_entry_destroy(entry);
+ entry = NULL;
+ ares__buf_consume_line(buf, ARES_TRUE);
+ continue;
+ }
+
+ /* Append the successful entry to the hosts file */
+ status = ares__hosts_file_add(hf, entry);
+ entry = NULL; /* is always invalidated by this function, even on error */
+ if (status != ARES_SUCCESS) {
+ goto done;
+ }
+
+ /* Go to next line */
+ ares__buf_consume_line(buf, ARES_TRUE);
+ }
+
+ status = ARES_SUCCESS;
+
+done:
+ ares__hosts_entry_destroy(entry);
+ ares__buf_destroy(buf);
+ if (status != ARES_SUCCESS) {
+ ares__hosts_file_destroy(hf);
+ } else {
+ *out = hf;
+ }
+ return status;
+}
+
+static ares_bool_t ares__hosts_expired(const char *filename,
+ const ares_hosts_file_t *hf)
+{
+ time_t mod_ts = 0;
+
+#ifdef HAVE_STAT
+ struct stat st;
+ if (stat(filename, &st) == 0) {
+ mod_ts = st.st_mtime;
+ }
+#elif defined(_WIN32)
+ struct _stat st;
+ if (_stat(filename, &st) == 0) {
+ mod_ts = st.st_mtime;
+ }
+#else
+ (void)filename;
+#endif
+
+ if (hf == NULL) {
+ return ARES_TRUE;
+ }
+
+ /* Expire every 60s if we can't get a time */
+ if (mod_ts == 0) {
+ mod_ts = time(NULL) - 60;
+ }
+
+ /* If filenames are different, its expired */
+ if (strcasecmp(hf->filename, filename) != 0) {
+ return ARES_TRUE;
+ }
+
+ if (hf->ts <= mod_ts) {
+ return ARES_TRUE;
+ }
+
+ return ARES_FALSE;
+}
+
+static ares_status_t ares__hosts_path(const ares_channel_t *channel,
+ ares_bool_t use_env, char **path)
+{
+ char *path_hosts = NULL;
+
+ *path = NULL;
+
+ if (channel->hosts_path) {
+ path_hosts = ares_strdup(channel->hosts_path);
+ if (!path_hosts) {
+ return ARES_ENOMEM;
+ }
+ }
+
+ if (use_env) {
+ if (path_hosts) {
+ ares_free(path_hosts);
+ }
+
+ path_hosts = ares_strdup(getenv("CARES_HOSTS"));
+ if (!path_hosts) {
+ return ARES_ENOMEM;
+ }
+ }
+
+ if (!path_hosts) {
+#ifdef WIN32
+ char PATH_HOSTS[MAX_PATH] = "";
+ char tmp[MAX_PATH];
+ HKEY hkeyHosts;
+ DWORD dwLength = sizeof(tmp);
+ if (RegOpenKeyExA(HKEY_LOCAL_MACHINE, WIN_NS_NT_KEY, 0, KEY_READ,
+ &hkeyHosts) != ERROR_SUCCESS) {
+ return ARES_ENOTFOUND;
+ }
+ RegQueryValueExA(hkeyHosts, DATABASEPATH, NULL, NULL, (LPBYTE)tmp,
+ &dwLength);
+ ExpandEnvironmentStringsA(tmp, PATH_HOSTS, MAX_PATH);
+ RegCloseKey(hkeyHosts);
+ strcat(PATH_HOSTS, WIN_PATH_HOSTS);
+#elif defined(WATT32)
+ const char *PATH_HOSTS = _w32_GetHostsFile();
+
+ if (!PATH_HOSTS) {
+ return ARES_ENOTFOUND;
+ }
+#endif
+ path_hosts = ares_strdup(PATH_HOSTS);
+ if (!path_hosts) {
+ return ARES_ENOMEM;
+ }
+ }
+
+ *path = path_hosts;
+ return ARES_SUCCESS;
+}
+
+static ares_status_t ares__hosts_update(ares_channel_t *channel,
+ ares_bool_t use_env)
+{
+ ares_status_t status;
+ char *filename = NULL;
+
+ status = ares__hosts_path(channel, use_env, &filename);
+ if (status != ARES_SUCCESS) {
+ return status;
+ }
+
+ if (!ares__hosts_expired(filename, channel->hf)) {
+ ares_free(filename);
+ return ARES_SUCCESS;
+ }
+
+ ares__hosts_file_destroy(channel->hf);
+ channel->hf = NULL;
+
+ status = ares__parse_hosts(filename, &channel->hf);
+ ares_free(filename);
+ return status;
+}
+
+ares_status_t ares__hosts_search_ipaddr(ares_channel_t *channel,
+ ares_bool_t use_env, const char *ipaddr,
+ const ares_hosts_entry_t **entry)
+{
+ ares_status_t status;
+ char addr[INET6_ADDRSTRLEN];
+
+ *entry = NULL;
+
+ status = ares__hosts_update(channel, use_env);
+ if (status != ARES_SUCCESS) {
+ return status;
+ }
+
+ if (channel->hf == NULL) {
+ return ARES_ENOTFOUND;
+ }
+
+ if (!ares__normalize_ipaddr(ipaddr, addr, sizeof(addr))) {
+ return ARES_EBADNAME;
+ }
+
+ *entry = ares__htable_strvp_get_direct(channel->hf->iphash, addr);
+ if (*entry == NULL) {
+ return ARES_ENOTFOUND;
+ }
+
+ return ARES_SUCCESS;
+}
+
+ares_status_t ares__hosts_search_host(ares_channel_t *channel,
+ ares_bool_t use_env, const char *host,
+ const ares_hosts_entry_t **entry)
+{
+ ares_status_t status;
+
+ *entry = NULL;
+
+ status = ares__hosts_update(channel, use_env);
+ if (status != ARES_SUCCESS) {
+ return status;
+ }
+
+ if (channel->hf == NULL) {
+ return ARES_ENOTFOUND;
+ }
+
+ *entry = ares__htable_strvp_get_direct(channel->hf->hosthash, host);
+ if (*entry == NULL) {
+ return ARES_ENOTFOUND;
+ }
+
+ return ARES_SUCCESS;
+}
+
+ares_status_t ares__hosts_entry_to_hostent(const ares_hosts_entry_t *entry,
+ int family, struct hostent **hostent)
+{
+ ares_status_t status;
+ size_t naliases;
+ ares__llist_node_t *node;
+ size_t idx;
+
+ *hostent = ares_malloc_zero(sizeof(**hostent));
+ if (*hostent == NULL) {
+ status = ARES_ENOMEM;
+ goto fail;
+ }
+
+ (*hostent)->h_addrtype = (HOSTENT_ADDRTYPE_TYPE)family;
+
+ /* Copy IP addresses that match the address family */
+ idx = 0;
+ for (node = ares__llist_node_first(entry->ips); node != NULL;
+ node = ares__llist_node_next(node)) {
+ struct ares_addr addr;
+ const void *ptr = NULL;
+ size_t ptr_len = 0;
+ const char *ipaddr = ares__llist_node_val(node);
+ char **temp = NULL;
+
+ memset(&addr, 0, sizeof(addr));
+
+ addr.family = family;
+ ptr = ares_dns_pton(ipaddr, &addr, &ptr_len);
+ if (ptr == NULL) {
+ continue;
+ }
+
+ /* If family == AF_UNSPEC, then we want to inherit this for future
+ * conversions as we can only support a single address class */
+ if (family == AF_UNSPEC) {
+ family = addr.family;
+ (*hostent)->h_addrtype = (HOSTENT_ADDRTYPE_TYPE)addr.family;
+ }
+
+ temp = ares_realloc_zero((*hostent)->h_addr_list,
+ (idx + 1) * sizeof(*(*hostent)->h_addr_list),
+ (idx + 2) * sizeof(*(*hostent)->h_addr_list));
+ if (temp == NULL) {
+ status = ARES_ENOMEM;
+ goto fail;
+ }
+
+ (*hostent)->h_addr_list = temp;
+
+ (*hostent)->h_addr_list[idx] = ares_malloc(ptr_len);
+ if ((*hostent)->h_addr_list[idx] == NULL) {
+ status = ARES_ENOMEM;
+ goto fail;
+ }
+
+ memcpy((*hostent)->h_addr_list[idx], ptr, ptr_len);
+ idx++;
+ (*hostent)->h_length = (HOSTENT_LENGTH_TYPE)ptr_len;
+ }
+
+ /* entry didn't match address class */
+ if (idx == 0) {
+ status = ARES_ENOTFOUND;
+ goto fail;
+ }
+
+ /* Copy main hostname */
+ (*hostent)->h_name = ares_strdup(ares__llist_first_val(entry->hosts));
+ if ((*hostent)->h_name == NULL) {
+ status = ARES_ENOMEM;
+ goto fail;
+ }
+
+ /* Copy aliases */
+ naliases = ares__llist_len(entry->hosts) - 1;
+
+ /* Cap at 100, some people use https://github.com/StevenBlack/hosts and we
+ * don't need 200k+ aliases */
+ if (naliases > 100) {
+ naliases = 100;
+ }
+
+ (*hostent)->h_aliases =
+ ares_malloc_zero((naliases + 1) * sizeof(*(*hostent)->h_aliases));
+ if ((*hostent)->h_aliases == NULL) {
+ status = ARES_ENOMEM;
+ goto fail;
+ }
+
+ /* Copy all entries to the alias except the first */
+ idx = 0;
+ node = ares__llist_node_first(entry->hosts);
+ node = ares__llist_node_next(node);
+ while (node != NULL) {
+ (*hostent)->h_aliases[idx] = ares_strdup(ares__llist_node_val(node));
+ if ((*hostent)->h_aliases[idx] == NULL) {
+ status = ARES_ENOMEM;
+ goto fail;
+ }
+ idx++;
+
+ /* Break out if artificially capped */
+ if (idx == naliases) {
+ break;
+ }
+ node = ares__llist_node_next(node);
+ }
+
+ return ARES_SUCCESS;
+
+fail:
+ ares_free_hostent(*hostent);
+ *hostent = NULL;
+ return status;
+}
+
+static ares_status_t
+ ares__hosts_ai_append_cnames(const ares_hosts_entry_t *entry,
+ struct ares_addrinfo_cname **cnames_out)
+{
+ struct ares_addrinfo_cname *cname = NULL;
+ struct ares_addrinfo_cname *cnames = NULL;
+ const char *primaryhost;
+ ares__llist_node_t *node;
+ ares_status_t status;
+ size_t cnt = 0;
+
+ node = ares__llist_node_first(entry->hosts);
+ primaryhost = ares__llist_node_val(node);
+ /* Skip to next node to start with aliases */
+ node = ares__llist_node_next(node);
+
+ while (node != NULL) {
+ const char *host = ares__llist_node_val(node);
+
+ /* Cap at 100 entries. , some people use
+ * https://github.com/StevenBlack/hosts and we don't need 200k+ aliases */
+ cnt++;
+ if (cnt > 100) {
+ break;
+ }
+
+ cname = ares__append_addrinfo_cname(&cnames);
+ if (cname == NULL) {
+ status = ARES_ENOMEM;
+ goto done;
+ }
+
+ cname->alias = ares_strdup(host);
+ if (cname->alias == NULL) {
+ status = ARES_ENOMEM;
+ goto done;
+ }
+
+ cname->name = ares_strdup(primaryhost);
+ if (cname->name == NULL) {
+ status = ARES_ENOMEM;
+ goto done;
+ }
+
+ node = ares__llist_node_next(node);
+ }
+
+ /* No entries, add only primary */
+ if (cnames == NULL) {
+ cname = ares__append_addrinfo_cname(&cnames);
+ if (cname == NULL) {
+ status = ARES_ENOMEM;
+ goto done;
+ }
+
+ cname->name = ares_strdup(primaryhost);
+ if (cname->name == NULL) {
+ status = ARES_ENOMEM;
+ goto done;
+ }
+ }
+ status = ARES_SUCCESS;
+
+done:
+ if (status != ARES_SUCCESS) {
+ ares__freeaddrinfo_cnames(cnames);
+ return status;
+ }
+
+ *cnames_out = cnames;
+ return ARES_SUCCESS;
+}
+
+ares_status_t ares__hosts_entry_to_addrinfo(const ares_hosts_entry_t *entry,
+ const char *name, int family,
+ unsigned short port,
+ ares_bool_t want_cnames,
+ struct ares_addrinfo *ai)
+{
+ ares_status_t status;
+ struct ares_addrinfo_cname *cnames = NULL;
+ struct ares_addrinfo_node *ainodes = NULL;
+ ares__llist_node_t *node;
+
+ switch (family) {
+ case AF_INET:
+ case AF_INET6:
+ case AF_UNSPEC:
+ break;
+ default:
+ return ARES_EBADFAMILY;
+ }
+
+ ai->name = ares_strdup(name);
+ if (ai->name == NULL) {
+ status = ARES_ENOMEM;
+ goto done;
+ }
+
+ for (node = ares__llist_node_first(entry->ips); node != NULL;
+ node = ares__llist_node_next(node)) {
+ struct ares_addr addr;
+ const void *ptr = NULL;
+ size_t ptr_len = 0;
+ const char *ipaddr = ares__llist_node_val(node);
+
+ memset(&addr, 0, sizeof(addr));
+ addr.family = family;
+ ptr = ares_dns_pton(ipaddr, &addr, &ptr_len);
+
+ if (ptr == NULL) {
+ continue;
+ }
+
+ status = ares_append_ai_node(addr.family, port, 0, ptr, &ainodes);
+ if (status != ARES_SUCCESS) {
+ goto done;
+ }
+ }
+
+ if (want_cnames) {
+ status = ares__hosts_ai_append_cnames(entry, &cnames);
+ if (status != ARES_SUCCESS) {
+ goto done;
+ }
+ }
+
+ status = ARES_SUCCESS;
+
+done:
+ if (status != ARES_SUCCESS) {
+ ares__freeaddrinfo_cnames(cnames);
+ ares__freeaddrinfo_nodes(ainodes);
+ ares_free(ai->name);
+ ai->name = NULL;
+ return status;
+ }
+ ares__addrinfo_cat_cnames(&ai->cnames, cnames);
+ ares__addrinfo_cat_nodes(&ai->nodes, ainodes);
+
+ return status;
+}
diff --git a/subprojects/c-ares/src/lib/ares__htable.c b/subprojects/c-ares/src/lib/ares__htable.c
@@ -0,0 +1,417 @@
+/* MIT License
+ *
+ * Copyright (c) 2023 Brad House
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice (including the next
+ * paragraph) shall be included in all copies or substantial portions of the
+ * Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ *
+ * SPDX-License-Identifier: MIT
+ */
+#include "ares_setup.h"
+#include "ares.h"
+#include "ares_private.h"
+#include "ares__llist.h"
+#include "ares__htable.h"
+
+#define ARES__HTABLE_MAX_BUCKETS (1U << 24)
+#define ARES__HTABLE_MIN_BUCKETS (1U << 4)
+#define ARES__HTABLE_EXPAND_PERCENT 75
+
+struct ares__htable {
+ ares__htable_hashfunc_t hash;
+ ares__htable_bucket_key_t bucket_key;
+ ares__htable_bucket_free_t bucket_free;
+ ares__htable_key_eq_t key_eq;
+ unsigned int seed;
+ unsigned int size;
+ size_t num_keys;
+ size_t num_collisions;
+ /* NOTE: if we converted buckets into ares__slist_t we could guarantee on
+ * hash collisions we would have O(log n) worst case insert and search
+ * performance. (We'd also need to make key_eq into a key_cmp to
+ * support sort). That said, risk with a random hash seed is near zero,
+ * and ares__slist_t is heavier weight, so I think using ares__llist_t
+ * is an overall win. */
+ ares__llist_t **buckets;
+};
+
+static unsigned int ares__htable_generate_seed(ares__htable_t *htable)
+{
+ unsigned int seed = 0;
+ time_t t = time(NULL);
+
+ /* Mix stack address, heap address, and time to generate a random seed, it
+ * doesn't have to be super secure, just quick. Likelihood of a hash
+ * collision attack is very low with a small amount of effort */
+ seed |= (unsigned int)((size_t)htable & 0xFFFFFFFF);
+ seed |= (unsigned int)((size_t)&seed & 0xFFFFFFFF);
+ seed |= (unsigned int)(t & 0xFFFFFFFF);
+ return seed;
+}
+
+static void ares__htable_buckets_destroy(ares__llist_t **buckets,
+ unsigned int size,
+ ares_bool_t destroy_vals)
+{
+ unsigned int i;
+
+ if (buckets == NULL) {
+ return;
+ }
+
+ for (i = 0; i < size; i++) {
+ if (buckets[i] == NULL) {
+ continue;
+ }
+
+ if (!destroy_vals) {
+ ares__llist_replace_destructor(buckets[i], NULL);
+ }
+
+ ares__llist_destroy(buckets[i]);
+ }
+
+ ares_free(buckets);
+}
+
+void ares__htable_destroy(ares__htable_t *htable)
+{
+ if (htable == NULL) {
+ return;
+ }
+ ares__htable_buckets_destroy(htable->buckets, htable->size, ARES_TRUE);
+ ares_free(htable);
+}
+
+ares__htable_t *ares__htable_create(ares__htable_hashfunc_t hash_func,
+ ares__htable_bucket_key_t bucket_key,
+ ares__htable_bucket_free_t bucket_free,
+ ares__htable_key_eq_t key_eq)
+{
+ ares__htable_t *htable = NULL;
+
+ if (hash_func == NULL || bucket_key == NULL || bucket_free == NULL ||
+ key_eq == NULL) {
+ goto fail;
+ }
+
+ htable = ares_malloc_zero(sizeof(*htable));
+ if (htable == NULL) {
+ goto fail;
+ }
+
+ htable->hash = hash_func;
+ htable->bucket_key = bucket_key;
+ htable->bucket_free = bucket_free;
+ htable->key_eq = key_eq;
+ htable->seed = ares__htable_generate_seed(htable);
+ htable->size = ARES__HTABLE_MIN_BUCKETS;
+ htable->buckets = ares_malloc_zero(sizeof(*htable->buckets) * htable->size);
+
+ if (htable->buckets == NULL) {
+ goto fail;
+ }
+
+ return htable;
+
+fail:
+ ares__htable_destroy(htable);
+ return NULL;
+}
+
+/*! Grabs the Hashtable index from the key and length. The h index is
+ * the hash of the function reduced to the size of the bucket list.
+ * We are doing "hash & (size - 1)" since we are guaranteeing a power of
+ * 2 for size. This is equivalent to "hash % size", but should be more
+ * efficient */
+#define HASH_IDX(h, key) h->hash(key, h->seed) & (h->size - 1)
+
+static ares__llist_node_t *ares__htable_find(const ares__htable_t *htable,
+ unsigned int idx, const void *key)
+{
+ ares__llist_node_t *node = NULL;
+
+ for (node = ares__llist_node_first(htable->buckets[idx]); node != NULL;
+ node = ares__llist_node_next(node)) {
+ if (htable->key_eq(key, htable->bucket_key(ares__llist_node_val(node)))) {
+ break;
+ }
+ }
+
+ return node;
+}
+
+static ares_bool_t ares__htable_expand(ares__htable_t *htable)
+{
+ ares__llist_t **buckets = NULL;
+ unsigned int old_size = htable->size;
+ size_t i;
+ ares__llist_t **prealloc_llist = NULL;
+ size_t prealloc_llist_len = 0;
+ ares_bool_t rv = ARES_FALSE;
+
+ /* Not a failure, just won't expand */
+ if (old_size == ARES__HTABLE_MAX_BUCKETS) {
+ return ARES_TRUE;
+ }
+
+ htable->size <<= 1;
+
+ /* We must pre-allocate all memory we'll need before moving entries to the
+ * new hash array. Otherwise if there's a memory allocation failure in the
+ * middle, we wouldn't be able to recover. */
+ buckets = ares_malloc_zero(sizeof(*buckets) * htable->size);
+ if (buckets == NULL) {
+ goto done;
+ }
+
+ /* The maximum number of new llists we'll need is the number of collisions
+ * that were recorded */
+ prealloc_llist_len = htable->num_collisions;
+ if (prealloc_llist_len) {
+ prealloc_llist =
+ ares_malloc_zero(sizeof(*prealloc_llist) * prealloc_llist_len);
+ if (prealloc_llist == NULL) {
+ goto done;
+ }
+ }
+ for (i = 0; i < prealloc_llist_len; i++) {
+ prealloc_llist[i] = ares__llist_create(htable->bucket_free);
+ if (prealloc_llist[i] == NULL) {
+ goto done;
+ }
+ }
+
+ /* Iterate across all buckets and move the entries to the new buckets */
+ htable->num_collisions = 0;
+ for (i = 0; i < old_size; i++) {
+ ares__llist_node_t *node;
+
+ /* Nothing in this bucket */
+ if (htable->buckets[i] == NULL) {
+ continue;
+ }
+
+ /* Fast path optimization (most likely case), there is likely only a single
+ * entry in both the source and destination, check for this to confirm and
+ * if so, just move the bucket over */
+ if (ares__llist_len(htable->buckets[i]) == 1) {
+ const void *val = ares__llist_first_val(htable->buckets[i]);
+ size_t idx = HASH_IDX(htable, htable->bucket_key(val));
+
+ if (buckets[idx] == NULL) {
+ /* Swap! */
+ buckets[idx] = htable->buckets[i];
+ htable->buckets[i] = NULL;
+ continue;
+ }
+ }
+
+ /* Slow path, collisions */
+ while ((node = ares__llist_node_first(htable->buckets[i])) != NULL) {
+ const void *val = ares__llist_node_val(node);
+ size_t idx = HASH_IDX(htable, htable->bucket_key(val));
+
+ /* Try fast path again as maybe we popped one collision off and the
+ * next we can reuse the llist parent */
+ if (buckets[idx] == NULL && ares__llist_len(htable->buckets[i]) == 1) {
+ /* Swap! */
+ buckets[idx] = htable->buckets[i];
+ htable->buckets[i] = NULL;
+ break;
+ }
+
+ /* Grab one off our preallocated list */
+ if (buckets[idx] == NULL) {
+ /* Silence static analysis, this isn't possible but it doesn't know */
+ if (prealloc_llist == NULL || prealloc_llist_len == 0) {
+ goto done;
+ }
+ buckets[idx] = prealloc_llist[prealloc_llist_len - 1];
+ prealloc_llist_len--;
+ } else {
+ /* Collision occurred since the bucket wasn't empty */
+ htable->num_collisions++;
+ }
+
+ ares__llist_node_move_parent_first(node, buckets[idx]);
+ }
+
+ /* Abandoned bucket, destroy */
+ if (htable->buckets[i] != NULL) {
+ ares__llist_destroy(htable->buckets[i]);
+ htable->buckets[i] = NULL;
+ }
+ }
+
+ /* We have guaranteed all the buckets have either been moved or destroyed,
+ * so we just call ares_free() on the array and swap out the pointer */
+ ares_free(htable->buckets);
+ htable->buckets = buckets;
+ buckets = NULL;
+ rv = ARES_TRUE;
+
+done:
+ ares_free(buckets);
+ /* destroy any unused preallocated buckets */
+ ares__htable_buckets_destroy(prealloc_llist, (unsigned int)prealloc_llist_len,
+ ARES_FALSE);
+
+ /* On failure, we need to restore the htable size */
+ if (rv != ARES_TRUE) {
+ htable->size = old_size;
+ }
+
+ return rv;
+}
+
+ares_bool_t ares__htable_insert(ares__htable_t *htable, void *bucket)
+{
+ unsigned int idx = 0;
+ ares__llist_node_t *node = NULL;
+ const void *key = NULL;
+
+ if (htable == NULL || bucket == NULL) {
+ return ARES_FALSE;
+ }
+
+
+ key = htable->bucket_key(bucket);
+ idx = HASH_IDX(htable, key);
+
+ /* See if we have a matching bucket already, if so, replace it */
+ node = ares__htable_find(htable, idx, key);
+ if (node != NULL) {
+ ares__llist_node_replace(node, bucket);
+ return ARES_TRUE;
+ }
+
+ /* Check to see if we should rehash because likelihood of collisions has
+ * increased beyond our threshold */
+ if (htable->num_keys + 1 >
+ (htable->size * ARES__HTABLE_EXPAND_PERCENT) / 100) {
+ if (!ares__htable_expand(htable)) {
+ return ARES_FALSE;
+ }
+ /* If we expanded, need to calculate a new index */
+ idx = HASH_IDX(htable, key);
+ }
+
+ /* We lazily allocate the linked list */
+ if (htable->buckets[idx] == NULL) {
+ htable->buckets[idx] = ares__llist_create(htable->bucket_free);
+ if (htable->buckets[idx] == NULL) {
+ return ARES_FALSE;
+ }
+ }
+
+ node = ares__llist_insert_first(htable->buckets[idx], bucket);
+ if (node == NULL) {
+ return ARES_FALSE;
+ }
+
+ /* Track collisions for rehash stability */
+ if (ares__llist_len(htable->buckets[idx]) > 1) {
+ htable->num_collisions++;
+ }
+
+ htable->num_keys++;
+
+ return ARES_TRUE;
+}
+
+void *ares__htable_get(const ares__htable_t *htable, const void *key)
+{
+ unsigned int idx;
+
+ if (htable == NULL || key == NULL) {
+ return NULL;
+ }
+
+ idx = HASH_IDX(htable, key);
+
+ return ares__llist_node_val(ares__htable_find(htable, idx, key));
+}
+
+ares_bool_t ares__htable_remove(ares__htable_t *htable, const void *key)
+{
+ ares__llist_node_t *node;
+ unsigned int idx;
+
+ if (htable == NULL || key == NULL) {
+ return ARES_FALSE;
+ }
+
+ idx = HASH_IDX(htable, key);
+ node = ares__htable_find(htable, idx, key);
+ if (node == NULL) {
+ return ARES_FALSE;
+ }
+
+ htable->num_keys--;
+
+ /* Reduce collisions */
+ if (ares__llist_len(ares__llist_node_parent(node)) > 1) {
+ htable->num_collisions--;
+ }
+
+ ares__llist_node_destroy(node);
+ return ARES_TRUE;
+}
+
+size_t ares__htable_num_keys(const ares__htable_t *htable)
+{
+ if (htable == NULL) {
+ return 0;
+ }
+ return htable->num_keys;
+}
+
+unsigned int ares__htable_hash_FNV1a(const unsigned char *key, size_t key_len,
+ unsigned int seed)
+{
+ /* recommended seed is 2166136261U, but we don't want collisions */
+ unsigned int hv = seed;
+ size_t i;
+
+ for (i = 0; i < key_len; i++) {
+ hv ^= (unsigned int)key[i];
+ /* hv *= 0x01000193 */
+ hv += (hv << 1) + (hv << 4) + (hv << 7) + (hv << 8) + (hv << 24);
+ }
+
+ return hv;
+}
+
+/* Case insensitive version, meant for ASCII strings */
+unsigned int ares__htable_hash_FNV1a_casecmp(const unsigned char *key,
+ size_t key_len, unsigned int seed)
+{
+ /* recommended seed is 2166136261U, but we don't want collisions */
+ unsigned int hv = seed;
+ size_t i;
+
+ for (i = 0; i < key_len; i++) {
+ hv ^= (unsigned int)ares__tolower(key[i]);
+ /* hv *= 0x01000193 */
+ hv += (hv << 1) + (hv << 4) + (hv << 7) + (hv << 8) + (hv << 24);
+ }
+
+ return hv;
+}
diff --git a/subprojects/c-ares/src/lib/ares__htable.h b/subprojects/c-ares/src/lib/ares__htable.h
@@ -0,0 +1,163 @@
+/* MIT License
+ *
+ * Copyright (c) 2023 Brad House
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice (including the next
+ * paragraph) shall be included in all copies or substantial portions of the
+ * Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ *
+ * SPDX-License-Identifier: MIT
+ */
+#ifndef __ARES__HTABLE_H
+#define __ARES__HTABLE_H
+
+
+/*! \addtogroup ares__htable Base HashTable Data Structure
+ *
+ * This is a basic hashtable data structure that is meant to be wrapped
+ * by a higher level implementation. This data structure is designed to
+ * be callback-based in order to facilitate wrapping without needing to
+ * worry about any underlying complexities of the hashtable implementation.
+ *
+ * This implementation supports automatic growing by powers of 2 when reaching
+ * 75% capacity. A rehash will be performed on the expanded bucket list.
+ *
+ * Average time complexity:
+ * - Insert: O(1)
+ * - Search: O(1)
+ * - Delete: O(1)
+ *
+ * @{
+ */
+
+struct ares__htable;
+
+/*! Opaque data type for generic hash table implementation */
+typedef struct ares__htable ares__htable_t;
+
+/*! Callback for generating a hash of the key.
+ *
+ * \param[in] key pointer to key to be hashed
+ * \param[in] seed randomly generated seed used by hash function.
+ * value is specific to the hashtable instance
+ * but otherwise will not change between calls.
+ * \return hash
+ */
+typedef unsigned int (*ares__htable_hashfunc_t)(const void *key,
+ unsigned int seed);
+
+/*! Callback to free the bucket
+ *
+ * \param[in] bucket user provided bucket
+ */
+typedef void (*ares__htable_bucket_free_t)(void *bucket);
+
+/*! Callback to extract the key from the user-provided bucket
+ *
+ * \param[in] bucket user provided bucket
+ * \return pointer to key held in bucket
+ */
+typedef const void *(*ares__htable_bucket_key_t)(const void *bucket);
+
+/*! Callback to compare two keys for equality
+ *
+ * \param[in] key1 first key
+ * \param[in] key2 second key
+ * \return ARES_TRUE if equal, ARES_FALSE if not
+ */
+typedef ares_bool_t (*ares__htable_key_eq_t)(const void *key1,
+ const void *key2);
+
+
+/*! Destroy the initialized hashtable
+ *
+ * \param[in] initialized hashtable
+ */
+void ares__htable_destroy(ares__htable_t *htable);
+
+/*! Create a new hashtable
+ *
+ * \param[in] hash_func Required. Callback for Hash function.
+ * \param[in] bucket_key Required. Callback to extract key from bucket.
+ * \param[in] bucket_free Required. Callback to free bucket.
+ * \param[in] key_eq Required. Callback to check for key equality.
+ * \return initialized hashtable. NULL if out of memory or misuse.
+ */
+ares__htable_t *ares__htable_create(ares__htable_hashfunc_t hash_func,
+ ares__htable_bucket_key_t bucket_key,
+ ares__htable_bucket_free_t bucket_free,
+ ares__htable_key_eq_t key_eq);
+
+/*! Count of keys from initialized hashtable
+ *
+ * \param[in] htable Initialized hashtable.
+ * \return count of keys
+ */
+size_t ares__htable_num_keys(const ares__htable_t *htable);
+
+/*! Insert bucket into hashtable
+ *
+ * \param[in] htable Initialized hashtable.
+ * \param[in] bucket User-provided bucket to insert. Takes "ownership". Not
+ * allowed to be NULL.
+ * \return ARES_TRUE on success, ARES_FALSE if out of memory
+ */
+ares_bool_t ares__htable_insert(ares__htable_t *htable, void *bucket);
+
+/*! Retrieve bucket from hashtable based on key.
+ *
+ * \param[in] htable Initialized hashtable
+ * \param[in] key Pointer to key to use for comparison.
+ * \return matching bucket, or NULL if not found.
+ */
+void *ares__htable_get(const ares__htable_t *htable, const void *key);
+
+/*! Remove bucket from hashtable by key
+ *
+ * \param[in] htable Initialized hashtable
+ * \param[in] key Pointer to key to use for comparison
+ * \return ARES_TRUE if found, ARES_FALSE if not found
+ */
+ares_bool_t ares__htable_remove(ares__htable_t *htable, const void *key);
+
+/*! FNV1a hash algorithm. Can be used as underlying primitive for building
+ * a wrapper hashtable.
+ *
+ * \param[in] key pointer to key
+ * \param[in] key_len Length of key
+ * \param[in] seed Seed for generating hash
+ * \return hash value
+ */
+unsigned int ares__htable_hash_FNV1a(const unsigned char *key, size_t key_len,
+ unsigned int seed);
+
+/*! FNV1a hash algorithm, but converts all characters to lowercase before
+ * hashing to make the hash case-insensitive. Can be used as underlying
+ * primitive for building a wrapper hashtable. Used on string-based keys.
+ *
+ * \param[in] key pointer to key
+ * \param[in] key_len Length of key
+ * \param[in] seed Seed for generating hash
+ * \return hash value
+ */
+unsigned int ares__htable_hash_FNV1a_casecmp(const unsigned char *key,
+ size_t key_len, unsigned int seed);
+
+/*! @} */
+
+#endif /* __ARES__HTABLE_H */
diff --git a/subprojects/c-ares/src/lib/ares__htable_asvp.c b/subprojects/c-ares/src/lib/ares__htable_asvp.c
@@ -0,0 +1,194 @@
+/* MIT License
+ *
+ * Copyright (c) 2023 Brad House
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice (including the next
+ * paragraph) shall be included in all copies or substantial portions of the
+ * Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ *
+ * SPDX-License-Identifier: MIT
+ */
+#include "ares_setup.h"
+#include "ares.h"
+#include "ares_private.h"
+#include "ares__htable.h"
+#include "ares__htable_asvp.h"
+
+struct ares__htable_asvp {
+ ares__htable_asvp_val_free_t free_val;
+ ares__htable_t *hash;
+};
+
+typedef struct {
+ ares_socket_t key;
+ void *val;
+ ares__htable_asvp_t *parent;
+} ares__htable_asvp_bucket_t;
+
+void ares__htable_asvp_destroy(ares__htable_asvp_t *htable)
+{
+ if (htable == NULL) {
+ return;
+ }
+
+ ares__htable_destroy(htable->hash);
+ ares_free(htable);
+}
+
+static unsigned int hash_func(const void *key, unsigned int seed)
+{
+ const ares_socket_t *arg = key;
+ return ares__htable_hash_FNV1a((const unsigned char *)arg, sizeof(*arg),
+ seed);
+}
+
+static const void *bucket_key(const void *bucket)
+{
+ const ares__htable_asvp_bucket_t *arg = bucket;
+ return &arg->key;
+}
+
+static void bucket_free(void *bucket)
+{
+ ares__htable_asvp_bucket_t *arg = bucket;
+
+ if (arg->parent->free_val) {
+ arg->parent->free_val(arg->val);
+ }
+
+ ares_free(arg);
+}
+
+static ares_bool_t key_eq(const void *key1, const void *key2)
+{
+ const ares_socket_t *k1 = key1;
+ const ares_socket_t *k2 = key2;
+
+ if (*k1 == *k2) {
+ return ARES_TRUE;
+ }
+
+ return ARES_FALSE;
+}
+
+ares__htable_asvp_t *
+ ares__htable_asvp_create(ares__htable_asvp_val_free_t val_free)
+{
+ ares__htable_asvp_t *htable = ares_malloc(sizeof(*htable));
+ if (htable == NULL) {
+ goto fail;
+ }
+
+ htable->hash =
+ ares__htable_create(hash_func, bucket_key, bucket_free, key_eq);
+ if (htable->hash == NULL) {
+ goto fail;
+ }
+
+ htable->free_val = val_free;
+
+ return htable;
+
+fail:
+ if (htable) {
+ ares__htable_destroy(htable->hash);
+ ares_free(htable);
+ }
+ return NULL;
+}
+
+ares_bool_t ares__htable_asvp_insert(ares__htable_asvp_t *htable,
+ ares_socket_t key, void *val)
+{
+ ares__htable_asvp_bucket_t *bucket = NULL;
+
+ if (htable == NULL) {
+ goto fail;
+ }
+
+ bucket = ares_malloc(sizeof(*bucket));
+ if (bucket == NULL) {
+ goto fail;
+ }
+
+ bucket->parent = htable;
+ bucket->key = key;
+ bucket->val = val;
+
+ if (!ares__htable_insert(htable->hash, bucket)) {
+ goto fail;
+ }
+
+ return ARES_TRUE;
+
+fail:
+ if (bucket) {
+ ares_free(bucket);
+ }
+ return ARES_FALSE;
+}
+
+ares_bool_t ares__htable_asvp_get(const ares__htable_asvp_t *htable,
+ ares_socket_t key, void **val)
+{
+ ares__htable_asvp_bucket_t *bucket = NULL;
+
+ if (val) {
+ *val = NULL;
+ }
+
+ if (htable == NULL) {
+ return ARES_FALSE;
+ }
+
+ bucket = ares__htable_get(htable->hash, &key);
+ if (bucket == NULL) {
+ return ARES_FALSE;
+ }
+
+ if (val) {
+ *val = bucket->val;
+ }
+ return ARES_TRUE;
+}
+
+void *ares__htable_asvp_get_direct(const ares__htable_asvp_t *htable,
+ ares_socket_t key)
+{
+ void *val = NULL;
+ ares__htable_asvp_get(htable, key, &val);
+ return val;
+}
+
+ares_bool_t ares__htable_asvp_remove(ares__htable_asvp_t *htable,
+ ares_socket_t key)
+{
+ if (htable == NULL) {
+ return ARES_FALSE;
+ }
+
+ return ares__htable_remove(htable->hash, &key);
+}
+
+size_t ares__htable_asvp_num_keys(const ares__htable_asvp_t *htable)
+{
+ if (htable == NULL) {
+ return 0;
+ }
+ return ares__htable_num_keys(htable->hash);
+}
diff --git a/subprojects/c-ares/src/lib/ares__htable_asvp.h b/subprojects/c-ares/src/lib/ares__htable_asvp.h
@@ -0,0 +1,120 @@
+/* MIT License
+ *
+ * Copyright (c) 2023 Brad House
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice (including the next
+ * paragraph) shall be included in all copies or substantial portions of the
+ * Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ *
+ * SPDX-License-Identifier: MIT
+ */
+#ifndef __ARES__HTABLE_ASVP_H
+#define __ARES__HTABLE_ASVP_H
+
+/*! \addtogroup ares__htable_asvp HashTable with ares_socket_t Key and
+ * void pointer Value
+ *
+ * This data structure wraps the base ares__htable data structure in order to
+ * split the key and value data types as ares_socket_t and void pointer,
+ * respectively.
+ *
+ * Average time complexity:
+ * - Insert: O(1)
+ * - Search: O(1)
+ * - Delete: O(1)
+ *
+ * @{
+ */
+
+struct ares__htable_asvp;
+
+/*! Opaque data type for ares_socket_t key, void pointer hash table
+ * implementation */
+typedef struct ares__htable_asvp ares__htable_asvp_t;
+
+/*! Callback to free value stored in hashtable
+ *
+ * \param[in] val user-supplied value
+ */
+typedef void (*ares__htable_asvp_val_free_t)(void *val);
+
+/*! Destroy hashtable
+ *
+ * \param[in] htable Initialized hashtable
+ */
+void ares__htable_asvp_destroy(ares__htable_asvp_t *htable);
+
+/*! Create size_t key, void pointer value hash table
+ *
+ * \param[in] val_free Optional. Call back to free user-supplied value. If
+ * NULL it is expected the caller will clean up any user
+ * supplied values.
+ */
+ares__htable_asvp_t *
+ ares__htable_asvp_create(ares__htable_asvp_val_free_t val_free);
+
+/*! Insert key/value into hash table
+ *
+ * \param[in] htable Initialized hash table
+ * \param[in] key key to associate with value
+ * \param[in] val value to store (takes ownership). May be NULL.
+ * \return ARES_TRUE on success, ARES_FALSE on out of memory or misuse
+ */
+ares_bool_t ares__htable_asvp_insert(ares__htable_asvp_t *htable,
+ ares_socket_t key, void *val);
+
+/*! Retrieve value from hashtable based on key
+ *
+ * \param[in] htable Initialized hash table
+ * \param[in] key key to use to search
+ * \param[out] val Optional. Pointer to store value.
+ * \return ARES_TRUE on success, ARES_FALSE on failure
+ */
+ares_bool_t ares__htable_asvp_get(const ares__htable_asvp_t *htable,
+ ares_socket_t key, void **val);
+
+/*! Retrieve value from hashtable directly as return value. Caveat to this
+ * function over ares__htable_asvp_get() is that if a NULL value is stored
+ * you cannot determine if the key is not found or the value is NULL.
+ *
+ * \param[in] htable Initialized hash table
+ * \param[in] key key to use to search
+ * \return value associated with key in hashtable or NULL
+ */
+void *ares__htable_asvp_get_direct(const ares__htable_asvp_t *htable,
+ ares_socket_t key);
+
+/*! Remove a value from the hashtable by key
+ *
+ * \param[in] htable Initialized hash table
+ * \param[in] key key to use to search
+ * \return ARES_TRUE if found, ARES_FALSE if not found
+ */
+ares_bool_t ares__htable_asvp_remove(ares__htable_asvp_t *htable,
+ ares_socket_t key);
+
+/*! Retrieve the number of keys stored in the hash table
+ *
+ * \param[in] htable Initialized hash table
+ * \return count
+ */
+size_t ares__htable_asvp_num_keys(const ares__htable_asvp_t *htable);
+
+/*! @} */
+
+#endif /* __ARES__HTABLE_ASVP_H */
diff --git a/subprojects/c-ares/src/lib/ares__htable_strvp.c b/subprojects/c-ares/src/lib/ares__htable_strvp.c
@@ -0,0 +1,198 @@
+/* MIT License
+ *
+ * Copyright (c) 2023 Brad House
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice (including the next
+ * paragraph) shall be included in all copies or substantial portions of the
+ * Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ *
+ * SPDX-License-Identifier: MIT
+ */
+#include "ares_setup.h"
+#include "ares.h"
+#include "ares_private.h"
+#include "ares__htable.h"
+#include "ares__htable_strvp.h"
+
+struct ares__htable_strvp {
+ ares__htable_strvp_val_free_t free_val;
+ ares__htable_t *hash;
+};
+
+typedef struct {
+ char *key;
+ void *val;
+ ares__htable_strvp_t *parent;
+} ares__htable_strvp_bucket_t;
+
+void ares__htable_strvp_destroy(ares__htable_strvp_t *htable)
+{
+ if (htable == NULL) {
+ return;
+ }
+
+ ares__htable_destroy(htable->hash);
+ ares_free(htable);
+}
+
+static unsigned int hash_func(const void *key, unsigned int seed)
+{
+ const char *arg = key;
+ return ares__htable_hash_FNV1a_casecmp((const unsigned char *)arg,
+ ares_strlen(arg), seed);
+}
+
+static const void *bucket_key(const void *bucket)
+{
+ const ares__htable_strvp_bucket_t *arg = bucket;
+ return arg->key;
+}
+
+static void bucket_free(void *bucket)
+{
+ ares__htable_strvp_bucket_t *arg = bucket;
+
+ if (arg->parent->free_val) {
+ arg->parent->free_val(arg->val);
+ }
+ ares_free(arg->key);
+ ares_free(arg);
+}
+
+static ares_bool_t key_eq(const void *key1, const void *key2)
+{
+ const char *k1 = key1;
+ const char *k2 = key2;
+
+ if (strcasecmp(k1, k2) == 0) {
+ return ARES_TRUE;
+ }
+
+ return ARES_FALSE;
+}
+
+ares__htable_strvp_t *
+ ares__htable_strvp_create(ares__htable_strvp_val_free_t val_free)
+{
+ ares__htable_strvp_t *htable = ares_malloc(sizeof(*htable));
+ if (htable == NULL) {
+ goto fail;
+ }
+
+ htable->hash =
+ ares__htable_create(hash_func, bucket_key, bucket_free, key_eq);
+ if (htable->hash == NULL) {
+ goto fail;
+ }
+
+ htable->free_val = val_free;
+
+ return htable;
+
+fail:
+ if (htable) {
+ ares__htable_destroy(htable->hash);
+ ares_free(htable);
+ }
+ return NULL;
+}
+
+ares_bool_t ares__htable_strvp_insert(ares__htable_strvp_t *htable,
+ const char *key, void *val)
+{
+ ares__htable_strvp_bucket_t *bucket = NULL;
+
+ if (htable == NULL || key == NULL) {
+ goto fail;
+ }
+
+ bucket = ares_malloc(sizeof(*bucket));
+ if (bucket == NULL) {
+ goto fail;
+ }
+
+ bucket->parent = htable;
+ bucket->key = ares_strdup(key);
+ if (bucket->key == NULL) {
+ goto fail;
+ }
+ bucket->val = val;
+
+ if (!ares__htable_insert(htable->hash, bucket)) {
+ goto fail;
+ }
+
+ return ARES_TRUE;
+
+fail:
+ if (bucket) {
+ ares_free(bucket->key);
+ ares_free(bucket);
+ }
+ return ARES_FALSE;
+}
+
+ares_bool_t ares__htable_strvp_get(const ares__htable_strvp_t *htable,
+ const char *key, void **val)
+{
+ ares__htable_strvp_bucket_t *bucket = NULL;
+
+ if (val) {
+ *val = NULL;
+ }
+
+ if (htable == NULL || key == NULL) {
+ return ARES_FALSE;
+ }
+
+ bucket = ares__htable_get(htable->hash, key);
+ if (bucket == NULL) {
+ return ARES_FALSE;
+ }
+
+ if (val) {
+ *val = bucket->val;
+ }
+ return ARES_TRUE;
+}
+
+void *ares__htable_strvp_get_direct(const ares__htable_strvp_t *htable,
+ const char *key)
+{
+ void *val = NULL;
+ ares__htable_strvp_get(htable, key, &val);
+ return val;
+}
+
+ares_bool_t ares__htable_strvp_remove(ares__htable_strvp_t *htable,
+ const char *key)
+{
+ if (htable == NULL) {
+ return ARES_FALSE;
+ }
+
+ return ares__htable_remove(htable->hash, key);
+}
+
+size_t ares__htable_strvp_num_keys(const ares__htable_strvp_t *htable)
+{
+ if (htable == NULL) {
+ return 0;
+ }
+ return ares__htable_num_keys(htable->hash);
+}
diff --git a/subprojects/c-ares/src/lib/ares__htable_strvp.h b/subprojects/c-ares/src/lib/ares__htable_strvp.h
@@ -0,0 +1,118 @@
+/* MIT License
+ *
+ * Copyright (c) 2023 Brad House
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice (including the next
+ * paragraph) shall be included in all copies or substantial portions of the
+ * Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ *
+ * SPDX-License-Identifier: MIT
+ */
+#ifndef __ARES__HTABLE_STRVP_H
+#define __ARES__HTABLE_STRVP_H
+
+/*! \addtogroup ares__htable_strvp HashTable with string Key and void pointer
+ * Value
+ *
+ * This data structure wraps the base ares__htable data structure in order to
+ * split the key and value data types as string and void pointer, respectively.
+ *
+ * Average time complexity:
+ * - Insert: O(1)
+ * - Search: O(1)
+ * - Delete: O(1)
+ *
+ * @{
+ */
+
+struct ares__htable_strvp;
+
+/*! Opaque data type for size_t key, void pointer hash table implementation */
+typedef struct ares__htable_strvp ares__htable_strvp_t;
+
+/*! Callback to free value stored in hashtable
+ *
+ * \param[in] val user-supplied value
+ */
+typedef void (*ares__htable_strvp_val_free_t)(void *val);
+
+/*! Destroy hashtable
+ *
+ * \param[in] htable Initialized hashtable
+ */
+void ares__htable_strvp_destroy(ares__htable_strvp_t *htable);
+
+/*! Create string, void pointer value hash table
+ *
+ * \param[in] val_free Optional. Call back to free user-supplied value. If
+ * NULL it is expected the caller will clean up any user
+ * supplied values.
+ */
+ares__htable_strvp_t *
+ ares__htable_strvp_create(ares__htable_strvp_val_free_t val_free);
+
+/*! Insert key/value into hash table
+ *
+ * \param[in] htable Initialized hash table
+ * \param[in] key key to associate with value
+ * \param[in] val value to store (takes ownership). May be NULL.
+ * \return ARES_TRUE on success, ARES_FALSE on failure or out of memory
+ */
+ares_bool_t ares__htable_strvp_insert(ares__htable_strvp_t *htable,
+ const char *key, void *val);
+
+/*! Retrieve value from hashtable based on key
+ *
+ * \param[in] htable Initialized hash table
+ * \param[in] key key to use to search
+ * \param[out] val Optional. Pointer to store value.
+ * \return ARES_TRUE on success, ARES_FALSE on failure
+ */
+ares_bool_t ares__htable_strvp_get(const ares__htable_strvp_t *htable,
+ const char *key, void **val);
+
+/*! Retrieve value from hashtable directly as return value. Caveat to this
+ * function over ares__htable_strvp_get() is that if a NULL value is stored
+ * you cannot determine if the key is not found or the value is NULL.
+ *
+ * \param[in] htable Initialized hash table
+ * \param[in] key key to use to search
+ * \return value associated with key in hashtable or NULL
+ */
+void *ares__htable_strvp_get_direct(const ares__htable_strvp_t *htable,
+ const char *key);
+
+/*! Remove a value from the hashtable by key
+ *
+ * \param[in] htable Initialized hash table
+ * \param[in] key key to use to search
+ * \return ARES_TRUE if found, ARES_FALSE if not
+ */
+ares_bool_t ares__htable_strvp_remove(ares__htable_strvp_t *htable,
+ const char *key);
+
+/*! Retrieve the number of keys stored in the hash table
+ *
+ * \param[in] htable Initialized hash table
+ * \return count
+ */
+size_t ares__htable_strvp_num_keys(const ares__htable_strvp_t *htable);
+
+/*! @} */
+
+#endif /* __ARES__HTABLE_STVP_H */
diff --git a/subprojects/c-ares/src/lib/ares__htable_szvp.c b/subprojects/c-ares/src/lib/ares__htable_szvp.c
@@ -0,0 +1,193 @@
+/* MIT License
+ *
+ * Copyright (c) 2023 Brad House
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice (including the next
+ * paragraph) shall be included in all copies or substantial portions of the
+ * Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ *
+ * SPDX-License-Identifier: MIT
+ */
+#include "ares_setup.h"
+#include "ares.h"
+#include "ares_private.h"
+#include "ares__htable.h"
+#include "ares__htable_szvp.h"
+
+struct ares__htable_szvp {
+ ares__htable_szvp_val_free_t free_val;
+ ares__htable_t *hash;
+};
+
+typedef struct {
+ size_t key;
+ void *val;
+ ares__htable_szvp_t *parent;
+} ares__htable_szvp_bucket_t;
+
+void ares__htable_szvp_destroy(ares__htable_szvp_t *htable)
+{
+ if (htable == NULL) {
+ return;
+ }
+
+ ares__htable_destroy(htable->hash);
+ ares_free(htable);
+}
+
+static unsigned int hash_func(const void *key, unsigned int seed)
+{
+ const size_t *arg = key;
+ return ares__htable_hash_FNV1a((const unsigned char *)arg, sizeof(*arg),
+ seed);
+}
+
+static const void *bucket_key(const void *bucket)
+{
+ const ares__htable_szvp_bucket_t *arg = bucket;
+ return &arg->key;
+}
+
+static void bucket_free(void *bucket)
+{
+ ares__htable_szvp_bucket_t *arg = bucket;
+
+ if (arg->parent->free_val) {
+ arg->parent->free_val(arg->val);
+ }
+
+ ares_free(arg);
+}
+
+static ares_bool_t key_eq(const void *key1, const void *key2)
+{
+ const size_t *k1 = key1;
+ const size_t *k2 = key2;
+
+ if (*k1 == *k2) {
+ return ARES_TRUE;
+ }
+
+ return ARES_FALSE;
+}
+
+ares__htable_szvp_t *
+ ares__htable_szvp_create(ares__htable_szvp_val_free_t val_free)
+{
+ ares__htable_szvp_t *htable = ares_malloc(sizeof(*htable));
+ if (htable == NULL) {
+ goto fail;
+ }
+
+ htable->hash =
+ ares__htable_create(hash_func, bucket_key, bucket_free, key_eq);
+ if (htable->hash == NULL) {
+ goto fail;
+ }
+
+ htable->free_val = val_free;
+
+ return htable;
+
+fail:
+ if (htable) {
+ ares__htable_destroy(htable->hash);
+ ares_free(htable);
+ }
+ return NULL;
+}
+
+ares_bool_t ares__htable_szvp_insert(ares__htable_szvp_t *htable, size_t key,
+ void *val)
+{
+ ares__htable_szvp_bucket_t *bucket = NULL;
+
+ if (htable == NULL) {
+ goto fail;
+ }
+
+ bucket = ares_malloc(sizeof(*bucket));
+ if (bucket == NULL) {
+ goto fail;
+ }
+
+ bucket->parent = htable;
+ bucket->key = key;
+ bucket->val = val;
+
+ if (!ares__htable_insert(htable->hash, bucket)) {
+ goto fail;
+ }
+
+ return ARES_TRUE;
+
+fail:
+ if (bucket) {
+ ares_free(bucket);
+ }
+ return ARES_FALSE;
+}
+
+ares_bool_t ares__htable_szvp_get(const ares__htable_szvp_t *htable, size_t key,
+ void **val)
+{
+ ares__htable_szvp_bucket_t *bucket = NULL;
+
+ if (val) {
+ *val = NULL;
+ }
+
+ if (htable == NULL) {
+ return ARES_FALSE;
+ }
+
+ bucket = ares__htable_get(htable->hash, &key);
+ if (bucket == NULL) {
+ return ARES_FALSE;
+ }
+
+ if (val) {
+ *val = bucket->val;
+ }
+ return ARES_TRUE;
+}
+
+void *ares__htable_szvp_get_direct(const ares__htable_szvp_t *htable,
+ size_t key)
+{
+ void *val = NULL;
+ ares__htable_szvp_get(htable, key, &val);
+ return val;
+}
+
+ares_bool_t ares__htable_szvp_remove(ares__htable_szvp_t *htable, size_t key)
+{
+ if (htable == NULL) {
+ return ARES_FALSE;
+ }
+
+ return ares__htable_remove(htable->hash, &key);
+}
+
+size_t ares__htable_szvp_num_keys(const ares__htable_szvp_t *htable)
+{
+ if (htable == NULL) {
+ return 0;
+ }
+ return ares__htable_num_keys(htable->hash);
+}
diff --git a/subprojects/c-ares/src/lib/ares__htable_szvp.h b/subprojects/c-ares/src/lib/ares__htable_szvp.h
@@ -0,0 +1,117 @@
+/* MIT License
+ *
+ * Copyright (c) 2023 Brad House
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice (including the next
+ * paragraph) shall be included in all copies or substantial portions of the
+ * Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ *
+ * SPDX-License-Identifier: MIT
+ */
+#ifndef __ARES__HTABLE_STVP_H
+#define __ARES__HTABLE_STVP_H
+
+/*! \addtogroup ares__htable_szvp HashTable with size_t Key and void pointer
+ * Value
+ *
+ * This data structure wraps the base ares__htable data structure in order to
+ * split the key and value data types as size_t and void pointer, respectively.
+ *
+ * Average time complexity:
+ * - Insert: O(1)
+ * - Search: O(1)
+ * - Delete: O(1)
+ *
+ * @{
+ */
+
+struct ares__htable_szvp;
+
+/*! Opaque data type for size_t key, void pointer hash table implementation */
+typedef struct ares__htable_szvp ares__htable_szvp_t;
+
+/*! Callback to free value stored in hashtable
+ *
+ * \param[in] val user-supplied value
+ */
+typedef void (*ares__htable_szvp_val_free_t)(void *val);
+
+/*! Destroy hashtable
+ *
+ * \param[in] htable Initialized hashtable
+ */
+void ares__htable_szvp_destroy(ares__htable_szvp_t *htable);
+
+/*! Create size_t key, void pointer value hash table
+ *
+ * \param[in] val_free Optional. Call back to free user-supplied value. If
+ * NULL it is expected the caller will clean up any user
+ * supplied values.
+ */
+ares__htable_szvp_t *
+ ares__htable_szvp_create(ares__htable_szvp_val_free_t val_free);
+
+/*! Insert key/value into hash table
+ *
+ * \param[in] htable Initialized hash table
+ * \param[in] key key to associate with value
+ * \param[in] val value to store (takes ownership). May be NULL.
+ * \return ARES_TRUE on success, ARES_FALSE on failure or out of memory
+ */
+ares_bool_t ares__htable_szvp_insert(ares__htable_szvp_t *htable, size_t key,
+ void *val);
+
+/*! Retrieve value from hashtable based on key
+ *
+ * \param[in] htable Initialized hash table
+ * \param[in] key key to use to search
+ * \param[out] val Optional. Pointer to store value.
+ * \return ARES_TRUE on success, ARES_FALSE on failure
+ */
+ares_bool_t ares__htable_szvp_get(const ares__htable_szvp_t *htable, size_t key,
+ void **val);
+
+/*! Retrieve value from hashtable directly as return value. Caveat to this
+ * function over ares__htable_szvp_get() is that if a NULL value is stored
+ * you cannot determine if the key is not found or the value is NULL.
+ *
+ * \param[in] htable Initialized hash table
+ * \param[in] key key to use to search
+ * \return value associated with key in hashtable or NULL
+ */
+void *ares__htable_szvp_get_direct(const ares__htable_szvp_t *htable,
+ size_t key);
+
+/*! Remove a value from the hashtable by key
+ *
+ * \param[in] htable Initialized hash table
+ * \param[in] key key to use to search
+ * \return ARES_TRUE if found, ARES_FALSE if not
+ */
+ares_bool_t ares__htable_szvp_remove(ares__htable_szvp_t *htable, size_t key);
+
+/*! Retrieve the number of keys stored in the hash table
+ *
+ * \param[in] htable Initialized hash table
+ * \return count
+ */
+size_t ares__htable_szvp_num_keys(const ares__htable_szvp_t *htable);
+
+/*! @} */
+
+#endif /* __ARES__HTABLE_STVP_H */
diff --git a/subprojects/c-ares/src/lib/ares__iface_ips.c b/subprojects/c-ares/src/lib/ares__iface_ips.c
@@ -0,0 +1,592 @@
+/* MIT License
+ *
+ * Copyright (c) 2023 Brad House
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice (including the next
+ * paragraph) shall be included in all copies or substantial portions of the
+ * Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ *
+ * SPDX-License-Identifier: MIT
+ */
+#include "ares_setup.h"
+
+
+#ifdef USE_WINSOCK
+# include <winsock2.h>
+# include <ws2tcpip.h>
+# if defined(HAVE_IPHLPAPI_H)
+# include <iphlpapi.h>
+# endif
+# if defined(HAVE_NETIOAPI_H)
+# include <netioapi.h>
+# endif
+#endif
+
+#ifdef HAVE_SYS_TYPES_H
+# include <sys/types.h>
+#endif
+#ifdef HAVE_SYS_SOCKET_H
+# include <sys/socket.h>
+#endif
+#ifdef HAVE_NET_IF_H
+# include <net/if.h>
+#endif
+#ifdef HAVE_IFADDRS_H
+# include <ifaddrs.h>
+#endif
+#ifdef HAVE_SYS_IOCTL_H
+# include <sys/ioctl.h>
+#endif
+#ifdef HAVE_NETINET_IN_H
+# include <netinet/in.h>
+#endif
+
+#include "ares.h"
+#include "ares_private.h"
+
+static ares_status_t ares__iface_ips_enumerate(ares__iface_ips_t *ips,
+ const char *name);
+
+typedef struct {
+ char *name;
+ struct ares_addr addr;
+ unsigned char netmask;
+ unsigned int ll_scope;
+ ares__iface_ip_flags_t flags;
+} ares__iface_ip_t;
+
+struct ares__iface_ips {
+ ares__iface_ip_t *ips;
+ size_t cnt;
+ size_t alloc_size;
+ ares__iface_ip_flags_t enum_flags;
+};
+
+static ares__iface_ips_t *ares__iface_ips_alloc(ares__iface_ip_flags_t flags)
+{
+ ares__iface_ips_t *ips = ares_malloc_zero(sizeof(*ips));
+ if (ips == NULL) {
+ return NULL;
+ }
+
+ /* Prealloc 4 entries */
+ ips->alloc_size = 4;
+ ips->ips = ares_malloc_zero(ips->alloc_size * sizeof(*ips->ips));
+ if (ips->ips == NULL) {
+ ares_free(ips);
+ return NULL;
+ }
+ ips->enum_flags = flags;
+ return ips;
+}
+
+static void ares__iface_ip_destroy(ares__iface_ip_t *ip)
+{
+ if (ip == NULL) {
+ return;
+ }
+ ares_free(ip->name);
+ memset(ip, 0, sizeof(*ip));
+}
+
+void ares__iface_ips_destroy(ares__iface_ips_t *ips)
+{
+ size_t i;
+
+ if (ips == NULL) {
+ return;
+ }
+
+ for (i = 0; i < ips->cnt; i++) {
+ ares__iface_ip_destroy(&ips->ips[i]);
+ }
+ ares_free(ips->ips);
+ ares_free(ips);
+}
+
+ares_status_t ares__iface_ips(ares__iface_ips_t **ips,
+ ares__iface_ip_flags_t flags, const char *name)
+{
+ ares_status_t status;
+
+ if (ips == NULL) {
+ return ARES_EFORMERR;
+ }
+
+ *ips = ares__iface_ips_alloc(flags);
+ if (*ips == NULL) {
+ return ARES_ENOMEM;
+ }
+
+ status = ares__iface_ips_enumerate(*ips, name);
+ if (status != ARES_SUCCESS) {
+ ares__iface_ips_destroy(*ips);
+ *ips = NULL;
+ return status;
+ }
+
+ return ARES_SUCCESS;
+}
+
+static ares_status_t
+ ares__iface_ips_add(ares__iface_ips_t *ips, ares__iface_ip_flags_t flags,
+ const char *name, const struct ares_addr *addr,
+ unsigned char netmask, unsigned int ll_scope)
+{
+ size_t idx;
+
+ if (ips == NULL || name == NULL || addr == NULL) {
+ return ARES_EFORMERR;
+ }
+
+ /* Don't want loopback */
+ if (flags & ARES_IFACE_IP_LOOPBACK &&
+ !(ips->enum_flags & ARES_IFACE_IP_LOOPBACK)) {
+ return ARES_SUCCESS;
+ }
+
+ /* Don't want offline */
+ if (flags & ARES_IFACE_IP_OFFLINE &&
+ !(ips->enum_flags & ARES_IFACE_IP_OFFLINE)) {
+ return ARES_SUCCESS;
+ }
+
+ /* Check for link-local */
+ if (ares__addr_is_linklocal(addr)) {
+ flags |= ARES_IFACE_IP_LINKLOCAL;
+ }
+ if (flags & ARES_IFACE_IP_LINKLOCAL &&
+ !(ips->enum_flags & ARES_IFACE_IP_LINKLOCAL)) {
+ return ARES_SUCCESS;
+ }
+
+ /* Set address flag based on address provided */
+ if (addr->family == AF_INET) {
+ flags |= ARES_IFACE_IP_V4;
+ }
+
+ if (addr->family == AF_INET6) {
+ flags |= ARES_IFACE_IP_V6;
+ }
+
+ /* If they specified either v4 or v6 validate flags otherwise assume they
+ * want to enumerate both */
+ if (ips->enum_flags & (ARES_IFACE_IP_V4 | ARES_IFACE_IP_V6)) {
+ if (flags & ARES_IFACE_IP_V4 && !(ips->enum_flags & ARES_IFACE_IP_V4)) {
+ return ARES_SUCCESS;
+ }
+ if (flags & ARES_IFACE_IP_V6 && !(ips->enum_flags & ARES_IFACE_IP_V6)) {
+ return ARES_SUCCESS;
+ }
+ }
+
+ /* Allocate more ips */
+ if (ips->cnt + 1 > ips->alloc_size) {
+ void *temp;
+ size_t alloc_size;
+
+ alloc_size = ares__round_up_pow2(ips->alloc_size + 1);
+ temp = ares_realloc_zero(ips->ips, ips->alloc_size * sizeof(*ips->ips),
+ alloc_size * sizeof(*ips->ips));
+ if (temp == NULL) {
+ return ARES_ENOMEM;
+ }
+ ips->ips = temp;
+ ips->alloc_size = alloc_size;
+ }
+
+ /* Add */
+ idx = ips->cnt++;
+
+ ips->ips[idx].flags = flags;
+ ips->ips[idx].netmask = netmask;
+ ips->ips[idx].ll_scope = ll_scope;
+ memcpy(&ips->ips[idx].addr, addr, sizeof(*addr));
+ ips->ips[idx].name = ares_strdup(name);
+ if (ips->ips[idx].name == NULL) {
+ return ARES_ENOMEM;
+ }
+
+ return ARES_SUCCESS;
+}
+
+size_t ares__iface_ips_cnt(const ares__iface_ips_t *ips)
+{
+ if (ips == NULL) {
+ return 0;
+ }
+ return ips->cnt;
+}
+
+const char *ares__iface_ips_get_name(const ares__iface_ips_t *ips, size_t idx)
+{
+ if (ips == NULL || idx >= ips->cnt) {
+ return NULL;
+ }
+ return ips->ips[idx].name;
+}
+
+const struct ares_addr *ares__iface_ips_get_addr(const ares__iface_ips_t *ips,
+ size_t idx)
+{
+ if (ips == NULL || idx >= ips->cnt) {
+ return NULL;
+ }
+ return &ips->ips[idx].addr;
+}
+
+ares__iface_ip_flags_t ares__iface_ips_get_flags(const ares__iface_ips_t *ips,
+ size_t idx)
+{
+ if (ips == NULL || idx >= ips->cnt) {
+ return 0;
+ }
+ return ips->ips[idx].flags;
+}
+
+unsigned char ares__iface_ips_get_netmask(const ares__iface_ips_t *ips,
+ size_t idx)
+{
+ if (ips == NULL || idx >= ips->cnt) {
+ return 0;
+ }
+ return ips->ips[idx].netmask;
+}
+
+unsigned int ares__iface_ips_get_ll_scope(const ares__iface_ips_t *ips,
+ size_t idx)
+{
+ if (ips == NULL || idx >= ips->cnt) {
+ return 0;
+ }
+ return ips->ips[idx].ll_scope;
+}
+
+
+#ifdef USE_WINSOCK
+
+# if 0
+static char *wcharp_to_charp(const wchar_t *in)
+{
+ char *out;
+ int len;
+
+ len = WideCharToMultiByte(CP_UTF8, 0, in, -1, NULL, 0, NULL, NULL);
+ if (len == -1) {
+ return NULL;
+ }
+
+ out = ares_malloc_zero((size_t)len + 1);
+
+ if (WideCharToMultiByte(CP_UTF8, 0, in, -1, out, len, NULL, NULL) == -1) {
+ ares_free(out);
+ return NULL;
+ }
+
+ return out;
+}
+# endif
+
+static ares_bool_t name_match(const char *name, const char *adapter_name,
+ unsigned int ll_scope)
+{
+ if (name == NULL || *name == 0) {
+ return ARES_TRUE;
+ }
+
+ if (strcasecmp(name, adapter_name) == 0) {
+ return ARES_TRUE;
+ }
+
+ if (ares_str_isnum(name) && (unsigned int)atoi(name) == ll_scope) {
+ return ARES_TRUE;
+ }
+
+ return ARES_FALSE;
+}
+
+static ares_status_t ares__iface_ips_enumerate(ares__iface_ips_t *ips,
+ const char *name)
+{
+ ULONG myflags = GAA_FLAG_INCLUDE_PREFIX /*|GAA_FLAG_INCLUDE_ALL_INTERFACES */;
+ ULONG outBufLen = 0;
+ DWORD retval;
+ IP_ADAPTER_ADDRESSES *addresses = NULL;
+ IP_ADAPTER_ADDRESSES *address = NULL;
+ ares_status_t status = ARES_SUCCESS;
+
+ /* Get necessary buffer size */
+ GetAdaptersAddresses(AF_UNSPEC, myflags, NULL, NULL, &outBufLen);
+ if (outBufLen == 0) {
+ status = ARES_EFILE;
+ goto done;
+ }
+
+ addresses = ares_malloc_zero(outBufLen);
+ if (addresses == NULL) {
+ status = ARES_ENOMEM;
+ goto done;
+ }
+
+ retval =
+ GetAdaptersAddresses(AF_UNSPEC, myflags, NULL, addresses, &outBufLen);
+ if (retval != ERROR_SUCCESS) {
+ status = ARES_EFILE;
+ goto done;
+ }
+
+ for (address = addresses; address != NULL; address = address->Next) {
+ IP_ADAPTER_UNICAST_ADDRESS *ipaddr = NULL;
+ ares__iface_ip_flags_t addrflag = 0;
+ char ifname[64] = "";
+
+# if defined(HAVE_CONVERTINTERFACEINDEXTOLUID) && \
+ defined(HAVE_CONVERTINTERFACELUIDTONAMEA)
+ /* Retrieve name from interface index.
+ * address->AdapterName appears to be a GUID/UUID of some sort, not a name.
+ * address->FriendlyName is user-changeable.
+ * That said, this doesn't appear to help us out on systems that don't
+ * have if_nametoindex() or if_indextoname() as they don't have these
+ * functions either! */
+ NET_LUID luid;
+ ConvertInterfaceIndexToLuid(address->IfIndex, &luid);
+ ConvertInterfaceLuidToNameA(&luid, ifname, sizeof(ifname));
+# else
+ ares_strcpy(ifname, address->AdapterName, sizeof(ifname));
+# endif
+
+ if (address->OperStatus != IfOperStatusUp) {
+ addrflag |= ARES_IFACE_IP_OFFLINE;
+ }
+
+ if (address->IfType == IF_TYPE_SOFTWARE_LOOPBACK) {
+ addrflag |= ARES_IFACE_IP_LOOPBACK;
+ }
+
+ for (ipaddr = address->FirstUnicastAddress; ipaddr != NULL;
+ ipaddr = ipaddr->Next) {
+ struct ares_addr addr;
+
+ if (ipaddr->Address.lpSockaddr->sa_family == AF_INET) {
+ const struct sockaddr_in *sockaddr_in =
+ (const struct sockaddr_in *)((void *)ipaddr->Address.lpSockaddr);
+ addr.family = AF_INET;
+ memcpy(&addr.addr.addr4, &sockaddr_in->sin_addr,
+ sizeof(addr.addr.addr4));
+ } else if (ipaddr->Address.lpSockaddr->sa_family == AF_INET6) {
+ const struct sockaddr_in6 *sockaddr_in6 =
+ (const struct sockaddr_in6 *)((void *)ipaddr->Address.lpSockaddr);
+ addr.family = AF_INET6;
+ memcpy(&addr.addr.addr6, &sockaddr_in6->sin6_addr,
+ sizeof(addr.addr.addr6));
+ } else {
+ /* Unknown */
+ continue;
+ }
+
+ /* Sometimes windows may use numerics to indicate a DNS server's adapter,
+ * which corresponds to the index rather than the name. Check and
+ * validate both. */
+ if (!name_match(name, ifname, address->Ipv6IfIndex)) {
+ continue;
+ }
+
+ status = ares__iface_ips_add(ips, addrflag, ifname, &addr,
+ ipaddr->OnLinkPrefixLength /* netmask */,
+ address->Ipv6IfIndex /* ll_scope */);
+
+ if (status != ARES_SUCCESS) {
+ goto done;
+ }
+ }
+ }
+
+done:
+ ares_free(addresses);
+ return status;
+}
+
+#elif defined(HAVE_GETIFADDRS)
+
+static unsigned char count_addr_bits(const unsigned char *addr, size_t addr_len)
+{
+ size_t i;
+ unsigned char count = 0;
+
+ for (i = 0; i < addr_len; i++) {
+ count += ares__count_bits_u8(addr[i]);
+ }
+ return count;
+}
+
+static ares_status_t ares__iface_ips_enumerate(ares__iface_ips_t *ips,
+ const char *name)
+{
+ struct ifaddrs *ifap = NULL;
+ struct ifaddrs *ifa = NULL;
+ ares_status_t status = ARES_SUCCESS;
+
+ if (getifaddrs(&ifap) != 0) {
+ status = ARES_EFILE;
+ goto done;
+ }
+
+ for (ifa = ifap; ifa != NULL; ifa = ifa->ifa_next) {
+ ares__iface_ip_flags_t addrflag = 0;
+ struct ares_addr addr;
+ unsigned char netmask = 0;
+ unsigned int ll_scope = 0;
+
+ if (ifa->ifa_addr == NULL) {
+ continue;
+ }
+
+ if (!(ifa->ifa_flags & IFF_UP)) {
+ addrflag |= ARES_IFACE_IP_OFFLINE;
+ }
+
+ if (ifa->ifa_flags & IFF_LOOPBACK) {
+ addrflag |= ARES_IFACE_IP_LOOPBACK;
+ }
+
+ if (ifa->ifa_addr->sa_family == AF_INET) {
+ const struct sockaddr_in *sockaddr_in =
+ (const struct sockaddr_in *)((void *)ifa->ifa_addr);
+ addr.family = AF_INET;
+ memcpy(&addr.addr.addr4, &sockaddr_in->sin_addr, sizeof(addr.addr.addr4));
+ /* netmask */
+ sockaddr_in = (struct sockaddr_in *)((void *)ifa->ifa_netmask);
+ netmask = count_addr_bits((const void *)&sockaddr_in->sin_addr, 4);
+ } else if (ifa->ifa_addr->sa_family == AF_INET6) {
+ const struct sockaddr_in6 *sockaddr_in6 =
+ (const struct sockaddr_in6 *)((void *)ifa->ifa_addr);
+ addr.family = AF_INET6;
+ memcpy(&addr.addr.addr6, &sockaddr_in6->sin6_addr,
+ sizeof(addr.addr.addr6));
+ /* netmask */
+ sockaddr_in6 = (struct sockaddr_in6 *)((void *)ifa->ifa_netmask);
+ netmask = count_addr_bits((const void *)&sockaddr_in6->sin6_addr, 16);
+# ifdef HAVE_STRUCT_SOCKADDR_IN6_SIN6_SCOPE_ID
+ ll_scope = sockaddr_in6->sin6_scope_id;
+# endif
+ } else {
+ /* unknown */
+ continue;
+ }
+
+ /* Name mismatch */
+ if (strcasecmp(ifa->ifa_name, name) != 0) {
+ continue;
+ }
+
+ status = ares__iface_ips_add(ips, addrflag, ifa->ifa_name, &addr, netmask,
+ ll_scope);
+ if (status != ARES_SUCCESS) {
+ goto done;
+ }
+ }
+
+done:
+ freeifaddrs(ifap);
+ return status;
+}
+
+#else
+
+static ares_status_t ares__iface_ips_enumerate(ares__iface_ips_t *ips,
+ const char *name)
+{
+ (void)ips;
+ (void)name;
+ return ARES_ENOTIMP;
+}
+
+#endif
+
+
+unsigned int ares__if_nametoindex(const char *name)
+{
+#ifdef HAVE_IF_NAMETOINDEX
+ return if_nametoindex(name);
+#else
+ ares_status_t status;
+ ares__iface_ips_t *ips = NULL;
+ size_t i;
+ unsigned int index = 0;
+
+ status =
+ ares__iface_ips(&ips, ARES_IFACE_IP_V6 | ARES_IFACE_IP_LINKLOCAL, name);
+ if (status != ARES_SUCCESS) {
+ goto done;
+ }
+
+ for (i = 0; i < ares__iface_ips_cnt(ips); i++) {
+ if (ares__iface_ips_get_flags(ips, i) & ARES_IFACE_IP_LINKLOCAL) {
+ index = ares__iface_ips_get_ll_scope(ips, i);
+ goto done;
+ }
+ }
+
+done:
+ ares__iface_ips_destroy(ips);
+ return index;
+#endif
+}
+
+const char *ares__if_indextoname(unsigned int index, char *name,
+ size_t name_len)
+{
+#ifdef HAVE_IF_INDEXTONAME
+ if (name_len < IF_NAMESIZE) {
+ return NULL;
+ }
+ return if_indextoname(index, name);
+#else
+ ares_status_t status;
+ ares__iface_ips_t *ips = NULL;
+ size_t i;
+ const char *ptr = NULL;
+
+ if (name_len < IF_NAMESIZE) {
+ goto done;
+ }
+
+ if (index == 0) {
+ goto done;
+ }
+
+ status =
+ ares__iface_ips(&ips, ARES_IFACE_IP_V6 | ARES_IFACE_IP_LINKLOCAL, NULL);
+ if (status != ARES_SUCCESS) {
+ goto done;
+ }
+
+ for (i = 0; i < ares__iface_ips_cnt(ips); i++) {
+ if (ares__iface_ips_get_flags(ips, i) & ARES_IFACE_IP_LINKLOCAL &&
+ ares__iface_ips_get_ll_scope(ips, i) == index) {
+ ares_strcpy(name, ares__iface_ips_get_name(ips, i), name_len);
+ ptr = name;
+ goto done;
+ }
+ }
+
+done:
+ ares__iface_ips_destroy(ips);
+ return ptr;
+#endif
+}
diff --git a/subprojects/c-ares/src/lib/ares__iface_ips.h b/subprojects/c-ares/src/lib/ares__iface_ips.h
@@ -0,0 +1,139 @@
+/* MIT License
+ *
+ * Copyright (c) 2023 Brad House
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice (including the next
+ * paragraph) shall be included in all copies or substantial portions of the
+ * Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ *
+ * SPDX-License-Identifier: MIT
+ */
+#ifndef __ARES__IFACE_IPS_H
+#define __ARES__IFACE_IPS_H
+
+/*! Flags for interface ip addresses. */
+typedef enum {
+ ARES_IFACE_IP_V4 = 1 << 0, /*!< IPv4 address. During enumeration if
+ * this flag is set ARES_IFACE_IP_V6
+ * is not, will only enumerate v4
+ * addresses. */
+ ARES_IFACE_IP_V6 = 1 << 1, /*!< IPv6 address. During enumeration if
+ * this flag is set ARES_IFACE_IP_V4
+ * is not, will only enumerate v6
+ * addresses. */
+ ARES_IFACE_IP_LOOPBACK = 1 << 2, /*!< Loopback adapter */
+ ARES_IFACE_IP_OFFLINE = 1 << 3, /*!< Adapter offline */
+ ARES_IFACE_IP_LINKLOCAL = 1 << 4, /*!< Link-local ip address */
+ /*! Default, enumerate all ips for online interfaces, including loopback */
+ ARES_IFACE_IP_DEFAULT = (ARES_IFACE_IP_V4 | ARES_IFACE_IP_V6 |
+ ARES_IFACE_IP_LOOPBACK | ARES_IFACE_IP_LINKLOCAL)
+} ares__iface_ip_flags_t;
+
+struct ares__iface_ips;
+
+/*! Opaque pointer for holding enumerated interface ip addresses */
+typedef struct ares__iface_ips ares__iface_ips_t;
+
+/*! Destroy ip address enumeration created by ares__iface_ips().
+ *
+ * \param[in] ips Initialized IP address enumeration structure
+ */
+void ares__iface_ips_destroy(ares__iface_ips_t *ips);
+
+/*! Enumerate ip addresses on interfaces
+ *
+ * \param[out] ips Returns initialized ip address structure
+ * \param[in] flags Flags for enumeration
+ * \param[in] name Interface name to enumerate, or NULL to enumerate all
+ * \return ARES_ENOMEM on out of memory, ARES_ENOTIMP if not supported on
+ * the system, ARES_SUCCESS on success
+ */
+ares_status_t ares__iface_ips(ares__iface_ips_t **ips,
+ ares__iface_ip_flags_t flags, const char *name);
+
+/*! Count of ips enumerated
+ *
+ * \param[in] ips Initialized IP address enumeration structure
+ * \return count
+ */
+size_t ares__iface_ips_cnt(const ares__iface_ips_t *ips);
+
+/*! Retrieve interface name
+ *
+ * \param[in] ips Initialized IP address enumeration structure
+ * \param[in] idx Index of entry to pull
+ * \return interface name
+ */
+const char *ares__iface_ips_get_name(const ares__iface_ips_t *ips, size_t idx);
+
+/*! Retrieve interface address
+ *
+ * \param[in] ips Initialized IP address enumeration structure
+ * \param[in] idx Index of entry to pull
+ * \return interface address
+ */
+const struct ares_addr *ares__iface_ips_get_addr(const ares__iface_ips_t *ips,
+ size_t idx);
+
+/*! Retrieve interface address flags
+ *
+ * \param[in] ips Initialized IP address enumeration structure
+ * \param[in] idx Index of entry to pull
+ * \return interface address flags
+ */
+ares__iface_ip_flags_t ares__iface_ips_get_flags(const ares__iface_ips_t *ips,
+ size_t idx);
+
+/*! Retrieve interface address netmask
+ *
+ * \param[in] ips Initialized IP address enumeration structure
+ * \param[in] idx Index of entry to pull
+ * \return interface address netmask
+ */
+unsigned char ares__iface_ips_get_netmask(const ares__iface_ips_t *ips,
+ size_t idx);
+
+/*! Retrieve interface ipv6 link local scope
+ *
+ * \param[in] ips Initialized IP address enumeration structure
+ * \param[in] idx Index of entry to pull
+ * \return interface ipv6 link local scope
+ */
+unsigned int ares__iface_ips_get_ll_scope(const ares__iface_ips_t *ips,
+ size_t idx);
+
+
+/*! Retrieve the interface index (aka link local scope) from the interface
+ * name.
+ *
+ * \param[in] name Interface name
+ * \return 0 on failure, index otherwise
+ */
+unsigned int ares__if_nametoindex(const char *name);
+
+/*! Retrieves the interface name from the index (aka link local scope)
+ *
+ * \param[in] index Interface index (> 0)
+ * \param[in] name Buffer to hold name
+ * \param[in] name_len Length of provided buffer, must be at least IF_NAMESIZE
+ * \return NULL on failure, or pointer to name on success
+ */
+const char *ares__if_indextoname(unsigned int index, char *name,
+ size_t name_len);
+
+#endif
diff --git a/subprojects/c-ares/src/lib/ares__llist.c b/subprojects/c-ares/src/lib/ares__llist.c
@@ -0,0 +1,360 @@
+/* MIT License
+ *
+ * Copyright (c) 2023 Brad House
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice (including the next
+ * paragraph) shall be included in all copies or substantial portions of the
+ * Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ *
+ * SPDX-License-Identifier: MIT
+ */
+#include "ares_setup.h"
+#include "ares.h"
+#include "ares_private.h"
+#include "ares__llist.h"
+
+struct ares__llist {
+ ares__llist_node_t *head;
+ ares__llist_node_t *tail;
+ ares__llist_destructor_t destruct;
+ size_t cnt;
+};
+
+struct ares__llist_node {
+ void *data;
+ ares__llist_node_t *prev;
+ ares__llist_node_t *next;
+ ares__llist_t *parent;
+};
+
+ares__llist_t *ares__llist_create(ares__llist_destructor_t destruct)
+{
+ ares__llist_t *list = ares_malloc_zero(sizeof(*list));
+
+ if (list == NULL) {
+ return NULL;
+ }
+
+ list->destruct = destruct;
+
+ return list;
+}
+
+void ares__llist_replace_destructor(ares__llist_t *list,
+ ares__llist_destructor_t destruct)
+{
+ if (list == NULL) {
+ return;
+ }
+
+ list->destruct = destruct;
+}
+
+typedef enum {
+ ARES__LLIST_INSERT_HEAD,
+ ARES__LLIST_INSERT_TAIL,
+ ARES__LLIST_INSERT_BEFORE
+} ares__llist_insert_type_t;
+
+static void ares__llist_attach_at(ares__llist_t *list,
+ ares__llist_insert_type_t type,
+ ares__llist_node_t *at,
+ ares__llist_node_t *node)
+{
+ if (list == NULL || node == NULL) {
+ return;
+ }
+
+ node->parent = list;
+
+ if (type == ARES__LLIST_INSERT_BEFORE && (at == list->head || at == NULL)) {
+ type = ARES__LLIST_INSERT_HEAD;
+ }
+
+ switch (type) {
+ case ARES__LLIST_INSERT_HEAD:
+ node->next = list->head;
+ node->prev = NULL;
+ if (list->head) {
+ list->head->prev = node;
+ }
+ list->head = node;
+ break;
+ case ARES__LLIST_INSERT_TAIL:
+ node->next = NULL;
+ node->prev = list->tail;
+ if (list->tail) {
+ list->tail->next = node;
+ }
+ list->tail = node;
+ break;
+ case ARES__LLIST_INSERT_BEFORE:
+ node->next = at;
+ node->prev = at->prev;
+ at->prev = node;
+ break;
+ }
+ if (list->tail == NULL) {
+ list->tail = node;
+ }
+ if (list->head == NULL) {
+ list->head = node;
+ }
+
+ list->cnt++;
+}
+
+static ares__llist_node_t *ares__llist_insert_at(ares__llist_t *list,
+ ares__llist_insert_type_t type,
+ ares__llist_node_t *at,
+ void *val)
+{
+ ares__llist_node_t *node = NULL;
+
+ if (list == NULL || val == NULL) {
+ return NULL;
+ }
+
+ node = ares_malloc_zero(sizeof(*node));
+
+ if (node == NULL) {
+ return NULL;
+ }
+
+ node->data = val;
+ ares__llist_attach_at(list, type, at, node);
+
+ return node;
+}
+
+ares__llist_node_t *ares__llist_insert_first(ares__llist_t *list, void *val)
+{
+ return ares__llist_insert_at(list, ARES__LLIST_INSERT_HEAD, NULL, val);
+}
+
+ares__llist_node_t *ares__llist_insert_last(ares__llist_t *list, void *val)
+{
+ return ares__llist_insert_at(list, ARES__LLIST_INSERT_TAIL, NULL, val);
+}
+
+ares__llist_node_t *ares__llist_insert_before(ares__llist_node_t *node,
+ void *val)
+{
+ if (node == NULL) {
+ return NULL;
+ }
+
+ return ares__llist_insert_at(node->parent, ARES__LLIST_INSERT_BEFORE, node,
+ val);
+}
+
+ares__llist_node_t *ares__llist_insert_after(ares__llist_node_t *node,
+ void *val)
+{
+ if (node == NULL) {
+ return NULL;
+ }
+
+ if (node->next == NULL) {
+ return ares__llist_insert_last(node->parent, val);
+ }
+
+ return ares__llist_insert_at(node->parent, ARES__LLIST_INSERT_BEFORE,
+ node->next, val);
+}
+
+ares__llist_node_t *ares__llist_node_first(ares__llist_t *list)
+{
+ if (list == NULL) {
+ return NULL;
+ }
+ return list->head;
+}
+
+ares__llist_node_t *ares__llist_node_last(ares__llist_t *list)
+{
+ if (list == NULL) {
+ return NULL;
+ }
+ return list->tail;
+}
+
+ares__llist_node_t *ares__llist_node_next(ares__llist_node_t *node)
+{
+ if (node == NULL) {
+ return NULL;
+ }
+ return node->next;
+}
+
+ares__llist_node_t *ares__llist_node_prev(ares__llist_node_t *node)
+{
+ if (node == NULL) {
+ return NULL;
+ }
+ return node->prev;
+}
+
+void *ares__llist_node_val(ares__llist_node_t *node)
+{
+ if (node == NULL) {
+ return NULL;
+ }
+
+ return node->data;
+}
+
+size_t ares__llist_len(const ares__llist_t *list)
+{
+ if (list == NULL) {
+ return 0;
+ }
+ return list->cnt;
+}
+
+ares__llist_t *ares__llist_node_parent(ares__llist_node_t *node)
+{
+ if (node == NULL) {
+ return NULL;
+ }
+ return node->parent;
+}
+
+void *ares__llist_first_val(ares__llist_t *list)
+{
+ return ares__llist_node_val(ares__llist_node_first(list));
+}
+
+void *ares__llist_last_val(ares__llist_t *list)
+{
+ return ares__llist_node_val(ares__llist_node_last(list));
+}
+
+static void ares__llist_node_detach(ares__llist_node_t *node)
+{
+ ares__llist_t *list;
+
+ if (node == NULL) {
+ return;
+ }
+
+ list = node->parent;
+
+ if (node->prev) {
+ node->prev->next = node->next;
+ }
+
+ if (node->next) {
+ node->next->prev = node->prev;
+ }
+
+ if (node == list->head) {
+ list->head = node->next;
+ }
+
+ if (node == list->tail) {
+ list->tail = node->prev;
+ }
+
+ node->parent = NULL;
+ list->cnt--;
+}
+
+void *ares__llist_node_claim(ares__llist_node_t *node)
+{
+ void *val;
+
+ if (node == NULL) {
+ return NULL;
+ }
+
+ val = node->data;
+ ares__llist_node_detach(node);
+ ares_free(node);
+
+ return val;
+}
+
+void ares__llist_node_destroy(ares__llist_node_t *node)
+{
+ ares__llist_destructor_t destruct;
+ void *val;
+
+ if (node == NULL) {
+ return;
+ }
+
+ destruct = node->parent->destruct;
+
+ val = ares__llist_node_claim(node);
+ if (val != NULL && destruct != NULL) {
+ destruct(val);
+ }
+}
+
+void ares__llist_node_replace(ares__llist_node_t *node, void *val)
+{
+ ares__llist_destructor_t destruct;
+
+ if (node == NULL) {
+ return;
+ }
+
+ destruct = node->parent->destruct;
+ if (destruct != NULL) {
+ destruct(node->data);
+ }
+
+ node->data = val;
+}
+
+void ares__llist_destroy(ares__llist_t *list)
+{
+ ares__llist_node_t *node;
+
+ if (list == NULL) {
+ return;
+ }
+
+ while ((node = ares__llist_node_first(list)) != NULL) {
+ ares__llist_node_destroy(node);
+ }
+ ares_free(list);
+}
+
+void ares__llist_node_move_parent_last(ares__llist_node_t *node,
+ ares__llist_t *new_parent)
+{
+ if (node == NULL || new_parent == NULL) {
+ return;
+ }
+
+ ares__llist_node_detach(node);
+ ares__llist_attach_at(new_parent, ARES__LLIST_INSERT_TAIL, NULL, node);
+}
+
+void ares__llist_node_move_parent_first(ares__llist_node_t *node,
+ ares__llist_t *new_parent)
+{
+ if (node == NULL || new_parent == NULL) {
+ return;
+ }
+
+ ares__llist_node_detach(node);
+ ares__llist_attach_at(new_parent, ARES__LLIST_INSERT_HEAD, NULL, node);
+}
diff --git a/subprojects/c-ares/src/lib/ares__llist.h b/subprojects/c-ares/src/lib/ares__llist.h
@@ -0,0 +1,220 @@
+/* MIT License
+ *
+ * Copyright (c) 2023 Brad House
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice (including the next
+ * paragraph) shall be included in all copies or substantial portions of the
+ * Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ *
+ * SPDX-License-Identifier: MIT
+ */
+#ifndef __ARES__LLIST_H
+#define __ARES__LLIST_H
+
+/*! \addtogroup ares__llist LinkedList Data Structure
+ *
+ * This is a doubly-linked list data structure.
+ *
+ * Average time complexity:
+ * - Insert: O(1) -- head or tail
+ * - Search: O(n)
+ * - Delete: O(1) -- delete assumes you hold a node pointer
+ *
+ * @{
+ */
+
+struct ares__llist;
+
+/*! Opaque data structure for linked list */
+typedef struct ares__llist ares__llist_t;
+
+struct ares__llist_node;
+
+/*! Opaque data structure for a node in a linked list */
+typedef struct ares__llist_node ares__llist_node_t;
+
+/*! Callback to free user-defined node data
+ *
+ * \param[in] data user supplied data
+ */
+typedef void (*ares__llist_destructor_t)(void *data);
+
+/*! Create a linked list object
+ *
+ * \param[in] destruct Optional. Destructor to call on all removed nodes
+ * \return linked list object or NULL on out of memory
+ */
+ares__llist_t *ares__llist_create(ares__llist_destructor_t destruct);
+
+/*! Replace destructor for linked list nodes. Typically this is used
+ * when wanting to disable the destructor by using NULL.
+ *
+ * \param[in] list Initialized linked list object
+ * \param[in] destruct replacement destructor, NULL is allowed
+ */
+void ares__llist_replace_destructor(ares__llist_t *list,
+ ares__llist_destructor_t destruct);
+
+/*! Insert value as the first node in the linked list
+ *
+ * \param[in] list Initialized linked list object
+ * \param[in] val user-supplied value.
+ * \return node object referencing place in list, or null if out of memory or
+ * misuse
+ */
+ares__llist_node_t *ares__llist_insert_first(ares__llist_t *list, void *val);
+
+/*! Insert value as the last node in the linked list
+ *
+ * \param[in] list Initialized linked list object
+ * \param[in] val user-supplied value.
+ * \return node object referencing place in list, or null if out of memory or
+ * misuse
+ */
+ares__llist_node_t *ares__llist_insert_last(ares__llist_t *list, void *val);
+
+/*! Insert value before specified node in the linked list
+ *
+ * \param[in] node node referenced to insert before
+ * \param[in] val user-supplied value.
+ * \return node object referencing place in list, or null if out of memory or
+ * misuse
+ */
+ares__llist_node_t *ares__llist_insert_before(ares__llist_node_t *node,
+ void *val);
+
+/*! Insert value after specified node in the linked list
+ *
+ * \param[in] node node referenced to insert after
+ * \param[in] val user-supplied value.
+ * \return node object referencing place in list, or null if out of memory or
+ * misuse
+ */
+ares__llist_node_t *ares__llist_insert_after(ares__llist_node_t *node,
+ void *val);
+
+/*! Obtain first node in list
+ *
+ * \param[in] list Initialized list object
+ * \return first node in list or NULL if none
+ */
+ares__llist_node_t *ares__llist_node_first(ares__llist_t *list);
+
+/*! Obtain last node in list
+ *
+ * \param[in] list Initialized list object
+ * \return last node in list or NULL if none
+ */
+ares__llist_node_t *ares__llist_node_last(ares__llist_t *list);
+
+/*! Obtain next node in respect to specified node
+ *
+ * \param[in] node Node referenced
+ * \return node or NULL if none
+ */
+ares__llist_node_t *ares__llist_node_next(ares__llist_node_t *node);
+
+/*! Obtain previous node in respect to specified node
+ *
+ * \param[in] node Node referenced
+ * \return node or NULL if none
+ */
+ares__llist_node_t *ares__llist_node_prev(ares__llist_node_t *node);
+
+/*! Obtain value from node
+ *
+ * \param[in] node Node referenced
+ * \return user provided value from node
+ */
+void *ares__llist_node_val(ares__llist_node_t *node);
+
+/*! Obtain the number of entries in the list
+ *
+ * \param[in] list Initialized list object
+ * \return count
+ */
+size_t ares__llist_len(const ares__llist_t *list);
+
+/*! Obtain list object from referenced node
+ *
+ * \param[in] node Node referenced
+ * \return list object node belongs to
+ */
+ares__llist_t *ares__llist_node_parent(ares__llist_node_t *node);
+
+/*! Obtain the first user-supplied value in the list
+ *
+ * \param[in] list Initialized list object
+ * \return first user supplied value or NULL if none
+ */
+void *ares__llist_first_val(ares__llist_t *list);
+
+/*! Obtain the last user-supplied value in the list
+ *
+ * \param[in] list Initialized list object
+ * \return last user supplied value or NULL if none
+ */
+void *ares__llist_last_val(ares__llist_t *list);
+
+/*! Take ownership of user-supplied value in list without calling destructor.
+ * Will unchain entry from list.
+ *
+ * \param[in] node Node referenced
+ * \return user supplied value
+ */
+void *ares__llist_node_claim(ares__llist_node_t *node);
+
+/*! Replace user-supplied value for node
+ *
+ * \param[in] node Node referenced
+ * \param[in] val new user-supplied value
+ */
+void ares__llist_node_replace(ares__llist_node_t *node, void *val);
+
+/*! Destroy the node, removing it from the list and calling destructor.
+ *
+ * \param[in] node Node referenced
+ */
+void ares__llist_node_destroy(ares__llist_node_t *node);
+
+/*! Destroy the list object and all nodes in the list.
+ *
+ * \param[in] list Initialized list object
+ */
+void ares__llist_destroy(ares__llist_t *list);
+
+/*! Detach node from the current list and re-attach it to the new list as the
+ * last entry.
+ *
+ * \param[in] node node to move
+ * \param[in] parent new list
+ */
+void ares__llist_node_move_parent_last(ares__llist_node_t *node,
+ ares__llist_t *new_parent);
+
+/*! Detach node from the current list and re-attach it to the new list as the
+ * first entry.
+ *
+ * \param[in] node node to move
+ * \param[in] parent new list
+ */
+void ares__llist_node_move_parent_first(ares__llist_node_t *node,
+ ares__llist_t *new_parent);
+/*! @} */
+
+#endif /* __ARES__LLIST_H */
diff --git a/subprojects/c-ares/src/lib/ares__parse_into_addrinfo.c b/subprojects/c-ares/src/lib/ares__parse_into_addrinfo.c
@@ -0,0 +1,184 @@
+/* MIT License
+ *
+ * Copyright (c) 2019 Andrew Selivanov
+ * Copyright (c) 2023 Brad House
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice (including the next
+ * paragraph) shall be included in all copies or substantial portions of the
+ * Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ *
+ * SPDX-License-Identifier: MIT
+ */
+#include "ares_setup.h"
+
+#ifdef HAVE_NETINET_IN_H
+# include <netinet/in.h>
+#endif
+#ifdef HAVE_NETDB_H
+# include <netdb.h>
+#endif
+#ifdef HAVE_ARPA_INET_H
+# include <arpa/inet.h>
+#endif
+
+#ifdef HAVE_STRINGS_H
+# include <strings.h>
+#endif
+
+#ifdef HAVE_LIMITS_H
+# include <limits.h>
+#endif
+
+#include "ares.h"
+#include "ares_private.h"
+
+ares_status_t ares__parse_into_addrinfo(const unsigned char *abuf, size_t alen,
+ ares_bool_t cname_only_is_enodata,
+ unsigned short port,
+ struct ares_addrinfo *ai)
+{
+ ares_status_t status;
+ ares_dns_record_t *dnsrec = NULL;
+ size_t i;
+ size_t ancount;
+ const char *hostname = NULL;
+ ares_bool_t got_a = ARES_FALSE;
+ ares_bool_t got_aaaa = ARES_FALSE;
+ ares_bool_t got_cname = ARES_FALSE;
+ struct ares_addrinfo_cname *cnames = NULL;
+ struct ares_addrinfo_node *nodes = NULL;
+
+ status = ares_dns_parse(abuf, alen, 0, &dnsrec);
+ if (status != ARES_SUCCESS) {
+ goto done;
+ }
+
+ /* Save question hostname */
+ status = ares_dns_record_query_get(dnsrec, 0, &hostname, NULL, NULL);
+ if (status != ARES_SUCCESS) {
+ goto done;
+ }
+
+ ancount = ares_dns_record_rr_cnt(dnsrec, ARES_SECTION_ANSWER);
+ if (ancount == 0) {
+ status = ARES_ENODATA;
+ goto done;
+ }
+
+ for (i = 0; i < ancount; i++) {
+ const char *rname = NULL;
+ ares_dns_rec_type_t rtype;
+ const ares_dns_rr_t *rr =
+ ares_dns_record_rr_get(dnsrec, ARES_SECTION_ANSWER, i);
+
+ if (ares_dns_rr_get_class(rr) != ARES_CLASS_IN) {
+ continue;
+ }
+
+ rtype = ares_dns_rr_get_type(rr);
+ rname = ares_dns_rr_get_name(rr);
+
+ /* Old code did this hostname sanity check */
+ if ((rtype == ARES_REC_TYPE_A || rtype == ARES_REC_TYPE_AAAA) &&
+ strcasecmp(rname, hostname) != 0) {
+ continue;
+ }
+
+ if (rtype == ARES_REC_TYPE_CNAME) {
+ struct ares_addrinfo_cname *cname;
+
+ got_cname = ARES_TRUE;
+ /* replace hostname with data from cname
+ * SA: Seems wrong as it introduces order dependency. */
+ hostname = ares_dns_rr_get_str(rr, ARES_RR_CNAME_CNAME);
+
+ cname = ares__append_addrinfo_cname(&cnames);
+ if (cname == NULL) {
+ status = ARES_ENOMEM;
+ goto done;
+ }
+ cname->ttl = (int)ares_dns_rr_get_ttl(rr);
+ cname->alias = ares_strdup(ares_dns_rr_get_name(rr));
+ if (cname->alias == NULL) {
+ status = ARES_ENOMEM;
+ goto done;
+ }
+ cname->name = ares_strdup(hostname);
+ if (cname->name == NULL) {
+ status = ARES_ENOMEM;
+ goto done;
+ }
+ } else if (rtype == ARES_REC_TYPE_A) {
+ got_a = ARES_TRUE;
+ status =
+ ares_append_ai_node(AF_INET, port, ares_dns_rr_get_ttl(rr),
+ ares_dns_rr_get_addr(rr, ARES_RR_A_ADDR), &nodes);
+ if (status != ARES_SUCCESS) {
+ goto done;
+ }
+ } else if (rtype == ARES_REC_TYPE_AAAA) {
+ got_aaaa = ARES_TRUE;
+ status = ares_append_ai_node(AF_INET6, port, ares_dns_rr_get_ttl(rr),
+ ares_dns_rr_get_addr6(rr, ARES_RR_AAAA_ADDR),
+ &nodes);
+ if (status != ARES_SUCCESS) {
+ goto done;
+ }
+ } else {
+ continue;
+ }
+ }
+
+ if (!got_a && !got_aaaa &&
+ (!got_cname || (got_cname && cname_only_is_enodata))) {
+ status = ARES_ENODATA;
+ goto done;
+ }
+
+ /* save the hostname as ai->name */
+ if (ai->name == NULL || strcasecmp(ai->name, hostname) != 0) {
+ ares_free(ai->name);
+ ai->name = ares_strdup(hostname);
+ if (ai->name == NULL) {
+ status = ARES_ENOMEM;
+ goto done;
+ }
+ }
+
+ if (got_a || got_aaaa) {
+ ares__addrinfo_cat_nodes(&ai->nodes, nodes);
+ nodes = NULL;
+ }
+
+ if (got_cname) {
+ ares__addrinfo_cat_cnames(&ai->cnames, cnames);
+ cnames = NULL;
+ }
+
+done:
+ ares__freeaddrinfo_cnames(cnames);
+ ares__freeaddrinfo_nodes(nodes);
+ ares_dns_record_destroy(dnsrec);
+
+ /* compatibility */
+ if (status == ARES_EBADNAME) {
+ status = ARES_EBADRESP;
+ }
+
+ return status;
+}
diff --git a/subprojects/c-ares/src/lib/ares__read_line.c b/subprojects/c-ares/src/lib/ares__read_line.c
@@ -0,0 +1,82 @@
+/* MIT License
+ *
+ * Copyright (c) 1998 Massachusetts Institute of Technology
+ * Copyright (c) The c-ares project and its contributors
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice (including the next
+ * paragraph) shall be included in all copies or substantial portions of the
+ * Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ *
+ * SPDX-License-Identifier: MIT
+ */
+
+#include "ares_setup.h"
+
+#include "ares.h"
+#include "ares_private.h"
+
+/* This is an internal function. Its contract is to read a line from
+ * a file into a dynamically allocated buffer, zeroing the trailing
+ * newline if there is one. The calling routine may call
+ * ares__read_line multiple times with the same buf and bufsize
+ * pointers; *buf will be reallocated and *bufsize adjusted as
+ * appropriate. The initial value of *buf should be NULL. After the
+ * calling routine is done reading lines, it should free *buf.
+ */
+ares_status_t ares__read_line(FILE *fp, char **buf, size_t *bufsize)
+{
+ char *newbuf;
+ size_t offset = 0;
+ size_t len;
+
+ if (*buf == NULL) {
+ *buf = ares_malloc(128);
+ if (!*buf) {
+ return ARES_ENOMEM;
+ }
+ *bufsize = 128;
+ }
+
+ for (;;) {
+ int bytestoread = (int)(*bufsize - offset);
+
+ if (!fgets(*buf + offset, bytestoread, fp)) {
+ return (offset != 0) ? 0 : (ferror(fp)) ? ARES_EFILE : ARES_EOF;
+ }
+ len = offset + ares_strlen(*buf + offset);
+ if ((*buf)[len - 1] == '\n') {
+ (*buf)[len - 1] = 0;
+ break;
+ }
+ offset = len;
+ if (len < *bufsize - 1) {
+ continue;
+ }
+
+ /* Allocate more space. */
+ newbuf = ares_realloc(*buf, *bufsize * 2);
+ if (!newbuf) {
+ ares_free(*buf);
+ *buf = NULL;
+ return ARES_ENOMEM;
+ }
+ *buf = newbuf;
+ *bufsize *= 2;
+ }
+ return ARES_SUCCESS;
+}
diff --git a/subprojects/c-ares/src/lib/ares__slist.c b/subprojects/c-ares/src/lib/ares__slist.c
@@ -0,0 +1,479 @@
+/* MIT License
+ *
+ * Copyright (c) 2023 Brad House
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice (including the next
+ * paragraph) shall be included in all copies or substantial portions of the
+ * Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ *
+ * SPDX-License-Identifier: MIT
+ */
+#include "ares_setup.h"
+#include "ares.h"
+#include "ares_private.h"
+#include "ares__slist.h"
+
+/* SkipList implementation */
+
+#define ARES__SLIST_START_LEVELS 4
+
+struct ares__slist {
+ ares_rand_state *rand_state;
+ unsigned char rand_data[8];
+ size_t rand_bits;
+
+ ares__slist_node_t **head;
+ size_t levels;
+ ares__slist_node_t *tail;
+
+ ares__slist_cmp_t cmp;
+ ares__slist_destructor_t destruct;
+ size_t cnt;
+};
+
+struct ares__slist_node {
+ void *data;
+ ares__slist_node_t **prev;
+ ares__slist_node_t **next;
+ size_t levels;
+ ares__slist_t *parent;
+};
+
+ares__slist_t *ares__slist_create(ares_rand_state *rand_state,
+ ares__slist_cmp_t cmp,
+ ares__slist_destructor_t destruct)
+{
+ ares__slist_t *list;
+
+ if (rand_state == NULL || cmp == NULL) {
+ return NULL;
+ }
+
+ list = ares_malloc_zero(sizeof(*list));
+
+ if (list == NULL) {
+ return NULL;
+ }
+
+ list->rand_state = rand_state;
+ list->cmp = cmp;
+ list->destruct = destruct;
+
+ list->levels = ARES__SLIST_START_LEVELS;
+ list->head = ares_malloc_zero(sizeof(*list->head) * list->levels);
+ if (list->head == NULL) {
+ ares_free(list);
+ return NULL;
+ }
+
+ return list;
+}
+
+static ares_bool_t ares__slist_coin_flip(ares__slist_t *list)
+{
+ size_t total_bits = sizeof(list->rand_data) * 8;
+ size_t bit;
+
+ /* Refill random data used for coin flips. We pull this in 8 byte chunks.
+ * ares__rand_bytes() has some built-in caching of its own so we don't need
+ * to be excessive in caching ourselves. Prefer to require less memory per
+ * skiplist */
+ if (list->rand_bits == 0) {
+ ares__rand_bytes(list->rand_state, list->rand_data,
+ sizeof(list->rand_data));
+ list->rand_bits = total_bits;
+ }
+
+ bit = total_bits - list->rand_bits;
+ list->rand_bits--;
+
+ return (list->rand_data[bit / 8] & (1 << (bit % 8))) ? ARES_TRUE : ARES_FALSE;
+}
+
+void ares__slist_replace_destructor(ares__slist_t *list,
+ ares__slist_destructor_t destruct)
+{
+ if (list == NULL) {
+ return;
+ }
+
+ list->destruct = destruct;
+}
+
+static size_t ares__slist_max_level(const ares__slist_t *list)
+{
+ size_t max_level = 0;
+
+ if (list->cnt + 1 <= (1 << ARES__SLIST_START_LEVELS)) {
+ max_level = ARES__SLIST_START_LEVELS;
+ } else {
+ max_level = ares__log2(ares__round_up_pow2(list->cnt + 1));
+ }
+
+ if (list->levels > max_level) {
+ max_level = list->levels;
+ }
+
+ return max_level;
+}
+
+static size_t ares__slist_calc_level(ares__slist_t *list)
+{
+ size_t max_level = ares__slist_max_level(list);
+ size_t level;
+
+ for (level = 1; ares__slist_coin_flip(list) && level < max_level; level++)
+ ;
+
+ return level;
+}
+
+static void ares__slist_node_push(ares__slist_t *list, ares__slist_node_t *node)
+{
+ size_t i;
+ ares__slist_node_t *left = NULL;
+
+ /* Scan from highest level in the slist, even if we're not using that number
+ * of levels for this entry as this is what makes it O(log n) */
+ for (i = list->levels; i-- > 0;) {
+ /* set left if left is NULL and the current node value is greater than the
+ * head at this level */
+ if (left == NULL && list->head[i] != NULL &&
+ list->cmp(node->data, list->head[i]->data) > 0) {
+ left = list->head[i];
+ }
+
+ if (left != NULL) {
+ /* scan forward to find our insertion point */
+ while (left->next[i] != NULL &&
+ list->cmp(node->data, left->next[i]->data) > 0) {
+ left = left->next[i];
+ }
+ }
+
+ /* search only as we didn't randomly select this number of levels */
+ if (i >= node->levels) {
+ continue;
+ }
+
+ if (left == NULL) {
+ /* head insertion */
+ node->next[i] = list->head[i];
+ node->prev[i] = NULL;
+ list->head[i] = node;
+ } else {
+ /* Chain */
+ node->next[i] = left->next[i];
+ node->prev[i] = left;
+ left->next[i] = node;
+ }
+
+ if (node->next[i] != NULL) {
+ /* chain prev */
+ node->next[i]->prev[i] = node;
+ } else {
+ if (i == 0) {
+ /* update tail */
+ list->tail = node;
+ }
+ }
+ }
+}
+
+ares__slist_node_t *ares__slist_insert(ares__slist_t *list, void *val)
+{
+ ares__slist_node_t *node = NULL;
+
+ if (list == NULL || val == NULL) {
+ return NULL;
+ }
+
+ node = ares_malloc_zero(sizeof(*node));
+
+ if (node == NULL) {
+ goto fail;
+ }
+
+ node->data = val;
+ node->parent = list;
+
+ /* Randomly determine the number of levels we want to use */
+ node->levels = ares__slist_calc_level(list);
+
+ /* Allocate array of next and prev nodes for linking each level */
+ node->next = ares_malloc_zero(sizeof(*node->next) * node->levels);
+ if (node->next == NULL) {
+ goto fail;
+ }
+
+ node->prev = ares_malloc_zero(sizeof(*node->prev) * node->levels);
+ if (node->prev == NULL) {
+ goto fail;
+ }
+
+ /* If the number of levels is greater than we currently support in the slist,
+ * increase the count */
+ if (list->levels < node->levels) {
+ void *ptr =
+ ares_realloc_zero(list->head, sizeof(*list->head) * list->levels,
+ sizeof(*list->head) * node->levels);
+ if (ptr == NULL) {
+ goto fail;
+ }
+
+ list->head = ptr;
+ list->levels = node->levels;
+ }
+
+ ares__slist_node_push(list, node);
+
+ list->cnt++;
+
+ return node;
+
+fail:
+ if (node) {
+ ares_free(node->prev);
+ ares_free(node->next);
+ ares_free(node);
+ }
+ return NULL;
+}
+
+static void ares__slist_node_pop(ares__slist_node_t *node)
+{
+ ares__slist_t *list = node->parent;
+ size_t i;
+
+ /* relink each node at each level */
+ for (i = node->levels; i-- > 0;) {
+ if (node->next[i] == NULL) {
+ if (i == 0) {
+ list->tail = node->prev[0];
+ }
+ } else {
+ node->next[i]->prev[i] = node->prev[i];
+ }
+
+ if (node->prev[i] == NULL) {
+ list->head[i] = node->next[i];
+ } else {
+ node->prev[i]->next[i] = node->next[i];
+ }
+ }
+
+ memset(node->next, 0, sizeof(*node->next) * node->levels);
+ memset(node->prev, 0, sizeof(*node->prev) * node->levels);
+}
+
+void *ares__slist_node_claim(ares__slist_node_t *node)
+{
+ ares__slist_t *list;
+ void *val;
+
+ if (node == NULL) {
+ return NULL;
+ }
+
+ list = node->parent;
+ val = node->data;
+
+ ares__slist_node_pop(node);
+
+ ares_free(node->next);
+ ares_free(node->prev);
+ ares_free(node);
+
+ list->cnt--;
+
+ return val;
+}
+
+void ares__slist_node_reinsert(ares__slist_node_t *node)
+{
+ ares__slist_t *list;
+
+ if (node == NULL) {
+ return;
+ }
+
+ list = node->parent;
+
+ ares__slist_node_pop(node);
+ ares__slist_node_push(list, node);
+}
+
+ares__slist_node_t *ares__slist_node_find(ares__slist_t *list, const void *val)
+{
+ size_t i;
+ ares__slist_node_t *node = NULL;
+ int rv = -1;
+
+ if (list == NULL || val == NULL) {
+ return NULL;
+ }
+
+ /* Scan nodes starting at the highest level. For each level scan forward
+ * until the value is between the prior and next node, or if equal quit
+ * as we found a match */
+ for (i = list->levels; i-- > 0;) {
+ if (node == NULL) {
+ node = list->head[i];
+ }
+
+ if (node == NULL) {
+ continue;
+ }
+
+ do {
+ rv = list->cmp(val, node->data);
+
+ if (rv < 0) {
+ /* back off, our value is greater than current node reference */
+ node = node->prev[i];
+ } else if (rv > 0) {
+ /* move forward and try again. if it goes past, it will loop again and
+ * go to previous entry */
+ node = node->next[i];
+ }
+
+ /* rv == 0 will terminate loop */
+
+ } while (node != NULL && rv > 0);
+
+ /* Found a match, no need to continue */
+ if (rv == 0) {
+ break;
+ }
+ }
+
+ /* no match */
+ if (rv != 0) {
+ return NULL;
+ }
+
+ /* The list may have multiple entries that match. They're guaranteed to be
+ * in order, but we're not guaranteed to have selected the _first_ matching
+ * node. Lets scan backwards to find the first match */
+ while (node->prev[0] != NULL && list->cmp(node->prev[0]->data, val) == 0) {
+ node = node->prev[0];
+ }
+
+ return node;
+}
+
+ares__slist_node_t *ares__slist_node_first(ares__slist_t *list)
+{
+ if (list == NULL) {
+ return NULL;
+ }
+
+ return list->head[0];
+}
+
+ares__slist_node_t *ares__slist_node_last(ares__slist_t *list)
+{
+ if (list == NULL) {
+ return NULL;
+ }
+ return list->tail;
+}
+
+ares__slist_node_t *ares__slist_node_next(ares__slist_node_t *node)
+{
+ if (node == NULL) {
+ return NULL;
+ }
+ return node->next[0];
+}
+
+ares__slist_node_t *ares__slist_node_prev(ares__slist_node_t *node)
+{
+ if (node == NULL) {
+ return NULL;
+ }
+ return node->prev[0];
+}
+
+void *ares__slist_node_val(ares__slist_node_t *node)
+{
+ if (node == NULL) {
+ return NULL;
+ }
+
+ return node->data;
+}
+
+size_t ares__slist_len(const ares__slist_t *list)
+{
+ if (list == NULL) {
+ return 0;
+ }
+ return list->cnt;
+}
+
+ares__slist_t *ares__slist_node_parent(ares__slist_node_t *node)
+{
+ if (node == NULL) {
+ return NULL;
+ }
+ return node->parent;
+}
+
+void *ares__slist_first_val(ares__slist_t *list)
+{
+ return ares__slist_node_val(ares__slist_node_first(list));
+}
+
+void *ares__slist_last_val(ares__slist_t *list)
+{
+ return ares__slist_node_val(ares__slist_node_last(list));
+}
+
+void ares__slist_node_destroy(ares__slist_node_t *node)
+{
+ ares__slist_destructor_t destruct;
+ void *val;
+
+ if (node == NULL) {
+ return;
+ }
+
+ destruct = node->parent->destruct;
+ val = ares__slist_node_claim(node);
+
+ if (val != NULL && destruct != NULL) {
+ destruct(val);
+ }
+}
+
+void ares__slist_destroy(ares__slist_t *list)
+{
+ ares__slist_node_t *node;
+
+ if (list == NULL) {
+ return;
+ }
+
+ while ((node = ares__slist_node_first(list)) != NULL) {
+ ares__slist_node_destroy(node);
+ }
+
+ ares_free(list->head);
+ ares_free(list);
+}
diff --git a/subprojects/c-ares/src/lib/ares__slist.h b/subprojects/c-ares/src/lib/ares__slist.h
@@ -0,0 +1,206 @@
+/* MIT License
+ *
+ * Copyright (c) 2023 Brad House
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice (including the next
+ * paragraph) shall be included in all copies or substantial portions of the
+ * Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ *
+ * SPDX-License-Identifier: MIT
+ */
+#ifndef __ARES__SLIST_H
+#define __ARES__SLIST_H
+
+
+/*! \addtogroup ares__slist SkipList Data Structure
+ *
+ * This data structure is known as a Skip List, which in essence is a sorted
+ * linked list with multiple levels of linkage to gain some algorithmic
+ * advantages. The usage symantecs are almost identical to what you'd expect
+ * with a linked list.
+ *
+ * Average time complexity:
+ * - Insert: O(log n)
+ * - Search: O(log n)
+ * - Delete: O(1) -- delete assumes you hold a node pointer
+ *
+ * It should be noted, however, that "effort" involved with an insert or
+ * remove operation is higher than a normal linked list. For very small
+ * lists this may be less efficient, but for any list with a moderate number
+ * of entries this will prove much more efficient.
+ *
+ * This data structure is often compared with a Binary Search Tree in
+ * functionality and usage.
+ *
+ * @{
+ */
+struct ares__slist;
+
+/*! SkipList Object, opaque */
+typedef struct ares__slist ares__slist_t;
+
+struct ares__slist_node;
+
+/*! SkipList Node Object, opaque */
+typedef struct ares__slist_node ares__slist_node_t;
+
+/*! SkipList Node Value destructor callback
+ *
+ * \param[in] data User-defined data to destroy
+ */
+typedef void (*ares__slist_destructor_t)(void *data);
+
+/*! SkipList comparison function
+ *
+ * \param[in] data1 First user-defined data object
+ * \param[in] data2 Second user-defined data object
+ * \return < 0 if data1 < data1, > 0 if data1 > data2, 0 if data1 == data2
+ */
+typedef int (*ares__slist_cmp_t)(const void *data1, const void *data2);
+
+/*! Create SkipList
+ *
+ * \param[in] rand_state Initialized ares random state.
+ * \param[in] cmp SkipList comparison function
+ * \param[in] destruct SkipList Node Value Destructor. Optional, use NULL.
+ * \return Initialized SkipList Object or NULL on misuse or ENOMEM
+ */
+ares__slist_t *ares__slist_create(ares_rand_state *rand_state,
+ ares__slist_cmp_t cmp,
+ ares__slist_destructor_t destruct);
+
+/*! Replace SkipList Node Value Destructor
+ *
+ * \param[in] list Initialized SkipList Object
+ * \param[in] destruct Replacement destructor. May be NULL.
+ */
+void ares__slist_replace_destructor(ares__slist_t *list,
+ ares__slist_destructor_t destruct);
+
+/*! Insert Value into SkipList
+ *
+ * \param[in] list Initialized SkipList Object
+ * \param[in] val Node Value. Must not be NULL. Function takes ownership
+ * and will have destructor called.
+ * \return SkipList Node Object or NULL on misuse or ENOMEM
+ */
+ares__slist_node_t *ares__slist_insert(ares__slist_t *list, void *val);
+
+/*! Fetch first node in SkipList
+ *
+ * \param[in] list Initialized SkipList Object
+ * \return SkipList Node Object or NULL if none
+ */
+ares__slist_node_t *ares__slist_node_first(ares__slist_t *list);
+
+/*! Fetch last node in SkipList
+ *
+ * \param[in] list Initialized SkipList Object
+ * \return SkipList Node Object or NULL if none
+ */
+ares__slist_node_t *ares__slist_node_last(ares__slist_t *list);
+
+/*! Fetch next node in SkipList
+ *
+ * \param[in] node SkipList Node Object
+ * \return SkipList Node Object or NULL if none
+ */
+ares__slist_node_t *ares__slist_node_next(ares__slist_node_t *node);
+
+/*! Fetch previous node in SkipList
+ *
+ * \param[in] node SkipList Node Object
+ * \return SkipList Node Object or NULL if none
+ */
+ares__slist_node_t *ares__slist_node_prev(ares__slist_node_t *node);
+
+/*! Fetch SkipList Node Object by Value
+ *
+ * \param[in] list Initialized SkipList Object
+ * \param[in] val Object to use for comparison
+ * \return SkipList Node Object or NULL if not found
+ */
+ares__slist_node_t *ares__slist_node_find(ares__slist_t *list, const void *val);
+
+
+/*! Fetch Node Value
+ *
+ * \param[in] node SkipList Node Object
+ * \return user defined node value
+ */
+void *ares__slist_node_val(ares__slist_node_t *node);
+
+/*! Fetch number of entries in SkipList Object
+ *
+ * \param[in] list Initialized SkipList Object
+ * \return number of entries
+ */
+size_t ares__slist_len(const ares__slist_t *list);
+
+/*! Fetch SkipList Object from SkipList Node
+ *
+ * \param[in] node SkipList Node Object
+ * \return SkipList Object
+ */
+ares__slist_t *ares__slist_node_parent(ares__slist_node_t *node);
+
+/*! Fetch first Node Value in SkipList
+ *
+ * \param[in] list Initialized SkipList Object
+ * \return user defined node value or NULL if none
+ */
+void *ares__slist_first_val(ares__slist_t *list);
+
+/*! Fetch last Node Value in SkipList
+ *
+ * \param[in] list Initialized SkipList Object
+ * \return user defined node value or NULL if none
+ */
+void *ares__slist_last_val(ares__slist_t *list);
+
+/*! Take back ownership of Node Value in SkipList, remove from SkipList.
+ *
+ * \param[in] node SkipList Node Object
+ * \return user defined node value
+ */
+void *ares__slist_node_claim(ares__slist_node_t *node);
+
+/*! The internals of the node have changed, thus its position in the sorted
+ * list is no longer valid. This function will remove it and re-add it to
+ * the proper position without needing to perform any memory allocations
+ * and thus cannot fail.
+ *
+ * \param[in] node SkipList Node Object
+ */
+void ares__slist_node_reinsert(ares__slist_node_t *node);
+
+/*! Remove Node from SkipList, calling destructor for Node Value.
+ *
+ * \param[in] node SkipList Node Object
+ */
+void ares__slist_node_destroy(ares__slist_node_t *node);
+
+/*! Destroy SkipList Object. If there are any nodes, they will be destroyed.
+ *
+ * \param[in] list Initialized SkipList Object
+ */
+void ares__slist_destroy(ares__slist_t *list);
+
+/*! @} */
+
+#endif /* __ARES__SLIST_H */
diff --git a/subprojects/c-ares/src/lib/ares__socket.c b/subprojects/c-ares/src/lib/ares__socket.c
@@ -0,0 +1,471 @@
+/* MIT License
+ *
+ * Copyright (c) Massachusetts Institute of Technology
+ * Copyright (c) The c-ares project and its contributors
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice (including the next
+ * paragraph) shall be included in all copies or substantial portions of the
+ * Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ *
+ * SPDX-License-Identifier: MIT
+ */
+#include "ares_setup.h"
+
+#ifdef HAVE_SYS_UIO_H
+# include <sys/uio.h>
+#endif
+#ifdef HAVE_NETINET_IN_H
+# include <netinet/in.h>
+#endif
+#ifdef HAVE_NETINET_TCP_H
+# include <netinet/tcp.h>
+#endif
+#ifdef HAVE_NETDB_H
+# include <netdb.h>
+#endif
+#ifdef HAVE_ARPA_INET_H
+# include <arpa/inet.h>
+#endif
+
+#ifdef HAVE_STRINGS_H
+# include <strings.h>
+#endif
+#ifdef HAVE_SYS_IOCTL_H
+# include <sys/ioctl.h>
+#endif
+#ifdef NETWARE
+# include <sys/filio.h>
+#endif
+
+#include <assert.h>
+#include <fcntl.h>
+#include <limits.h>
+
+#include "ares.h"
+#include "ares_private.h"
+
+ares_ssize_t ares__socket_recvfrom(ares_channel_t *channel, ares_socket_t s,
+ void *data, size_t data_len, int flags,
+ struct sockaddr *from,
+ ares_socklen_t *from_len)
+{
+ if (channel->sock_funcs && channel->sock_funcs->arecvfrom) {
+ return channel->sock_funcs->arecvfrom(s, data, data_len, flags, from,
+ from_len, channel->sock_func_cb_data);
+ }
+
+#ifdef HAVE_RECVFROM
+ return (ares_ssize_t)recvfrom(s, data, (RECVFROM_TYPE_ARG3)data_len, flags,
+ from, from_len);
+#else
+ return sread(s, data, data_len);
+#endif
+}
+
+ares_ssize_t ares__socket_recv(ares_channel_t *channel, ares_socket_t s,
+ void *data, size_t data_len)
+{
+ if (channel->sock_funcs && channel->sock_funcs->arecvfrom) {
+ return channel->sock_funcs->arecvfrom(s, data, data_len, 0, 0, 0,
+ channel->sock_func_cb_data);
+ }
+
+ /* sread() is a wrapper for read() or recv() depending on the system */
+ return sread(s, data, data_len);
+}
+
+/*
+ * setsocknonblock sets the given socket to either blocking or non-blocking
+ * mode based on the 'nonblock' boolean argument. This function is highly
+ * portable.
+ */
+static int setsocknonblock(ares_socket_t sockfd, /* operate on this */
+ int nonblock /* TRUE or FALSE */)
+{
+#if defined(USE_BLOCKING_SOCKETS)
+
+ return 0; /* returns success */
+
+#elif defined(HAVE_FCNTL_O_NONBLOCK)
+
+ /* most recent unix versions */
+ int flags;
+ flags = fcntl(sockfd, F_GETFL, 0);
+ if (nonblock) {
+ return fcntl(sockfd, F_SETFL, flags | O_NONBLOCK);
+ } else {
+ return fcntl(sockfd, F_SETFL, flags & (~O_NONBLOCK)); /* LCOV_EXCL_LINE */
+ }
+
+#elif defined(HAVE_IOCTL_FIONBIO)
+
+ /* older unix versions */
+ int flags = nonblock ? 1 : 0;
+ return ioctl(sockfd, FIONBIO, &flags);
+
+#elif defined(HAVE_IOCTLSOCKET_FIONBIO)
+
+# ifdef WATT32
+ char flags = nonblock ? 1 : 0;
+# else
+ /* Windows */
+ unsigned long flags = nonblock ? 1UL : 0UL;
+# endif
+ return ioctlsocket(sockfd, (long)FIONBIO, &flags);
+
+#elif defined(HAVE_IOCTLSOCKET_CAMEL_FIONBIO)
+
+ /* Amiga */
+ long flags = nonblock ? 1L : 0L;
+ return IoctlSocket(sockfd, FIONBIO, flags);
+
+#elif defined(HAVE_SETSOCKOPT_SO_NONBLOCK)
+
+ /* BeOS */
+ long b = nonblock ? 1L : 0L;
+ return setsockopt(sockfd, SOL_SOCKET, SO_NONBLOCK, &b, sizeof(b));
+
+#else
+# error "no non-blocking method was found/used/set"
+#endif
+}
+
+#if defined(IPV6_V6ONLY) && defined(WIN32)
+/* It makes support for IPv4-mapped IPv6 addresses.
+ * Linux kernel, NetBSD, FreeBSD and Darwin: default is off;
+ * Windows Vista and later: default is on;
+ * DragonFly BSD: acts like off, and dummy setting;
+ * OpenBSD and earlier Windows: unsupported.
+ * Linux: controlled by /proc/sys/net/ipv6/bindv6only.
+ */
+static void set_ipv6_v6only(ares_socket_t sockfd, int on)
+{
+ (void)setsockopt(sockfd, IPPROTO_IPV6, IPV6_V6ONLY, (void *)&on, sizeof(on));
+}
+#else
+# define set_ipv6_v6only(s, v)
+#endif
+
+static int configure_socket(ares_socket_t s, struct server_state *server)
+{
+ union {
+ struct sockaddr sa;
+ struct sockaddr_in sa4;
+ struct sockaddr_in6 sa6;
+ } local;
+
+ ares_socklen_t bindlen = 0;
+ ares_channel_t *channel = server->channel;
+
+ /* do not set options for user-managed sockets */
+ if (channel->sock_funcs && channel->sock_funcs->asocket) {
+ return 0;
+ }
+
+ (void)setsocknonblock(s, 1);
+
+#if defined(FD_CLOEXEC) && !defined(MSDOS)
+ /* Configure the socket fd as close-on-exec. */
+ if (fcntl(s, F_SETFD, FD_CLOEXEC) == -1) {
+ return -1; /* LCOV_EXCL_LINE */
+ }
+#endif
+
+ /* Set the socket's send and receive buffer sizes. */
+ if ((channel->socket_send_buffer_size > 0) &&
+ setsockopt(s, SOL_SOCKET, SO_SNDBUF,
+ (void *)&channel->socket_send_buffer_size,
+ sizeof(channel->socket_send_buffer_size)) == -1) {
+ return -1;
+ }
+
+ if ((channel->socket_receive_buffer_size > 0) &&
+ setsockopt(s, SOL_SOCKET, SO_RCVBUF,
+ (void *)&channel->socket_receive_buffer_size,
+ sizeof(channel->socket_receive_buffer_size)) == -1) {
+ return -1;
+ }
+
+#ifdef SO_BINDTODEVICE
+ if (channel->local_dev_name[0] &&
+ setsockopt(s, SOL_SOCKET, SO_BINDTODEVICE, channel->local_dev_name,
+ sizeof(channel->local_dev_name))) {
+ /* Only root can do this, and usually not fatal if it doesn't work, so */
+ /* just continue on. */
+ }
+#endif
+
+ if (server->addr.family == AF_INET && channel->local_ip4) {
+ memset(&local.sa4, 0, sizeof(local.sa4));
+ local.sa4.sin_family = AF_INET;
+ local.sa4.sin_addr.s_addr = htonl(channel->local_ip4);
+ bindlen = sizeof(local.sa4);
+ } else if (server->addr.family == AF_INET6 && server->ll_scope == 0 &&
+ memcmp(channel->local_ip6, ares_in6addr_any._S6_un._S6_u8,
+ sizeof(channel->local_ip6)) != 0) {
+ /* Only if not link-local and an ip other than "::" is specified */
+ memset(&local.sa6, 0, sizeof(local.sa6));
+ local.sa6.sin6_family = AF_INET6;
+ memcpy(&local.sa6.sin6_addr, channel->local_ip6,
+ sizeof(channel->local_ip6));
+ bindlen = sizeof(local.sa6);
+ }
+
+ if (bindlen && bind(s, &local.sa, bindlen) < 0) {
+ return -1;
+ }
+
+ if (server->addr.family == AF_INET6) {
+ set_ipv6_v6only(s, 0);
+ }
+
+ return 0;
+}
+
+ares_status_t ares__open_connection(ares_channel_t *channel,
+ struct server_state *server,
+ ares_bool_t is_tcp)
+{
+ ares_socket_t s;
+ int opt;
+ ares_socklen_t salen;
+
+ union {
+ struct sockaddr_in sa4;
+ struct sockaddr_in6 sa6;
+ } saddr;
+ struct sockaddr *sa;
+ struct server_connection *conn;
+ ares__llist_node_t *node;
+ int type = is_tcp ? SOCK_STREAM : SOCK_DGRAM;
+#ifdef __OpenBSD__
+ if ((is_tcp && server->tcp_port == 53) ||
+ (!is_tcp && server->udp_port == 53)) {
+ type |= SOCK_DNS;
+ }
+#endif
+
+ switch (server->addr.family) {
+ case AF_INET:
+ sa = (void *)&saddr.sa4;
+ salen = sizeof(saddr.sa4);
+ memset(sa, 0, (size_t)salen);
+ saddr.sa4.sin_family = AF_INET;
+ saddr.sa4.sin_port = htons(is_tcp ? server->tcp_port : server->udp_port);
+ memcpy(&saddr.sa4.sin_addr, &server->addr.addr.addr4,
+ sizeof(saddr.sa4.sin_addr));
+ break;
+ case AF_INET6:
+ sa = (void *)&saddr.sa6;
+ salen = sizeof(saddr.sa6);
+ memset(sa, 0, (size_t)salen);
+ saddr.sa6.sin6_family = AF_INET6;
+ saddr.sa6.sin6_port = htons(is_tcp ? server->tcp_port : server->udp_port);
+ memcpy(&saddr.sa6.sin6_addr, &server->addr.addr.addr6,
+ sizeof(saddr.sa6.sin6_addr));
+#ifdef HAVE_STRUCT_SOCKADDR_IN6_SIN6_SCOPE_ID
+ saddr.sa6.sin6_scope_id = server->ll_scope;
+#endif
+ break;
+ default:
+ return ARES_EBADFAMILY; /* LCOV_EXCL_LINE */
+ }
+
+ /* Acquire a socket. */
+ s = ares__open_socket(channel, server->addr.family, type, 0);
+ if (s == ARES_SOCKET_BAD) {
+ return ARES_ECONNREFUSED;
+ }
+
+ /* Configure it. */
+ if (configure_socket(s, server) < 0) {
+ ares__close_socket(channel, s);
+ return ARES_ECONNREFUSED;
+ }
+
+#ifdef TCP_NODELAY
+ if (is_tcp) {
+ /*
+ * Disable the Nagle algorithm (only relevant for TCP sockets, and thus not
+ * in configure_socket). In general, in DNS lookups we're pretty much
+ * interested in firing off a single request and then waiting for a reply,
+ * so batching isn't very interesting.
+ */
+ opt = 1;
+ if ((!channel->sock_funcs || !channel->sock_funcs->asocket) &&
+ setsockopt(s, IPPROTO_TCP, TCP_NODELAY, (void *)&opt, sizeof(opt)) ==
+ -1) {
+ ares__close_socket(channel, s);
+ return ARES_ECONNREFUSED;
+ }
+ }
+#endif
+
+ if (channel->sock_config_cb) {
+ int err = channel->sock_config_cb(s, type, channel->sock_config_cb_data);
+ if (err < 0) {
+ ares__close_socket(channel, s);
+ return ARES_ECONNREFUSED;
+ }
+ }
+
+ /* Connect to the server. */
+ if (ares__connect_socket(channel, s, sa, salen) == -1) {
+ int err = SOCKERRNO;
+
+ if (err != EINPROGRESS && err != EWOULDBLOCK) {
+ ares__close_socket(channel, s);
+ return ARES_ECONNREFUSED;
+ }
+ }
+
+ if (channel->sock_create_cb) {
+ int err = channel->sock_create_cb(s, type, channel->sock_create_cb_data);
+ if (err < 0) {
+ ares__close_socket(channel, s);
+ return ARES_ECONNREFUSED;
+ }
+ }
+
+ conn = ares_malloc(sizeof(*conn));
+ if (conn == NULL) {
+ ares__close_socket(channel, s);
+ return ARES_ENOMEM;
+ }
+ memset(conn, 0, sizeof(*conn));
+ conn->fd = s;
+ conn->server = server;
+ conn->queries_to_conn = ares__llist_create(NULL);
+ conn->is_tcp = is_tcp;
+ if (conn->queries_to_conn == NULL) {
+ ares__close_socket(channel, s);
+ ares_free(conn);
+ return ARES_ENOMEM;
+ }
+
+ /* TCP connections are thrown to the end as we don't spawn multiple TCP
+ * connections. UDP connections are put on front where the newest connection
+ * can be quickly pulled */
+ if (is_tcp) {
+ node = ares__llist_insert_last(server->connections, conn);
+ } else {
+ node = ares__llist_insert_first(server->connections, conn);
+ }
+ if (node == NULL) {
+ ares__close_socket(channel, s);
+ ares__llist_destroy(conn->queries_to_conn);
+ ares_free(conn);
+ return ARES_ENOMEM;
+ }
+
+ /* Register globally to quickly map event on file descriptor to connection
+ * node object */
+ if (!ares__htable_asvp_insert(channel->connnode_by_socket, s, node)) {
+ ares__close_socket(channel, s);
+ ares__llist_destroy(conn->queries_to_conn);
+ ares__llist_node_claim(node);
+ ares_free(conn);
+ return ARES_ENOMEM;
+ }
+
+ SOCK_STATE_CALLBACK(channel, s, 1, 0);
+
+ if (is_tcp) {
+ server->tcp_conn = conn;
+ }
+
+ return ARES_SUCCESS;
+}
+
+ares_socket_t ares__open_socket(ares_channel_t *channel, int af, int type,
+ int protocol)
+{
+ if (channel->sock_funcs && channel->sock_funcs->asocket) {
+ return channel->sock_funcs->asocket(af, type, protocol,
+ channel->sock_func_cb_data);
+ }
+
+ return socket(af, type, protocol);
+}
+
+int ares__connect_socket(ares_channel_t *channel, ares_socket_t sockfd,
+ const struct sockaddr *addr, ares_socklen_t addrlen)
+{
+ if (channel->sock_funcs && channel->sock_funcs->aconnect) {
+ return channel->sock_funcs->aconnect(sockfd, addr, addrlen,
+ channel->sock_func_cb_data);
+ }
+
+ return connect(sockfd, addr, addrlen);
+}
+
+void ares__close_socket(ares_channel_t *channel, ares_socket_t s)
+{
+ if (s == ARES_SOCKET_BAD) {
+ return;
+ }
+
+ if (channel->sock_funcs && channel->sock_funcs->aclose) {
+ channel->sock_funcs->aclose(s, channel->sock_func_cb_data);
+ } else {
+ sclose(s);
+ }
+}
+
+#ifndef HAVE_WRITEV
+/* Structure for scatter/gather I/O. */
+struct iovec {
+ void *iov_base; /* Pointer to data. */
+ size_t iov_len; /* Length of data. */
+};
+#endif
+
+ares_ssize_t ares__socket_write(ares_channel_t *channel, ares_socket_t s,
+ const void *data, size_t len)
+{
+ if (channel->sock_funcs && channel->sock_funcs->asendv) {
+ struct iovec vec;
+ vec.iov_base = (void *)((size_t)data); /* Cast off const */
+ vec.iov_len = len;
+ return channel->sock_funcs->asendv(s, &vec, 1, channel->sock_func_cb_data);
+ }
+ return swrite(s, data, len);
+}
+
+void ares_set_socket_callback(ares_channel_t *channel,
+ ares_sock_create_callback cb, void *data)
+{
+ channel->sock_create_cb = cb;
+ channel->sock_create_cb_data = data;
+}
+
+void ares_set_socket_configure_callback(ares_channel_t *channel,
+ ares_sock_config_callback cb,
+ void *data)
+{
+ channel->sock_config_cb = cb;
+ channel->sock_config_cb_data = data;
+}
+
+void ares_set_socket_functions(ares_channel_t *channel,
+ const struct ares_socket_functions *funcs,
+ void *data)
+{
+ channel->sock_funcs = funcs;
+ channel->sock_func_cb_data = data;
+}
diff --git a/subprojects/c-ares/src/lib/ares__sortaddrinfo.c b/subprojects/c-ares/src/lib/ares__sortaddrinfo.c
@@ -0,0 +1,452 @@
+/*
+ * Original file name getaddrinfo.c
+ * Lifted from the 'Android Bionic' project with the BSD license.
+ */
+
+/*
+ * Copyright (C) 1995, 1996, 1997, and 1998 WIDE Project.
+ * Copyright (C) 2018 The Android Open Source Project
+ * Copyright (C) 2019 Andrew Selivanov
+ * All rights reserved.
+ *
+ * Redistribution and use in source and binary forms, with or without
+ * modification, are permitted provided that the following conditions
+ * are met:
+ * 1. Redistributions of source code must retain the above copyright
+ * notice, this list of conditions and the following disclaimer.
+ * 2. Redistributions in binary form must reproduce the above copyright
+ * notice, this list of conditions and the following disclaimer in the
+ * documentation and/or other materials provided with the distribution.
+ * 3. Neither the name of the project nor the names of its contributors
+ * may be used to endorse or promote products derived from this software
+ * without specific prior written permission.
+ *
+ * THIS SOFTWARE IS PROVIDED BY THE PROJECT AND CONTRIBUTORS ``AS IS'' AND
+ * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+ * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+ * ARE DISCLAIMED. IN NO EVENT SHALL THE PROJECT OR CONTRIBUTORS BE LIABLE
+ * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+ * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
+ * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
+ * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
+ * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
+ * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
+ * SUCH DAMAGE.
+ *
+ * SPDX-License-Identifier: BSD-3-Clause
+ */
+
+#include "ares_setup.h"
+
+#ifdef HAVE_NETINET_IN_H
+# include <netinet/in.h>
+#endif
+#ifdef HAVE_NETDB_H
+# include <netdb.h>
+#endif
+#ifdef HAVE_STRINGS_H
+# include <strings.h>
+#endif
+
+#include <assert.h>
+#include <limits.h>
+
+#include "ares.h"
+#include "ares_private.h"
+
+struct addrinfo_sort_elem {
+ struct ares_addrinfo_node *ai;
+ ares_bool_t has_src_addr;
+ ares_sockaddr src_addr;
+ size_t original_order;
+};
+
+#define ARES_IPV6_ADDR_MC_SCOPE(a) ((a)->s6_addr[1] & 0x0f)
+
+#define ARES_IPV6_ADDR_SCOPE_NODELOCAL 0x01
+#define ARES_IPV6_ADDR_SCOPE_INTFACELOCAL 0x01
+#define ARES_IPV6_ADDR_SCOPE_LINKLOCAL 0x02
+#define ARES_IPV6_ADDR_SCOPE_SITELOCAL 0x05
+#define ARES_IPV6_ADDR_SCOPE_ORGLOCAL 0x08
+#define ARES_IPV6_ADDR_SCOPE_GLOBAL 0x0e
+
+#define ARES_IN_LOOPBACK(a) \
+ ((((long unsigned int)(a)) & 0xff000000) == 0x7f000000)
+
+/* RFC 4193. */
+#define ARES_IN6_IS_ADDR_ULA(a) (((a)->s6_addr[0] & 0xfe) == 0xfc)
+
+/* These macros are modelled after the ones in <netinet/in6.h>. */
+/* RFC 4380, section 2.6 */
+#define ARES_IN6_IS_ADDR_TEREDO(a) \
+ ((*(const unsigned int *)(const void *)(&(a)->s6_addr[0]) == \
+ ntohl(0x20010000)))
+/* RFC 3056, section 2. */
+#define ARES_IN6_IS_ADDR_6TO4(a) \
+ (((a)->s6_addr[0] == 0x20) && ((a)->s6_addr[1] == 0x02))
+/* 6bone testing address area (3ffe::/16), deprecated in RFC 3701. */
+#define ARES_IN6_IS_ADDR_6BONE(a) \
+ (((a)->s6_addr[0] == 0x3f) && ((a)->s6_addr[1] == 0xfe))
+
+static int get_scope(const struct sockaddr *addr)
+{
+ if (addr->sa_family == AF_INET6) {
+ const struct sockaddr_in6 *addr6 =
+ CARES_INADDR_CAST(const struct sockaddr_in6 *, addr);
+ if (IN6_IS_ADDR_MULTICAST(&addr6->sin6_addr)) {
+ return ARES_IPV6_ADDR_MC_SCOPE(&addr6->sin6_addr);
+ } else if (IN6_IS_ADDR_LOOPBACK(&addr6->sin6_addr) ||
+ IN6_IS_ADDR_LINKLOCAL(&addr6->sin6_addr)) {
+ /*
+ * RFC 4291 section 2.5.3 says loopback is to be treated as having
+ * link-local scope.
+ */
+ return ARES_IPV6_ADDR_SCOPE_LINKLOCAL;
+ } else if (IN6_IS_ADDR_SITELOCAL(&addr6->sin6_addr)) {
+ return ARES_IPV6_ADDR_SCOPE_SITELOCAL;
+ } else {
+ return ARES_IPV6_ADDR_SCOPE_GLOBAL;
+ }
+ } else if (addr->sa_family == AF_INET) {
+ const struct sockaddr_in *addr4 =
+ CARES_INADDR_CAST(const struct sockaddr_in *, addr);
+ unsigned long int na = ntohl(addr4->sin_addr.s_addr);
+ if (ARES_IN_LOOPBACK(na) || /* 127.0.0.0/8 */
+ (na & 0xffff0000) == 0xa9fe0000) /* 169.254.0.0/16 */
+ {
+ return ARES_IPV6_ADDR_SCOPE_LINKLOCAL;
+ } else {
+ /*
+ * RFC 6724 section 3.2. Other IPv4 addresses, including private
+ * addresses and shared addresses (100.64.0.0/10), are assigned global
+ * scope.
+ */
+ return ARES_IPV6_ADDR_SCOPE_GLOBAL;
+ }
+ } else {
+ /*
+ * This should never happen.
+ * Return a scope with low priority as a last resort.
+ */
+ return ARES_IPV6_ADDR_SCOPE_NODELOCAL;
+ }
+}
+
+static int get_label(const struct sockaddr *addr)
+{
+ if (addr->sa_family == AF_INET) {
+ return 4;
+ } else if (addr->sa_family == AF_INET6) {
+ const struct sockaddr_in6 *addr6 =
+ CARES_INADDR_CAST(const struct sockaddr_in6 *, addr);
+ if (IN6_IS_ADDR_LOOPBACK(&addr6->sin6_addr)) {
+ return 0;
+ } else if (IN6_IS_ADDR_V4MAPPED(&addr6->sin6_addr)) {
+ return 4;
+ } else if (ARES_IN6_IS_ADDR_6TO4(&addr6->sin6_addr)) {
+ return 2;
+ } else if (ARES_IN6_IS_ADDR_TEREDO(&addr6->sin6_addr)) {
+ return 5;
+ } else if (ARES_IN6_IS_ADDR_ULA(&addr6->sin6_addr)) {
+ return 13;
+ } else if (IN6_IS_ADDR_V4COMPAT(&addr6->sin6_addr)) {
+ return 3;
+ } else if (IN6_IS_ADDR_SITELOCAL(&addr6->sin6_addr)) {
+ return 11;
+ } else if (ARES_IN6_IS_ADDR_6BONE(&addr6->sin6_addr)) {
+ return 12;
+ } else {
+ /* All other IPv6 addresses, including global unicast addresses. */
+ return 1;
+ }
+ } else {
+ /*
+ * This should never happen.
+ * Return a semi-random label as a last resort.
+ */
+ return 1;
+ }
+}
+
+/*
+ * Get the precedence for a given IPv4/IPv6 address.
+ * RFC 6724, section 2.1.
+ */
+static int get_precedence(const struct sockaddr *addr)
+{
+ if (addr->sa_family == AF_INET) {
+ return 35;
+ } else if (addr->sa_family == AF_INET6) {
+ const struct sockaddr_in6 *addr6 =
+ CARES_INADDR_CAST(const struct sockaddr_in6 *, addr);
+ if (IN6_IS_ADDR_LOOPBACK(&addr6->sin6_addr)) {
+ return 50;
+ } else if (IN6_IS_ADDR_V4MAPPED(&addr6->sin6_addr)) {
+ return 35;
+ } else if (ARES_IN6_IS_ADDR_6TO4(&addr6->sin6_addr)) {
+ return 30;
+ } else if (ARES_IN6_IS_ADDR_TEREDO(&addr6->sin6_addr)) {
+ return 5;
+ } else if (ARES_IN6_IS_ADDR_ULA(&addr6->sin6_addr)) {
+ return 3;
+ } else if (IN6_IS_ADDR_V4COMPAT(&addr6->sin6_addr) ||
+ IN6_IS_ADDR_SITELOCAL(&addr6->sin6_addr) ||
+ ARES_IN6_IS_ADDR_6BONE(&addr6->sin6_addr)) {
+ return 1;
+ } else {
+ /* All other IPv6 addresses, including global unicast addresses. */
+ return 40;
+ }
+ } else {
+ return 1;
+ }
+}
+
+/*
+ * Find number of matching initial bits between the two addresses a1 and a2.
+ */
+static size_t common_prefix_len(const struct in6_addr *a1,
+ const struct in6_addr *a2)
+{
+ const unsigned char *p1 = (const unsigned char *)a1;
+ const unsigned char *p2 = (const unsigned char *)a2;
+ size_t i;
+ for (i = 0; i < sizeof(*a1); ++i) {
+ unsigned char x;
+ size_t j;
+ if (p1[i] == p2[i]) {
+ continue;
+ }
+ x = p1[i] ^ p2[i];
+ for (j = 0; j < CHAR_BIT; ++j) {
+ if (x & (1 << (CHAR_BIT - 1))) {
+ return i * CHAR_BIT + j;
+ }
+ x <<= 1;
+ }
+ }
+ return sizeof(*a1) * CHAR_BIT;
+}
+
+/*
+ * Compare two source/destination address pairs.
+ * RFC 6724, section 6.
+ */
+static int rfc6724_compare(const void *ptr1, const void *ptr2)
+{
+ const struct addrinfo_sort_elem *a1 = (const struct addrinfo_sort_elem *)ptr1;
+ const struct addrinfo_sort_elem *a2 = (const struct addrinfo_sort_elem *)ptr2;
+ int scope_src1;
+ int scope_dst1;
+ int scope_match1;
+ int scope_src2;
+ int scope_dst2;
+ int scope_match2;
+ int label_src1;
+ int label_dst1;
+ int label_match1;
+ int label_src2;
+ int label_dst2;
+ int label_match2;
+ int precedence1;
+ int precedence2;
+ size_t prefixlen1;
+ size_t prefixlen2;
+
+ /* Rule 1: Avoid unusable destinations. */
+ if (a1->has_src_addr != a2->has_src_addr) {
+ return ((int)a2->has_src_addr) - ((int)a1->has_src_addr);
+ }
+
+ /* Rule 2: Prefer matching scope. */
+ scope_src1 = ARES_IPV6_ADDR_SCOPE_NODELOCAL;
+ if (a1->has_src_addr) {
+ scope_src1 = get_scope(&a1->src_addr.sa);
+ }
+ scope_dst1 = get_scope(a1->ai->ai_addr);
+ scope_match1 = (scope_src1 == scope_dst1);
+
+ scope_src2 = ARES_IPV6_ADDR_SCOPE_NODELOCAL;
+ if (a2->has_src_addr) {
+ scope_src2 = get_scope(&a2->src_addr.sa);
+ }
+ scope_dst2 = get_scope(a2->ai->ai_addr);
+ scope_match2 = (scope_src2 == scope_dst2);
+
+ if (scope_match1 != scope_match2) {
+ return scope_match2 - scope_match1;
+ }
+
+ /* Rule 3: Avoid deprecated addresses. */
+
+ /* Rule 4: Prefer home addresses. */
+
+ /* Rule 5: Prefer matching label. */
+ label_src1 = 1;
+ if (a1->has_src_addr) {
+ label_src1 = get_label(&a1->src_addr.sa);
+ }
+ label_dst1 = get_label(a1->ai->ai_addr);
+ label_match1 = (label_src1 == label_dst1);
+
+ label_src2 = 1;
+ if (a2->has_src_addr) {
+ label_src2 = get_label(&a2->src_addr.sa);
+ }
+ label_dst2 = get_label(a2->ai->ai_addr);
+ label_match2 = (label_src2 == label_dst2);
+
+ if (label_match1 != label_match2) {
+ return label_match2 - label_match1;
+ }
+
+ /* Rule 6: Prefer higher precedence. */
+ precedence1 = get_precedence(a1->ai->ai_addr);
+ precedence2 = get_precedence(a2->ai->ai_addr);
+ if (precedence1 != precedence2) {
+ return precedence2 - precedence1;
+ }
+
+ /* Rule 7: Prefer native transport. */
+
+ /* Rule 8: Prefer smaller scope. */
+ if (scope_dst1 != scope_dst2) {
+ return scope_dst1 - scope_dst2;
+ }
+
+ /* Rule 9: Use longest matching prefix. */
+ if (a1->has_src_addr && a1->ai->ai_addr->sa_family == AF_INET6 &&
+ a2->has_src_addr && a2->ai->ai_addr->sa_family == AF_INET6) {
+ const struct sockaddr_in6 *a1_src = &a1->src_addr.sa6;
+ const struct sockaddr_in6 *a1_dst =
+ CARES_INADDR_CAST(const struct sockaddr_in6 *, a1->ai->ai_addr);
+ const struct sockaddr_in6 *a2_src = &a2->src_addr.sa6;
+ const struct sockaddr_in6 *a2_dst =
+ CARES_INADDR_CAST(const struct sockaddr_in6 *, a2->ai->ai_addr);
+ prefixlen1 = common_prefix_len(&a1_src->sin6_addr, &a1_dst->sin6_addr);
+ prefixlen2 = common_prefix_len(&a2_src->sin6_addr, &a2_dst->sin6_addr);
+ if (prefixlen1 != prefixlen2) {
+ return (int)prefixlen2 - (int)prefixlen1;
+ }
+ }
+
+ /*
+ * Rule 10: Leave the order unchanged.
+ * We need this since qsort() is not necessarily stable.
+ */
+ return ((int)a1->original_order) - ((int)a2->original_order);
+}
+
+/*
+ * Find the source address that will be used if trying to connect to the given
+ * address.
+ *
+ * Returns 1 if a source address was found, 0 if the address is unreachable
+ * and -1 if a fatal error occurred. If 0 or 1, the contents of src_addr are
+ * undefined.
+ */
+static int find_src_addr(ares_channel_t *channel, const struct sockaddr *addr,
+ struct sockaddr *src_addr)
+{
+ ares_socket_t sock;
+ int ret;
+ ares_socklen_t len;
+
+ switch (addr->sa_family) {
+ case AF_INET:
+ len = sizeof(struct sockaddr_in);
+ break;
+ case AF_INET6:
+ len = sizeof(struct sockaddr_in6);
+ break;
+ default:
+ /* No known usable source address for non-INET families. */
+ return 0;
+ }
+
+ sock = ares__open_socket(channel, addr->sa_family, SOCK_DGRAM, IPPROTO_UDP);
+ if (sock == ARES_SOCKET_BAD) {
+ if (errno == EAFNOSUPPORT) {
+ return 0;
+ } else {
+ return -1;
+ }
+ }
+
+ do {
+ ret = ares__connect_socket(channel, sock, addr, len);
+ } while (ret == -1 && errno == EINTR);
+
+ if (ret == -1) {
+ ares__close_socket(channel, sock);
+ return 0;
+ }
+
+ if (getsockname(sock, src_addr, &len) != 0) {
+ ares__close_socket(channel, sock);
+ return -1;
+ }
+ ares__close_socket(channel, sock);
+ return 1;
+}
+
+/*
+ * Sort the linked list starting at sentinel->ai_next in RFC6724 order.
+ * Will leave the list unchanged if an error occurs.
+ */
+ares_status_t ares__sortaddrinfo(ares_channel_t *channel,
+ struct ares_addrinfo_node *list_sentinel)
+{
+ struct ares_addrinfo_node *cur;
+ size_t nelem = 0;
+ size_t i;
+ int has_src_addr;
+ struct addrinfo_sort_elem *elems;
+
+ cur = list_sentinel->ai_next;
+ while (cur) {
+ ++nelem;
+ cur = cur->ai_next;
+ }
+
+ if (!nelem) {
+ return ARES_ENODATA;
+ }
+
+ elems = (struct addrinfo_sort_elem *)ares_malloc(
+ nelem * sizeof(struct addrinfo_sort_elem));
+ if (!elems) {
+ return ARES_ENOMEM;
+ }
+
+ /*
+ * Convert the linked list to an array that also contains the candidate
+ * source address for each destination address.
+ */
+ for (i = 0, cur = list_sentinel->ai_next; i < nelem;
+ ++i, cur = cur->ai_next) {
+ assert(cur != NULL);
+ elems[i].ai = cur;
+ elems[i].original_order = i;
+ has_src_addr = find_src_addr(channel, cur->ai_addr, &elems[i].src_addr.sa);
+ if (has_src_addr == -1) {
+ ares_free(elems);
+ return ARES_ENOTFOUND;
+ }
+ elems[i].has_src_addr = (has_src_addr == 1) ? ARES_TRUE : ARES_FALSE;
+ }
+
+ /* Sort the addresses, and rearrange the linked list so it matches the sorted
+ * order. */
+ qsort((void *)elems, nelem, sizeof(struct addrinfo_sort_elem),
+ rfc6724_compare);
+
+ list_sentinel->ai_next = elems[0].ai;
+ for (i = 0; i < nelem - 1; ++i) {
+ elems[i].ai->ai_next = elems[i + 1].ai;
+ }
+ elems[nelem - 1].ai->ai_next = NULL;
+
+ ares_free(elems);
+ return ARES_SUCCESS;
+}
diff --git a/subprojects/c-ares/src/lib/ares__threads.c b/subprojects/c-ares/src/lib/ares__threads.c
@@ -0,0 +1,193 @@
+/* MIT License
+ *
+ * Copyright (c) 2023 Brad House
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice (including the next
+ * paragraph) shall be included in all copies or substantial portions of the
+ * Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ *
+ * SPDX-License-Identifier: MIT
+ */
+#include "ares_setup.h"
+#include "ares.h"
+#include "ares_private.h"
+
+#ifdef CARES_THREADS
+# ifdef _WIN32
+
+struct ares__thread_mutex {
+ CRITICAL_SECTION mutex;
+};
+
+static ares__thread_mutex_t *ares__thread_mutex_create(void)
+{
+ ares__thread_mutex_t *mut = ares_malloc_zero(sizeof(*mut));
+ if (mut == NULL) {
+ return NULL;
+ }
+
+ InitializeCriticalSection(&mut->mutex);
+ return mut;
+}
+
+static void ares__thread_mutex_destroy(ares__thread_mutex_t *mut)
+{
+ if (mut == NULL) {
+ return;
+ }
+ DeleteCriticalSection(&mut->mutex);
+ ares_free(mut);
+}
+
+static void ares__thread_mutex_lock(ares__thread_mutex_t *mut)
+{
+ if (mut == NULL) {
+ return;
+ }
+ EnterCriticalSection(&mut->mutex);
+}
+
+static void ares__thread_mutex_unlock(ares__thread_mutex_t *mut)
+{
+ if (mut == NULL) {
+ return;
+ }
+ LeaveCriticalSection(&mut->mutex);
+}
+
+# else
+# include <pthread.h>
+
+struct ares__thread_mutex {
+ pthread_mutex_t mutex;
+};
+
+static ares__thread_mutex_t *ares__thread_mutex_create(void)
+{
+ pthread_mutexattr_t attr;
+ ares__thread_mutex_t *mut = ares_malloc_zero(sizeof(*mut));
+ if (mut == NULL) {
+ return NULL;
+ }
+
+ if (pthread_mutexattr_init(&attr) != 0) {
+ ares_free(mut);
+ return NULL;
+ }
+
+ if (pthread_mutexattr_settype(&attr, PTHREAD_MUTEX_RECURSIVE) != 0) {
+ goto fail;
+ }
+
+ if (pthread_mutex_init(&mut->mutex, &attr) != 0) {
+ goto fail;
+ }
+
+ pthread_mutexattr_destroy(&attr);
+ return mut;
+
+fail:
+ pthread_mutexattr_destroy(&attr);
+ ares_free(mut);
+ return NULL;
+}
+
+static void ares__thread_mutex_destroy(ares__thread_mutex_t *mut)
+{
+ if (mut == NULL) {
+ return;
+ }
+ pthread_mutex_destroy(&mut->mutex);
+ ares_free(mut);
+}
+
+static void ares__thread_mutex_lock(ares__thread_mutex_t *mut)
+{
+ if (mut == NULL) {
+ return;
+ }
+ pthread_mutex_lock(&mut->mutex);
+}
+
+static void ares__thread_mutex_unlock(ares__thread_mutex_t *mut)
+{
+ if (mut == NULL) {
+ return;
+ }
+ pthread_mutex_unlock(&mut->mutex);
+}
+# endif
+
+ares_status_t ares__channel_threading_init(ares_channel_t *channel)
+{
+ channel->lock = ares__thread_mutex_create();
+ if (channel->lock == NULL) {
+ return ARES_ENOMEM;
+ }
+ return ARES_SUCCESS;
+}
+
+void ares__channel_threading_destroy(ares_channel_t *channel)
+{
+ ares__thread_mutex_destroy(channel->lock);
+ channel->lock = NULL;
+}
+
+void ares__channel_lock(ares_channel_t *channel)
+{
+ ares__thread_mutex_lock(channel->lock);
+}
+
+void ares__channel_unlock(ares_channel_t *channel)
+{
+ ares__thread_mutex_unlock(channel->lock);
+}
+
+ares_bool_t ares_threadsafety(void)
+{
+ return ARES_TRUE;
+}
+
+#else
+/* NoOp */
+ares_status_t ares__channel_threading_init(ares_channel_t *channel)
+{
+ (void)channel;
+ return ARES_SUCCESS;
+}
+
+void ares__channel_threading_destroy(ares_channel_t *channel)
+{
+ (void)channel;
+}
+
+void ares__channel_lock(ares_channel_t *channel)
+{
+ (void)channel;
+}
+
+void ares__channel_unlock(ares_channel_t *channel)
+{
+ (void)channel;
+}
+
+ares_bool_t ares_threadsafety(void)
+{
+ return ARES_FALSE;
+}
+#endif
diff --git a/subprojects/c-ares/src/lib/ares__timeval.c b/subprojects/c-ares/src/lib/ares__timeval.c
@@ -0,0 +1,108 @@
+/* MIT License
+ *
+ * Copyright (c) 2008 Daniel Stenberg
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice (including the next
+ * paragraph) shall be included in all copies or substantial portions of the
+ * Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ *
+ * SPDX-License-Identifier: MIT
+ */
+
+#include "ares_setup.h"
+#include "ares.h"
+#include "ares_private.h"
+
+#if defined(WIN32) && !defined(MSDOS)
+
+struct timeval ares__tvnow(void)
+{
+ /*
+ ** GetTickCount() is available on _all_ Windows versions from W95 up
+ ** to nowadays. Returns milliseconds elapsed since last system boot,
+ ** increases monotonically and wraps once 49.7 days have elapsed.
+ */
+ struct timeval now;
+ DWORD milliseconds = GetTickCount();
+ now.tv_sec = (long)milliseconds / 1000;
+ now.tv_usec = (long)(milliseconds % 1000) * 1000;
+ return now;
+}
+
+#elif defined(HAVE_CLOCK_GETTIME_MONOTONIC)
+
+struct timeval ares__tvnow(void)
+{
+ /*
+ ** clock_gettime() is granted to be increased monotonically when the
+ ** monotonic clock is queried. Time starting point is unspecified, it
+ ** could be the system start-up time, the Epoch, or something else,
+ ** in any case the time starting point does not change once that the
+ ** system has started up.
+ */
+ struct timeval now;
+ struct timespec tsnow;
+ if (0 == clock_gettime(CLOCK_MONOTONIC, &tsnow)) {
+ now.tv_sec = tsnow.tv_sec;
+ now.tv_usec = (int)(tsnow.tv_nsec / 1000);
+ }
+ /*
+ ** Even when the configure process has truly detected monotonic clock
+ ** availability, it might happen that it is not actually available at
+ ** run-time. When this occurs simply fallback to other time source.
+ */
+# ifdef HAVE_GETTIMEOFDAY
+ else
+ (void)gettimeofday(&now, NULL); /* LCOV_EXCL_LINE */
+# else
+ else {
+ now.tv_sec = (long)time(NULL);
+ now.tv_usec = 0;
+ }
+# endif
+ return now;
+}
+
+#elif defined(HAVE_GETTIMEOFDAY)
+
+struct timeval ares__tvnow(void)
+{
+ /*
+ ** gettimeofday() is not granted to be increased monotonically, due to
+ ** clock drifting and external source time synchronization it can jump
+ ** forward or backward in time.
+ */
+ struct timeval now;
+ (void)gettimeofday(&now, NULL);
+ return now;
+}
+
+#else
+
+struct timeval ares__tvnow(void)
+{
+ /*
+ ** time() returns the value of time in seconds since the Epoch.
+ */
+ struct timeval now;
+ now.tv_sec = (long)time(NULL);
+ now.tv_usec = 0;
+ return now;
+}
+
+#endif
diff --git a/subprojects/c-ares/src/lib/ares_android.c b/subprojects/c-ares/src/lib/ares_android.c
@@ -0,0 +1,482 @@
+/* MIT License
+ *
+ * Copyright (c) John Schember
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice (including the next
+ * paragraph) shall be included in all copies or substantial portions of the
+ * Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ *
+ * SPDX-License-Identifier: MIT
+ */
+#if defined(ANDROID) || defined(__ANDROID__)
+
+# include <jni.h>
+
+# include "ares_setup.h"
+# include "ares.h"
+# include "ares_android.h"
+# include "ares_private.h"
+
+static JavaVM *android_jvm = NULL;
+static jobject android_connectivity_manager = NULL;
+
+/* ConnectivityManager.getActiveNetwork */
+static jmethodID android_cm_active_net_mid = NULL;
+/* ConnectivityManager.getLinkProperties */
+static jmethodID android_cm_link_props_mid = NULL;
+/* LinkProperties.getDnsServers */
+static jmethodID android_lp_dns_servers_mid = NULL;
+/* LinkProperties.getDomains */
+static jmethodID android_lp_domains_mid = NULL;
+/* List.size */
+static jmethodID android_list_size_mid = NULL;
+/* List.get */
+static jmethodID android_list_get_mid = NULL;
+/* InetAddress.getHostAddress */
+static jmethodID android_ia_host_addr_mid = NULL;
+
+static jclass jni_get_class(JNIEnv *env, const char *path)
+{
+ jclass cls = NULL;
+
+ if (env == NULL || path == NULL || *path == '\0') {
+ return NULL;
+ }
+
+ cls = (*env)->FindClass(env, path);
+ if ((*env)->ExceptionOccurred(env)) {
+ (*env)->ExceptionClear(env);
+ return NULL;
+ }
+ return cls;
+}
+
+static jmethodID jni_get_method_id(JNIEnv *env, jclass cls,
+ const char *func_name, const char *signature)
+{
+ jmethodID mid = NULL;
+
+ if (env == NULL || cls == NULL || func_name == NULL || *func_name == '\0' ||
+ signature == NULL || *signature == '\0') {
+ return NULL;
+ }
+
+ mid = (*env)->GetMethodID(env, cls, func_name, signature);
+ if ((*env)->ExceptionOccurred(env)) {
+ (*env)->ExceptionClear(env);
+ return NULL;
+ }
+
+ return mid;
+}
+
+void ares_library_init_jvm(JavaVM *jvm)
+{
+ android_jvm = jvm;
+}
+
+int ares_library_init_android(jobject connectivity_manager)
+{
+ JNIEnv *env = NULL;
+ int need_detatch = 0;
+ int res;
+ ares_status_t ret = ARES_ENOTINITIALIZED;
+ jclass obj_cls = NULL;
+
+ if (android_jvm == NULL) {
+ goto cleanup;
+ }
+
+ res = (*android_jvm)->GetEnv(android_jvm, (void **)&env, JNI_VERSION_1_6);
+ if (res == JNI_EDETACHED) {
+ env = NULL;
+ res = (*android_jvm)->AttachCurrentThread(android_jvm, &env, NULL);
+ need_detatch = 1;
+ }
+ if (res != JNI_OK || env == NULL) {
+ goto cleanup;
+ }
+
+ android_connectivity_manager =
+ (*env)->NewGlobalRef(env, connectivity_manager);
+ if (android_connectivity_manager == NULL) {
+ goto cleanup;
+ }
+
+ /* Initialization has succeeded. Now attempt to cache the methods that will be
+ * called by ares_get_android_server_list. */
+ ret = ARES_SUCCESS;
+
+ /* ConnectivityManager in API 1. */
+ obj_cls = jni_get_class(env, "android/net/ConnectivityManager");
+ if (obj_cls == NULL) {
+ goto cleanup;
+ }
+
+ /* ConnectivityManager.getActiveNetwork in API 23. */
+ android_cm_active_net_mid = jni_get_method_id(
+ env, obj_cls, "getActiveNetwork", "()Landroid/net/Network;");
+ if (android_cm_active_net_mid == NULL) {
+ goto cleanup;
+ }
+
+ /* ConnectivityManager.getLinkProperties in API 21. */
+ android_cm_link_props_mid =
+ jni_get_method_id(env, obj_cls, "getLinkProperties",
+ "(Landroid/net/Network;)Landroid/net/LinkProperties;");
+ if (android_cm_link_props_mid == NULL) {
+ goto cleanup;
+ }
+
+ /* LinkProperties in API 21. */
+ (*env)->DeleteLocalRef(env, obj_cls);
+ obj_cls = jni_get_class(env, "android/net/LinkProperties");
+ if (obj_cls == NULL) {
+ goto cleanup;
+ }
+
+ /* getDnsServers in API 21. */
+ android_lp_dns_servers_mid =
+ jni_get_method_id(env, obj_cls, "getDnsServers", "()Ljava/util/List;");
+ if (android_lp_dns_servers_mid == NULL) {
+ goto cleanup;
+ }
+
+ /* getDomains in API 21. */
+ android_lp_domains_mid =
+ jni_get_method_id(env, obj_cls, "getDomains", "()Ljava/lang/String;");
+ if (android_lp_domains_mid == NULL) {
+ goto cleanup;
+ }
+
+ (*env)->DeleteLocalRef(env, obj_cls);
+ obj_cls = jni_get_class(env, "java/util/List");
+ if (obj_cls == NULL) {
+ goto cleanup;
+ }
+
+ android_list_size_mid = jni_get_method_id(env, obj_cls, "size", "()I");
+ if (android_list_size_mid == NULL) {
+ goto cleanup;
+ }
+
+ android_list_get_mid =
+ jni_get_method_id(env, obj_cls, "get", "(I)Ljava/lang/Object;");
+ if (android_list_get_mid == NULL) {
+ goto cleanup;
+ }
+
+ (*env)->DeleteLocalRef(env, obj_cls);
+ obj_cls = jni_get_class(env, "java/net/InetAddress");
+ if (obj_cls == NULL) {
+ goto cleanup;
+ }
+
+ android_ia_host_addr_mid =
+ jni_get_method_id(env, obj_cls, "getHostAddress", "()Ljava/lang/String;");
+ if (android_ia_host_addr_mid == NULL) {
+ goto cleanup;
+ }
+
+ (*env)->DeleteLocalRef(env, obj_cls);
+ goto done;
+
+cleanup:
+ if (obj_cls != NULL) {
+ (*env)->DeleteLocalRef(env, obj_cls);
+ }
+
+ android_cm_active_net_mid = NULL;
+ android_cm_link_props_mid = NULL;
+ android_lp_dns_servers_mid = NULL;
+ android_lp_domains_mid = NULL;
+ android_list_size_mid = NULL;
+ android_list_get_mid = NULL;
+ android_ia_host_addr_mid = NULL;
+
+done:
+ if (need_detatch) {
+ (*android_jvm)->DetachCurrentThread(android_jvm);
+ }
+
+ return ret;
+}
+
+int ares_library_android_initialized(void)
+{
+ if (android_jvm == NULL || android_connectivity_manager == NULL) {
+ return ARES_ENOTINITIALIZED;
+ }
+ return ARES_SUCCESS;
+}
+
+void ares_library_cleanup_android(void)
+{
+ JNIEnv *env = NULL;
+ int need_detatch = 0;
+ int res;
+
+ if (android_jvm == NULL || android_connectivity_manager == NULL) {
+ return;
+ }
+
+ res = (*android_jvm)->GetEnv(android_jvm, (void **)&env, JNI_VERSION_1_6);
+ if (res == JNI_EDETACHED) {
+ env = NULL;
+ res = (*android_jvm)->AttachCurrentThread(android_jvm, &env, NULL);
+ need_detatch = 1;
+ }
+ if (res != JNI_OK || env == NULL) {
+ return;
+ }
+
+ android_cm_active_net_mid = NULL;
+ android_cm_link_props_mid = NULL;
+ android_lp_dns_servers_mid = NULL;
+ android_lp_domains_mid = NULL;
+ android_list_size_mid = NULL;
+ android_list_get_mid = NULL;
+ android_ia_host_addr_mid = NULL;
+
+ (*env)->DeleteGlobalRef(env, android_connectivity_manager);
+ android_connectivity_manager = NULL;
+
+ if (need_detatch) {
+ (*android_jvm)->DetachCurrentThread(android_jvm);
+ }
+}
+
+char **ares_get_android_server_list(size_t max_servers, size_t *num_servers)
+{
+ JNIEnv *env = NULL;
+ jobject active_network = NULL;
+ jobject link_properties = NULL;
+ jobject server_list = NULL;
+ jobject server = NULL;
+ jstring str = NULL;
+ jint nserv;
+ const char *ch_server_address;
+ int res;
+ size_t i;
+ char **dns_list = NULL;
+ int need_detatch = 0;
+
+ if (android_jvm == NULL || android_connectivity_manager == NULL ||
+ max_servers == 0 || num_servers == NULL) {
+ return NULL;
+ }
+
+ if (android_cm_active_net_mid == NULL || android_cm_link_props_mid == NULL ||
+ android_lp_dns_servers_mid == NULL || android_list_size_mid == NULL ||
+ android_list_get_mid == NULL || android_ia_host_addr_mid == NULL) {
+ return NULL;
+ }
+
+ res = (*android_jvm)->GetEnv(android_jvm, (void **)&env, JNI_VERSION_1_6);
+ if (res == JNI_EDETACHED) {
+ env = NULL;
+ res = (*android_jvm)->AttachCurrentThread(android_jvm, &env, NULL);
+ need_detatch = 1;
+ }
+ if (res != JNI_OK || env == NULL) {
+ goto done;
+ }
+
+ /* JNI below is equivalent to this Java code.
+ import android.content.Context;
+ import android.net.ConnectivityManager;
+ import android.net.LinkProperties;
+ import android.net.Network;
+ import java.net.InetAddress;
+ import java.util.List;
+
+ ConnectivityManager cm = (ConnectivityManager)this.getApplicationContext()
+ .getSystemService(Context.CONNECTIVITY_SERVICE);
+ Network an = cm.getActiveNetwork();
+ LinkProperties lp = cm.getLinkProperties(an);
+ List<InetAddress> dns = lp.getDnsServers();
+ for (InetAddress ia: dns) {
+ String ha = ia.getHostAddress();
+ }
+
+ Note: The JNI ConnectivityManager object and all method IDs were previously
+ initialized in ares_library_init_android.
+ */
+
+ active_network = (*env)->CallObjectMethod(env, android_connectivity_manager,
+ android_cm_active_net_mid);
+ if (active_network == NULL) {
+ goto done;
+ }
+
+ link_properties =
+ (*env)->CallObjectMethod(env, android_connectivity_manager,
+ android_cm_link_props_mid, active_network);
+ if (link_properties == NULL) {
+ goto done;
+ }
+
+ server_list =
+ (*env)->CallObjectMethod(env, link_properties, android_lp_dns_servers_mid);
+ if (server_list == NULL) {
+ goto done;
+ }
+
+ nserv = (*env)->CallIntMethod(env, server_list, android_list_size_mid);
+ if (nserv > (jint)max_servers) {
+ nserv = (jint)max_servers;
+ }
+ if (nserv <= 0) {
+ goto done;
+ }
+ *num_servers = (size_t)nserv;
+
+ dns_list = ares_malloc(sizeof(*dns_list) * (*num_servers));
+ for (i = 0; i < *num_servers; i++) {
+ size_t len = 64;
+ server =
+ (*env)->CallObjectMethod(env, server_list, android_list_get_mid, (jint)i);
+ dns_list[i] = ares_malloc(len);
+ dns_list[i][0] = 0;
+ if (server == NULL) {
+ continue;
+ }
+ str = (*env)->CallObjectMethod(env, server, android_ia_host_addr_mid);
+ ch_server_address = (*env)->GetStringUTFChars(env, str, 0);
+ ares_strcpy(dns_list[i], ch_server_address, len);
+ (*env)->ReleaseStringUTFChars(env, str, ch_server_address);
+ (*env)->DeleteLocalRef(env, str);
+ (*env)->DeleteLocalRef(env, server);
+ }
+
+done:
+ if ((*env)->ExceptionOccurred(env)) {
+ (*env)->ExceptionClear(env);
+ }
+
+ if (server_list != NULL) {
+ (*env)->DeleteLocalRef(env, server_list);
+ }
+ if (link_properties != NULL) {
+ (*env)->DeleteLocalRef(env, link_properties);
+ }
+ if (active_network != NULL) {
+ (*env)->DeleteLocalRef(env, active_network);
+ }
+
+ if (need_detatch) {
+ (*android_jvm)->DetachCurrentThread(android_jvm);
+ }
+ return dns_list;
+}
+
+char *ares_get_android_search_domains_list(void)
+{
+ JNIEnv *env = NULL;
+ jobject active_network = NULL;
+ jobject link_properties = NULL;
+ jstring domains = NULL;
+ const char *domain;
+ int res;
+ char *domain_list = NULL;
+ int need_detatch = 0;
+
+ if (android_jvm == NULL || android_connectivity_manager == NULL) {
+ return NULL;
+ }
+
+ if (android_cm_active_net_mid == NULL || android_cm_link_props_mid == NULL ||
+ android_lp_domains_mid == NULL) {
+ return NULL;
+ }
+
+ res = (*android_jvm)->GetEnv(android_jvm, (void **)&env, JNI_VERSION_1_6);
+ if (res == JNI_EDETACHED) {
+ env = NULL;
+ res = (*android_jvm)->AttachCurrentThread(android_jvm, &env, NULL);
+ need_detatch = 1;
+ }
+ if (res != JNI_OK || env == NULL) {
+ goto done;
+ }
+
+ /* JNI below is equivalent to this Java code.
+ import android.content.Context;
+ import android.net.ConnectivityManager;
+ import android.net.LinkProperties;
+
+ ConnectivityManager cm = (ConnectivityManager)this.getApplicationContext()
+ .getSystemService(Context.CONNECTIVITY_SERVICE);
+ Network an = cm.getActiveNetwork();
+ LinkProperties lp = cm.getLinkProperties(an);
+ String domains = lp.getDomains();
+ for (String domain: domains.split(",")) {
+ String d = domain;
+ }
+
+ Note: The JNI ConnectivityManager object and all method IDs were previously
+ initialized in ares_library_init_android.
+ */
+
+ active_network = (*env)->CallObjectMethod(env, android_connectivity_manager,
+ android_cm_active_net_mid);
+ if (active_network == NULL) {
+ goto done;
+ }
+
+ link_properties =
+ (*env)->CallObjectMethod(env, android_connectivity_manager,
+ android_cm_link_props_mid, active_network);
+ if (link_properties == NULL) {
+ goto done;
+ }
+
+ /* Get the domains. It is a common separated list of domains to search. */
+ domains =
+ (*env)->CallObjectMethod(env, link_properties, android_lp_domains_mid);
+ if (domains == NULL) {
+ goto done;
+ }
+
+ /* Split on , */
+ domain = (*env)->GetStringUTFChars(env, domains, 0);
+ domain_list = ares_strdup(domain);
+ (*env)->ReleaseStringUTFChars(env, domains, domain);
+ (*env)->DeleteLocalRef(env, domains);
+
+done:
+ if ((*env)->ExceptionOccurred(env)) {
+ (*env)->ExceptionClear(env);
+ }
+
+ if (link_properties != NULL) {
+ (*env)->DeleteLocalRef(env, link_properties);
+ }
+ if (active_network != NULL) {
+ (*env)->DeleteLocalRef(env, active_network);
+ }
+
+ if (need_detatch) {
+ (*android_jvm)->DetachCurrentThread(android_jvm);
+ }
+ return domain_list;
+}
+#else
+/* warning: ISO C forbids an empty translation unit */
+typedef int dummy_make_iso_compilers_happy;
+#endif
diff --git a/subprojects/c-ares/src/lib/ares_android.h b/subprojects/c-ares/src/lib/ares_android.h
@@ -0,0 +1,38 @@
+/* MIT License
+ *
+ * Copyright (c) John Schember
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice (including the next
+ * paragraph) shall be included in all copies or substantial portions of the
+ * Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ *
+ * SPDX-License-Identifier: MIT
+ */
+
+#ifndef __ARES_ANDROID_H__
+#define __ARES_ANDROID_H__
+
+#if defined(ANDROID) || defined(__ANDROID__)
+
+char **ares_get_android_server_list(size_t max_servers, size_t *num_servers);
+char *ares_get_android_search_domains_list(void);
+void ares_library_cleanup_android(void);
+
+#endif
+
+#endif /* __ARES_ANDROID_H__ */
diff --git a/subprojects/c-ares/src/lib/ares_cancel.c b/subprojects/c-ares/src/lib/ares_cancel.c
@@ -0,0 +1,90 @@
+/* MIT License
+ *
+ * Copyright (c) 2004 Daniel Stenberg
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice (including the next
+ * paragraph) shall be included in all copies or substantial portions of the
+ * Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ *
+ * SPDX-License-Identifier: MIT
+ */
+
+#include "ares_setup.h"
+#include <assert.h>
+
+#include "ares.h"
+#include "ares_private.h"
+
+/*
+ * ares_cancel() cancels all ongoing requests/resolves that might be going on
+ * on the given channel. It does NOT kill the channel, use ares_destroy() for
+ * that.
+ */
+void ares_cancel(ares_channel_t *channel)
+{
+ if (channel == NULL) {
+ return;
+ }
+
+ ares__channel_lock(channel);
+
+ if (ares__llist_len(channel->all_queries) > 0) {
+ ares__llist_node_t *node = NULL;
+ ares__llist_node_t *next = NULL;
+
+ /* Swap list heads, so that only those queries which were present on entry
+ * into this function are cancelled. New queries added by callbacks of
+ * queries being cancelled will not be cancelled themselves.
+ */
+ ares__llist_t *list_copy = channel->all_queries;
+ channel->all_queries = ares__llist_create(NULL);
+
+ /* Out of memory, this function doesn't return a result code though so we
+ * can't report to caller */
+ if (channel->all_queries == NULL) {
+ channel->all_queries = list_copy;
+ goto done;
+ }
+
+ node = ares__llist_node_first(list_copy);
+ while (node != NULL) {
+ struct query *query;
+ struct server_connection *conn;
+
+ /* Cache next since this node is being deleted */
+ next = ares__llist_node_next(node);
+
+ query = ares__llist_node_claim(node);
+ conn = query->conn;
+ query->node_all_queries = NULL;
+
+ /* NOTE: its possible this may enqueue new queries */
+ query->callback(query->arg, ARES_ECANCELLED, 0, NULL, 0);
+ ares__free_query(query);
+
+ /* See if the connection should be cleaned up */
+ ares__check_cleanup_conn(channel, conn);
+
+ node = next;
+ }
+
+ ares__llist_destroy(list_copy);
+ }
+done:
+ ares__channel_unlock(channel);
+}
diff --git a/subprojects/c-ares/src/lib/ares_config.h.cmake b/subprojects/c-ares/src/lib/ares_config.h.cmake
@@ -0,0 +1,439 @@
+/* Copyright (C) The c-ares project and its contributors
+ * SPDX-License-Identifier: MIT
+ */
+
+/* Generated from ares_config.h.cmake */
+
+/* Define if building universal (internal helper macro) */
+#undef AC_APPLE_UNIVERSAL_BUILD
+
+/* Defined for build with symbol hiding. */
+#cmakedefine CARES_SYMBOL_HIDING
+
+/* Use resolver library to configure cares */
+#cmakedefine CARES_USE_LIBRESOLV
+
+/* if a /etc/inet dir is being used */
+#undef ETC_INET
+
+/* Define to the type of arg 2 for gethostname. */
+#define GETHOSTNAME_TYPE_ARG2 @GETHOSTNAME_TYPE_ARG2@
+
+/* Define to the type qualifier of arg 1 for getnameinfo. */
+#define GETNAMEINFO_QUAL_ARG1 @GETNAMEINFO_QUAL_ARG1@
+
+/* Define to the type of arg 1 for getnameinfo. */
+#define GETNAMEINFO_TYPE_ARG1 @GETNAMEINFO_TYPE_ARG1@
+
+/* Define to the type of arg 2 for getnameinfo. */
+#define GETNAMEINFO_TYPE_ARG2 @GETNAMEINFO_TYPE_ARG2@
+
+/* Define to the type of args 4 and 6 for getnameinfo. */
+#define GETNAMEINFO_TYPE_ARG46 @GETNAMEINFO_TYPE_ARG46@
+
+/* Define to the type of arg 7 for getnameinfo. */
+#define GETNAMEINFO_TYPE_ARG7 @GETNAMEINFO_TYPE_ARG7@
+
+/* Specifies the number of arguments to getservbyport_r */
+#define GETSERVBYPORT_R_ARGS @GETSERVBYPORT_R_ARGS@
+
+/* Specifies the number of arguments to getservbyname_r */
+#define GETSERVBYNAME_R_ARGS @GETSERVBYNAME_R_ARGS@
+
+/* Define to 1 if you have AF_INET6. */
+#cmakedefine HAVE_AF_INET6
+
+/* Define to 1 if you have the <arpa/inet.h> header file. */
+#cmakedefine HAVE_ARPA_INET_H
+
+/* Define to 1 if you have the <arpa/nameser_compat.h> header file. */
+#cmakedefine HAVE_ARPA_NAMESER_COMPAT_H
+
+/* Define to 1 if you have the <arpa/nameser.h> header file. */
+#cmakedefine HAVE_ARPA_NAMESER_H
+
+/* Define to 1 if you have the <assert.h> header file. */
+#cmakedefine HAVE_ASSERT_H
+
+/* Define to 1 if you have the clock_gettime function and monotonic timer. */
+#cmakedefine HAVE_CLOCK_GETTIME_MONOTONIC
+
+/* Define to 1 if you have the closesocket function. */
+#cmakedefine HAVE_CLOSESOCKET
+
+/* Define to 1 if you have the CloseSocket camel case function. */
+#cmakedefine HAVE_CLOSESOCKET_CAMEL
+
+/* Define to 1 if you have the connect function. */
+#cmakedefine HAVE_CONNECT
+
+/* define if the compiler supports basic C++11 syntax */
+#cmakedefine HAVE_CXX11
+
+/* Define to 1 if you have the <dlfcn.h> header file. */
+#cmakedefine HAVE_DLFCN_H
+
+/* Define to 1 if you have the <errno.h> header file. */
+#cmakedefine HAVE_ERRNO_H
+
+/* Define to 1 if you have the fcntl function. */
+#cmakedefine HAVE_FCNTL
+
+/* Define to 1 if you have the <fcntl.h> header file. */
+#cmakedefine HAVE_FCNTL_H
+
+/* Define to 1 if you have a working fcntl O_NONBLOCK function. */
+#cmakedefine HAVE_FCNTL_O_NONBLOCK
+
+/* Define to 1 if you have the freeaddrinfo function. */
+#cmakedefine HAVE_FREEADDRINFO
+
+/* Define to 1 if you have a working getaddrinfo function. */
+#cmakedefine HAVE_GETADDRINFO
+
+/* Define to 1 if the getaddrinfo function is threadsafe. */
+#cmakedefine HAVE_GETADDRINFO_THREADSAFE
+
+/* Define to 1 if you have the getenv function. */
+#cmakedefine HAVE_GETENV
+
+/* Define to 1 if you have the gethostname function. */
+#cmakedefine HAVE_GETHOSTNAME
+
+/* Define to 1 if you have the getnameinfo function. */
+#cmakedefine HAVE_GETNAMEINFO
+
+/* Define to 1 if you have the getrandom function. */
+#cmakedefine HAVE_GETRANDOM
+
+/* Define to 1 if you have the getservbyport_r function. */
+#cmakedefine HAVE_GETSERVBYPORT_R
+
+/* Define to 1 if you have the getservbyname_r function. */
+#cmakedefine HAVE_GETSERVBYNAME_R
+
+/* Define to 1 if you have the `gettimeofday' function. */
+#cmakedefine HAVE_GETTIMEOFDAY
+
+/* Define to 1 if you have the `if_indextoname' function. */
+#cmakedefine HAVE_IF_INDEXTONAME
+
+/* Define to 1 if you have the `if_nametoindex' function. */
+#cmakedefine HAVE_IF_NAMETOINDEX
+
+/* Define to 1 if you have the `ConvertInterfaceIndexToLuid' function. */
+#cmakedefine HAVE_CONVERTINTERFACEINDEXTOLUID
+
+/* Define to 1 if you have the `ConvertInterfaceLuidToNameA' function. */
+#cmakedefine HAVE_CONVERTINTERFACELUIDTONAMEA
+
+/* Define to 1 if you have a IPv6 capable working inet_net_pton function. */
+#cmakedefine HAVE_INET_NET_PTON
+
+/* Define to 1 if you have a IPv6 capable working inet_ntop function. */
+#cmakedefine HAVE_INET_NTOP
+
+/* Define to 1 if you have a IPv6 capable working inet_pton function. */
+#cmakedefine HAVE_INET_PTON
+
+/* Define to 1 if you have the <inttypes.h> header file. */
+#cmakedefine HAVE_INTTYPES_H
+
+/* Define to 1 if you have the ioctl function. */
+#cmakedefine HAVE_IOCTL
+
+/* Define to 1 if you have the ioctlsocket function. */
+#cmakedefine HAVE_IOCTLSOCKET
+
+/* Define to 1 if you have the IoctlSocket camel case function. */
+#cmakedefine HAVE_IOCTLSOCKET_CAMEL
+
+/* Define to 1 if you have a working IoctlSocket camel case FIONBIO function.
+ */
+#cmakedefine HAVE_IOCTLSOCKET_CAMEL_FIONBIO
+
+/* Define to 1 if you have a working ioctlsocket FIONBIO function. */
+#cmakedefine HAVE_IOCTLSOCKET_FIONBIO
+
+/* Define to 1 if you have a working ioctl FIONBIO function. */
+#cmakedefine HAVE_IOCTL_FIONBIO
+
+/* Define to 1 if you have a working ioctl SIOCGIFADDR function. */
+#cmakedefine HAVE_IOCTL_SIOCGIFADDR
+
+/* Define to 1 if you have the `resolve' library (-lresolve). */
+#cmakedefine HAVE_LIBRESOLV
+
+/* Define to 1 if you have iphlpapi.h */
+#cmakedefine HAVE_IPHLPAPI_H
+
+/* Define to 1 if you have netioapi.h */
+#cmakedefine HAVE_NETIOAPI_H
+
+/* Define to 1 if you have the <limits.h> header file. */
+#cmakedefine HAVE_LIMITS_H
+
+/* Define to 1 if the compiler supports the 'long long' data type. */
+#cmakedefine HAVE_LONGLONG
+
+/* Define to 1 if you have the malloc.h header file. */
+#cmakedefine HAVE_MALLOC_H
+
+/* Define to 1 if you have the memory.h header file. */
+#cmakedefine HAVE_MEMORY_H
+
+/* Define to 1 if you have the MSG_NOSIGNAL flag. */
+#cmakedefine HAVE_MSG_NOSIGNAL
+
+/* Define to 1 if you have the <netdb.h> header file. */
+#cmakedefine HAVE_NETDB_H
+
+/* Define to 1 if you have the <netinet/in.h> header file. */
+#cmakedefine HAVE_NETINET_IN_H
+
+/* Define to 1 if you have the <netinet/tcp.h> header file. */
+#cmakedefine HAVE_NETINET_TCP_H
+
+/* Define to 1 if you have the <net/if.h> header file. */
+#cmakedefine HAVE_NET_IF_H
+
+/* Define to 1 if you have PF_INET6. */
+#cmakedefine HAVE_PF_INET6
+
+/* Define to 1 if you have the recv function. */
+#cmakedefine HAVE_RECV
+
+/* Define to 1 if you have the recvfrom function. */
+#cmakedefine HAVE_RECVFROM
+
+/* Define to 1 if you have the send function. */
+#cmakedefine HAVE_SEND
+
+/* Define to 1 if you have the setsockopt function. */
+#cmakedefine HAVE_SETSOCKOPT
+
+/* Define to 1 if you have a working setsockopt SO_NONBLOCK function. */
+#cmakedefine HAVE_SETSOCKOPT_SO_NONBLOCK
+
+/* Define to 1 if you have the <signal.h> header file. */
+#cmakedefine HAVE_SIGNAL_H
+
+/* Define to 1 if your struct sockaddr_in6 has sin6_scope_id. */
+#cmakedefine HAVE_STRUCT_SOCKADDR_IN6_SIN6_SCOPE_ID
+
+/* Define to 1 if you have the socket function. */
+#cmakedefine HAVE_SOCKET
+
+/* Define to 1 if you have the <socket.h> header file. */
+#cmakedefine HAVE_SOCKET_H
+
+/* Define to 1 if you have the <stdbool.h> header file. */
+#cmakedefine HAVE_STDBOOL_H
+
+/* Define to 1 if you have the <stdint.h> header file. */
+#cmakedefine HAVE_STDINT_H
+
+/* Define to 1 if you have the <stdlib.h> header file. */
+#cmakedefine HAVE_STDLIB_H
+
+/* Define to 1 if you have the strcasecmp function. */
+#cmakedefine HAVE_STRCASECMP
+
+/* Define to 1 if you have the strcmpi function. */
+#cmakedefine HAVE_STRCMPI
+
+/* Define to 1 if you have the strdup function. */
+#cmakedefine HAVE_STRDUP
+
+/* Define to 1 if you have the stricmp function. */
+#cmakedefine HAVE_STRICMP
+
+/* Define to 1 if you have the <strings.h> header file. */
+#cmakedefine HAVE_STRINGS_H
+
+/* Define to 1 if you have the <string.h> header file. */
+#cmakedefine HAVE_STRING_H
+
+/* Define to 1 if you have the strncasecmp function. */
+#cmakedefine HAVE_STRNCASECMP
+
+/* Define to 1 if you have the strncmpi function. */
+#cmakedefine HAVE_STRNCMPI
+
+/* Define to 1 if you have the strnicmp function. */
+#cmakedefine HAVE_STRNICMP
+
+/* Define to 1 if you have the <stropts.h> header file. */
+#cmakedefine HAVE_STROPTS_H
+
+/* Define to 1 if you have struct addrinfo. */
+#cmakedefine HAVE_STRUCT_ADDRINFO
+
+/* Define to 1 if you have struct in6_addr. */
+#cmakedefine HAVE_STRUCT_IN6_ADDR
+
+/* Define to 1 if you have struct sockaddr_in6. */
+#cmakedefine HAVE_STRUCT_SOCKADDR_IN6
+
+/* if struct sockaddr_storage is defined */
+#cmakedefine HAVE_STRUCT_SOCKADDR_STORAGE
+
+/* Define to 1 if you have the timeval struct. */
+#cmakedefine HAVE_STRUCT_TIMEVAL
+
+/* Define to 1 if you have the <sys/ioctl.h> header file. */
+#cmakedefine HAVE_SYS_IOCTL_H
+
+/* Define to 1 if you have the <sys/param.h> header file. */
+#cmakedefine HAVE_SYS_PARAM_H
+
+/* Define to 1 if you have the <sys/random.h> header file. */
+#cmakedefine HAVE_SYS_RANDOM_H
+
+/* Define to 1 if you have the <sys/select.h> header file. */
+#cmakedefine HAVE_SYS_SELECT_H
+
+/* Define to 1 if you have the <sys/socket.h> header file. */
+#cmakedefine HAVE_SYS_SOCKET_H
+
+/* Define to 1 if you have the <sys/stat.h> header file. */
+#cmakedefine HAVE_SYS_STAT_H
+
+/* Define to 1 if you have the <sys/time.h> header file. */
+#cmakedefine HAVE_SYS_TIME_H
+
+/* Define to 1 if you have the <sys/types.h> header file. */
+#cmakedefine HAVE_SYS_TYPES_H
+
+/* Define to 1 if you have the <sys/uio.h> header file. */
+#cmakedefine HAVE_SYS_UIO_H
+
+/* Define to 1 if you have the <time.h> header file. */
+#cmakedefine HAVE_TIME_H
+
+/* Define to 1 if you have the <ifaddrs.h> header file. */
+#cmakedefine HAVE_IFADDRS_H
+
+/* Define to 1 if you have the <unistd.h> header file. */
+#cmakedefine HAVE_UNISTD_H
+
+/* Define to 1 if you have the windows.h header file. */
+#cmakedefine HAVE_WINDOWS_H
+
+/* Define to 1 if you have the winsock2.h header file. */
+#cmakedefine HAVE_WINSOCK2_H
+
+/* Define to 1 if you have the winsock.h header file. */
+#cmakedefine HAVE_WINSOCK_H
+
+/* Define to 1 if you have the writev function. */
+#cmakedefine HAVE_WRITEV
+
+/* Define to 1 if you have the ws2tcpip.h header file. */
+#cmakedefine HAVE_WS2TCPIP_H
+
+/* Define to 1 if you have the __system_property_get function */
+#cmakedefine HAVE___SYSTEM_PROPERTY_GET
+
+/* Define to 1 if you need the malloc.h header file even with stdlib.h */
+#cmakedefine NEED_MALLOC_H
+
+/* Define to 1 if you need the memory.h header file even with stdlib.h */
+#cmakedefine NEED_MEMORY_H
+
+/* Define if have arc4random_buf() */
+#cmakedefine HAVE_ARC4RANDOM_BUF
+
+/* Define if have getifaddrs() */
+#cmakedefine HAVE_GETIFADDRS
+
+/* Define if have stat() */
+#cmakedefine HAVE_STAT
+
+/* a suitable file/device to read random data from */
+#cmakedefine CARES_RANDOM_FILE "@CARES_RANDOM_FILE@"
+
+/* Define to the type qualifier pointed by arg 5 for recvfrom. */
+#define RECVFROM_QUAL_ARG5 @RECVFROM_QUAL_ARG5@
+
+/* Define to the type of arg 1 for recvfrom. */
+#define RECVFROM_TYPE_ARG1 @RECVFROM_TYPE_ARG1@
+
+/* Define to the type pointed by arg 2 for recvfrom. */
+#define RECVFROM_TYPE_ARG2 @RECVFROM_TYPE_ARG2@
+
+/* Define to 1 if the type pointed by arg 2 for recvfrom is void. */
+#cmakedefine01 RECVFROM_TYPE_ARG2_IS_VOID
+
+/* Define to the type of arg 3 for recvfrom. */
+#define RECVFROM_TYPE_ARG3 @RECVFROM_TYPE_ARG3@
+
+/* Define to the type of arg 4 for recvfrom. */
+#define RECVFROM_TYPE_ARG4 @RECVFROM_TYPE_ARG4@
+
+/* Define to the type pointed by arg 5 for recvfrom. */
+#define RECVFROM_TYPE_ARG5 @RECVFROM_TYPE_ARG5@
+
+/* Define to 1 if the type pointed by arg 5 for recvfrom is void. */
+#cmakedefine01 RECVFROM_TYPE_ARG5_IS_VOID
+
+/* Define to the type pointed by arg 6 for recvfrom. */
+#define RECVFROM_TYPE_ARG6 @RECVFROM_TYPE_ARG6@
+
+/* Define to 1 if the type pointed by arg 6 for recvfrom is void. */
+#cmakedefine01 RECVFROM_TYPE_ARG6_IS_VOID
+
+/* Define to the function return type for recvfrom. */
+#define RECVFROM_TYPE_RETV @RECVFROM_TYPE_RETV@
+
+/* Define to the type of arg 1 for recv. */
+#define RECV_TYPE_ARG1 @RECV_TYPE_ARG1@
+
+/* Define to the type of arg 2 for recv. */
+#define RECV_TYPE_ARG2 @RECV_TYPE_ARG2@
+
+/* Define to the type of arg 3 for recv. */
+#define RECV_TYPE_ARG3 @RECV_TYPE_ARG3@
+
+/* Define to the type of arg 4 for recv. */
+#define RECV_TYPE_ARG4 @RECV_TYPE_ARG4@
+
+/* Define to the function return type for recv. */
+#define RECV_TYPE_RETV @RECV_TYPE_RETV@
+
+/* Define to the type qualifier of arg 2 for send. */
+#define SEND_QUAL_ARG2 @SEND_QUAL_ARG2@
+
+/* Define to the type of arg 1 for send. */
+#define SEND_TYPE_ARG1 @SEND_TYPE_ARG1@
+
+/* Define to the type of arg 2 for send. */
+#define SEND_TYPE_ARG2 @SEND_TYPE_ARG2@
+
+/* Define to the type of arg 3 for send. */
+#define SEND_TYPE_ARG3 @SEND_TYPE_ARG3@
+
+/* Define to the type of arg 4 for send. */
+#define SEND_TYPE_ARG4 @SEND_TYPE_ARG4@
+
+/* Define to the function return type for send. */
+#define SEND_TYPE_RETV @SEND_TYPE_RETV@
+
+/* Define to disable non-blocking sockets. */
+#undef USE_BLOCKING_SOCKETS
+
+/* Define to avoid automatic inclusion of winsock.h */
+#undef WIN32_LEAN_AND_MEAN
+
+/* Define to 1 if you have the pthread.h header file. */
+#cmakedefine HAVE_PTHREAD_H
+
+/* Define to 1 if you have the pthread_np.h header file. */
+#cmakedefine HAVE_PTHREAD_NP_H
+
+/* Define to 1 if threads are enabled */
+#cmakedefine CARES_THREADS
+
+/* Define to 1 if pthread_init() exists */
+#cmakedefine HAVE_PTHREAD_INIT
+
diff --git a/subprojects/c-ares/src/lib/ares_create_query.c b/subprojects/c-ares/src/lib/ares_create_query.c
@@ -0,0 +1,107 @@
+/* MIT License
+ *
+ * Copyright (c) 2023 Brad House
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice (including the next
+ * paragraph) shall be included in all copies or substantial portions of the
+ * Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ *
+ * SPDX-License-Identifier: MIT
+ */
+
+#include "ares_setup.h"
+#include "ares.h"
+#include "ares_private.h"
+
+int ares_create_query(const char *name, int dnsclass, int type,
+ unsigned short id, int rd, unsigned char **bufp,
+ int *buflenp, int max_udp_size)
+{
+ ares_status_t status;
+ ares_dns_record_t *dnsrec = NULL;
+ size_t len;
+
+ if (name == NULL || bufp == NULL || buflenp == NULL) {
+ status = ARES_EFORMERR;
+ goto done;
+ }
+
+ *bufp = NULL;
+ *buflenp = 0;
+
+ /* Per RFC 7686, reject queries for ".onion" domain names with NXDOMAIN. */
+ if (ares__is_onion_domain(name)) {
+ status = ARES_ENOTFOUND;
+ goto done;
+ }
+
+ status = ares_dns_record_create(&dnsrec, id, rd ? ARES_FLAG_RD : 0,
+ ARES_OPCODE_QUERY, ARES_RCODE_NOERROR);
+ if (status != ARES_SUCCESS) {
+ goto done;
+ }
+
+ status = ares_dns_record_query_add(dnsrec, name, (ares_dns_rec_type_t)type,
+ (ares_dns_class_t)dnsclass);
+ if (status != ARES_SUCCESS) {
+ goto done;
+ }
+
+ /* max_udp_size > 0 indicates EDNS, so send OPT RR as an additional record */
+ if (max_udp_size > 0) {
+ ares_dns_rr_t *rr = NULL;
+
+ status = ares_dns_record_rr_add(&rr, dnsrec, ARES_SECTION_ADDITIONAL, "",
+ ARES_REC_TYPE_OPT, ARES_CLASS_IN, 0);
+ if (status != ARES_SUCCESS) {
+ goto done;
+ }
+
+ if (max_udp_size > 65535) {
+ status = ARES_EFORMERR;
+ goto done;
+ }
+
+ status = ares_dns_rr_set_u16(rr, ARES_RR_OPT_UDP_SIZE,
+ (unsigned short)max_udp_size);
+ if (status != ARES_SUCCESS) {
+ goto done;
+ }
+
+ status = ares_dns_rr_set_u8(rr, ARES_RR_OPT_VERSION, 0);
+ if (status != ARES_SUCCESS) {
+ goto done;
+ }
+
+ status = ares_dns_rr_set_u16(rr, ARES_RR_OPT_FLAGS, 0);
+ if (status != ARES_SUCCESS) {
+ goto done;
+ }
+ }
+
+ status = ares_dns_write(dnsrec, bufp, &len);
+ if (status != ARES_SUCCESS) {
+ goto done;
+ }
+
+ *buflenp = (int)len;
+
+done:
+ ares_dns_record_destroy(dnsrec);
+ return (int)status;
+}
diff --git a/subprojects/c-ares/src/lib/ares_data.c b/subprojects/c-ares/src/lib/ares_data.c
@@ -0,0 +1,172 @@
+/* MIT License
+ *
+ * Copyright (c) 2009 Daniel Stenberg
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice (including the next
+ * paragraph) shall be included in all copies or substantial portions of the
+ * Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ *
+ * SPDX-License-Identifier: MIT
+ */
+
+
+#include "ares_setup.h"
+
+#include <stddef.h>
+
+#include "ares.h"
+#include "ares_data.h"
+#include "ares_private.h"
+
+/*
+** ares_free_data() - c-ares external API function.
+**
+** This function must be used by the application to free data memory that
+** has been internally allocated by some c-ares function and for which a
+** pointer has already been returned to the calling application. The list
+** of c-ares functions returning pointers that must be free'ed using this
+** function is:
+**
+** ares_get_servers()
+** ares_parse_srv_reply()
+** ares_parse_txt_reply()
+*/
+
+void ares_free_data(void *dataptr)
+{
+ while (dataptr != NULL) {
+ struct ares_data *ptr;
+ void *next_data = NULL;
+
+#ifdef __INTEL_COMPILER
+# pragma warning(push)
+# pragma warning(disable : 1684)
+ /* 1684: conversion from pointer to same-sized integral type */
+#endif
+
+ ptr = (void *)((char *)dataptr - offsetof(struct ares_data, data));
+
+#ifdef __INTEL_COMPILER
+# pragma warning(pop)
+#endif
+
+ if (ptr->mark != ARES_DATATYPE_MARK) {
+ return;
+ }
+
+ switch (ptr->type) {
+ case ARES_DATATYPE_MX_REPLY:
+ next_data = ptr->data.mx_reply.next;
+ ares_free(ptr->data.mx_reply.host);
+ break;
+
+ case ARES_DATATYPE_SRV_REPLY:
+ next_data = ptr->data.srv_reply.next;
+ ares_free(ptr->data.srv_reply.host);
+ break;
+
+ case ARES_DATATYPE_URI_REPLY:
+ next_data = ptr->data.uri_reply.next;
+ ares_free(ptr->data.uri_reply.uri);
+ break;
+
+ case ARES_DATATYPE_TXT_REPLY:
+ case ARES_DATATYPE_TXT_EXT:
+ next_data = ptr->data.txt_reply.next;
+ ares_free(ptr->data.txt_reply.txt);
+ break;
+
+ case ARES_DATATYPE_ADDR_NODE:
+ next_data = ptr->data.addr_node.next;
+ break;
+
+ case ARES_DATATYPE_ADDR_PORT_NODE:
+ next_data = ptr->data.addr_port_node.next;
+ break;
+
+ case ARES_DATATYPE_NAPTR_REPLY:
+ next_data = ptr->data.naptr_reply.next;
+ ares_free(ptr->data.naptr_reply.flags);
+ ares_free(ptr->data.naptr_reply.service);
+ ares_free(ptr->data.naptr_reply.regexp);
+ ares_free(ptr->data.naptr_reply.replacement);
+ break;
+
+ case ARES_DATATYPE_SOA_REPLY:
+ ares_free(ptr->data.soa_reply.nsname);
+ ares_free(ptr->data.soa_reply.hostmaster);
+ break;
+
+ case ARES_DATATYPE_CAA_REPLY:
+ next_data = ptr->data.caa_reply.next;
+ ares_free(ptr->data.caa_reply.property);
+ ares_free(ptr->data.caa_reply.value);
+ break;
+
+ default:
+ return;
+ }
+
+ ares_free(ptr);
+ dataptr = next_data;
+ }
+}
+
+/*
+** ares_malloc_data() - c-ares internal helper function.
+**
+** This function allocates memory for a c-ares private ares_data struct
+** for the specified ares_datatype, initializes c-ares private fields
+** and zero initializes those which later might be used from the public
+** API. It returns an interior pointer which can be passed by c-ares
+** functions to the calling application, and that must be free'ed using
+** c-ares external API function ares_free_data().
+*/
+
+void *ares_malloc_data(ares_datatype type)
+{
+ struct ares_data *ptr;
+
+ ptr = ares_malloc_zero(sizeof(*ptr));
+ if (!ptr) {
+ return NULL;
+ }
+
+ switch (type) {
+ case ARES_DATATYPE_MX_REPLY:
+ case ARES_DATATYPE_SRV_REPLY:
+ case ARES_DATATYPE_URI_REPLY:
+ case ARES_DATATYPE_TXT_EXT:
+ case ARES_DATATYPE_TXT_REPLY:
+ case ARES_DATATYPE_CAA_REPLY:
+ case ARES_DATATYPE_ADDR_NODE:
+ case ARES_DATATYPE_ADDR_PORT_NODE:
+ case ARES_DATATYPE_NAPTR_REPLY:
+ case ARES_DATATYPE_SOA_REPLY:
+ break;
+
+ default:
+ ares_free(ptr);
+ return NULL;
+ }
+
+ ptr->mark = ARES_DATATYPE_MARK;
+ ptr->type = type;
+
+ return &ptr->data;
+}
diff --git a/subprojects/c-ares/src/lib/ares_data.h b/subprojects/c-ares/src/lib/ares_data.h
@@ -0,0 +1,92 @@
+/* MIT License
+ *
+ * Copyright (c) 2009 Daniel Stenberg
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice (including the next
+ * paragraph) shall be included in all copies or substantial portions of the
+ * Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ *
+ * SPDX-License-Identifier: MIT
+ */
+#ifndef __ARES_DATA_H
+#define __ARES_DATA_H
+
+typedef enum {
+ ARES_DATATYPE_UNKNOWN = 1, /* unknown data type - introduced in 1.7.0 */
+ ARES_DATATYPE_SRV_REPLY, /* struct ares_srv_reply - introduced in 1.7.0 */
+ ARES_DATATYPE_TXT_REPLY, /* struct ares_txt_reply - introduced in 1.7.0 */
+ ARES_DATATYPE_TXT_EXT, /* struct ares_txt_ext - introduced in 1.11.0 */
+ ARES_DATATYPE_ADDR_NODE, /* struct ares_addr_node - introduced in 1.7.1 */
+ ARES_DATATYPE_MX_REPLY, /* struct ares_mx_reply - introduced in 1.7.2 */
+ ARES_DATATYPE_NAPTR_REPLY, /* struct ares_naptr_reply - introduced in 1.7.6 */
+ ARES_DATATYPE_SOA_REPLY, /* struct ares_soa_reply - introduced in 1.9.0 */
+ ARES_DATATYPE_URI_REPLY, /* struct ares_uri_reply */
+#if 0
+ ARES_DATATYPE_ADDR6TTL, /* struct ares_addrttl */
+ ARES_DATATYPE_ADDRTTL, /* struct ares_addr6ttl */
+ ARES_DATATYPE_HOSTENT, /* struct hostent */
+ ARES_DATATYPE_OPTIONS, /* struct ares_options */
+#endif
+ ARES_DATATYPE_ADDR_PORT_NODE, /* struct ares_addr_port_node - introduced
+ in 1.11.0 */
+ ARES_DATATYPE_CAA_REPLY, /* struct ares_caa_reply - introduced in 1.17 */
+ ARES_DATATYPE_LAST /* not used - introduced in 1.7.0 */
+} ares_datatype;
+
+#define ARES_DATATYPE_MARK 0xbead
+
+/*
+ * ares_data struct definition is internal to c-ares and shall not
+ * be exposed by the public API in order to allow future changes
+ * and extensions to it without breaking ABI. This will be used
+ * internally by c-ares as the container of multiple types of data
+ * dynamically allocated for which a reference will be returned
+ * to the calling application.
+ *
+ * c-ares API functions returning a pointer to c-ares internally
+ * allocated data will actually be returning an interior pointer
+ * into this ares_data struct.
+ *
+ * All this is 'invisible' to the calling application, the only
+ * requirement is that this kind of data must be free'ed by the
+ * calling application using ares_free_data() with the pointer
+ * it has received from a previous c-ares function call.
+ */
+
+struct ares_data {
+ ares_datatype type; /* Actual data type identifier. */
+ unsigned int mark; /* Private ares_data signature. */
+
+ union {
+ struct ares_txt_reply txt_reply;
+ struct ares_txt_ext txt_ext;
+ struct ares_srv_reply srv_reply;
+ struct ares_addr_node addr_node;
+ struct ares_addr_port_node addr_port_node;
+ struct ares_mx_reply mx_reply;
+ struct ares_naptr_reply naptr_reply;
+ struct ares_soa_reply soa_reply;
+ struct ares_caa_reply caa_reply;
+ struct ares_uri_reply uri_reply;
+ } data;
+};
+
+void *ares_malloc_data(ares_datatype type);
+
+
+#endif /* __ARES_DATA_H */
diff --git a/subprojects/c-ares/src/lib/ares_destroy.c b/subprojects/c-ares/src/lib/ares_destroy.c
@@ -0,0 +1,129 @@
+/* MIT License
+ *
+ * Copyright (c) 1998 Massachusetts Institute of Technology
+ * Copyright (c) 2004 Daniel Stenberg
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice (including the next
+ * paragraph) shall be included in all copies or substantial portions of the
+ * Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ *
+ * SPDX-License-Identifier: MIT
+ */
+
+#include "ares_setup.h"
+
+#include <assert.h>
+
+#include "ares.h"
+#include "ares_private.h"
+
+void ares_destroy(ares_channel_t *channel)
+{
+ size_t i;
+ ares__llist_node_t *node = NULL;
+
+ if (channel == NULL) {
+ return;
+ }
+
+ /* Lock because callbacks will be triggered */
+ ares__channel_lock(channel);
+
+ /* Destroy all queries */
+ node = ares__llist_node_first(channel->all_queries);
+ while (node != NULL) {
+ ares__llist_node_t *next = ares__llist_node_next(node);
+ struct query *query = ares__llist_node_claim(node);
+
+ query->node_all_queries = NULL;
+ query->callback(query->arg, ARES_EDESTRUCTION, 0, NULL, 0);
+ ares__free_query(query);
+
+ node = next;
+ }
+
+#ifndef NDEBUG
+ /* Freeing the query should remove it from all the lists in which it sits,
+ * so all query lists should be empty now.
+ */
+ assert(ares__llist_len(channel->all_queries) == 0);
+ assert(ares__htable_szvp_num_keys(channel->queries_by_qid) == 0);
+ assert(ares__slist_len(channel->queries_by_timeout) == 0);
+#endif
+
+ ares__destroy_servers_state(channel);
+
+#ifndef NDEBUG
+ assert(ares__htable_asvp_num_keys(channel->connnode_by_socket) == 0);
+#endif
+
+ /* No more callbacks will be triggered after this point, unlock */
+ ares__channel_unlock(channel);
+
+ if (channel->domains) {
+ for (i = 0; i < channel->ndomains; i++) {
+ ares_free(channel->domains[i]);
+ }
+ ares_free(channel->domains);
+ }
+
+ ares__llist_destroy(channel->all_queries);
+ ares__slist_destroy(channel->queries_by_timeout);
+ ares__htable_szvp_destroy(channel->queries_by_qid);
+ ares__htable_asvp_destroy(channel->connnode_by_socket);
+
+ ares_free(channel->sortlist);
+ ares_free(channel->lookups);
+ ares_free(channel->resolvconf_path);
+ ares_free(channel->hosts_path);
+ ares__destroy_rand_state(channel->rand_state);
+
+ ares__hosts_file_destroy(channel->hf);
+
+ ares__qcache_destroy(channel->qcache);
+
+ ares__channel_threading_destroy(channel);
+
+ ares_free(channel);
+}
+
+void ares__destroy_server(struct server_state *server)
+{
+ if (server == NULL) {
+ return;
+ }
+
+ ares__close_sockets(server);
+ ares__llist_destroy(server->connections);
+ ares__buf_destroy(server->tcp_parser);
+ ares__buf_destroy(server->tcp_send);
+ ares_free(server);
+}
+
+void ares__destroy_servers_state(ares_channel_t *channel)
+{
+ ares__slist_node_t *node;
+
+ while ((node = ares__slist_node_first(channel->servers)) != NULL) {
+ struct server_state *server = ares__slist_node_claim(node);
+ ares__destroy_server(server);
+ }
+
+ ares__slist_destroy(channel->servers);
+ channel->servers = NULL;
+}
diff --git a/subprojects/c-ares/src/lib/ares_dns_mapping.c b/subprojects/c-ares/src/lib/ares_dns_mapping.c
@@ -0,0 +1,885 @@
+/* MIT License
+ *
+ * Copyright (c) 2023 Brad House
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice (including the next
+ * paragraph) shall be included in all copies or substantial portions of the
+ * Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ *
+ * SPDX-License-Identifier: MIT
+ */
+#include "ares_setup.h"
+#include "ares.h"
+#include "ares_private.h"
+
+ares_bool_t ares_dns_opcode_isvalid(ares_dns_opcode_t opcode)
+{
+ switch (opcode) {
+ case ARES_OPCODE_QUERY:
+ case ARES_OPCODE_IQUERY:
+ case ARES_OPCODE_STATUS:
+ case ARES_OPCODE_NOTIFY:
+ case ARES_OPCODE_UPDATE:
+ return ARES_TRUE;
+ }
+ return ARES_FALSE;
+}
+
+ares_bool_t ares_dns_rcode_isvalid(ares_dns_rcode_t rcode)
+{
+ switch (rcode) {
+ case ARES_RCODE_NOERROR:
+ case ARES_RCODE_FORMERR:
+ case ARES_RCODE_SERVFAIL:
+ case ARES_RCODE_NXDOMAIN:
+ case ARES_RCODE_NOTIMP:
+ case ARES_RCODE_REFUSED:
+ case ARES_RCODE_YXDOMAIN:
+ case ARES_RCODE_YXRRSET:
+ case ARES_RCODE_NXRRSET:
+ case ARES_RCODE_NOTAUTH:
+ case ARES_RCODE_NOTZONE:
+ case ARES_RCODE_DSOTYPEI:
+ case ARES_RCODE_BADSIG:
+ case ARES_RCODE_BADKEY:
+ case ARES_RCODE_BADTIME:
+ case ARES_RCODE_BADMODE:
+ case ARES_RCODE_BADNAME:
+ case ARES_RCODE_BADALG:
+ case ARES_RCODE_BADTRUNC:
+ case ARES_RCODE_BADCOOKIE:
+ return ARES_TRUE;
+ }
+ return ARES_FALSE;
+}
+
+ares_bool_t ares_dns_flags_arevalid(unsigned short flags)
+{
+ unsigned short allflags = ARES_FLAG_QR | ARES_FLAG_AA | ARES_FLAG_TC |
+ ARES_FLAG_RD | ARES_FLAG_RA | ARES_FLAG_AD |
+ ARES_FLAG_CD;
+
+ if (flags & ~allflags) {
+ return ARES_FALSE;
+ }
+
+ return ARES_TRUE;
+}
+
+ares_bool_t ares_dns_rec_type_isvalid(ares_dns_rec_type_t type,
+ ares_bool_t is_query)
+{
+ switch (type) {
+ case ARES_REC_TYPE_A:
+ case ARES_REC_TYPE_NS:
+ case ARES_REC_TYPE_CNAME:
+ case ARES_REC_TYPE_SOA:
+ case ARES_REC_TYPE_PTR:
+ case ARES_REC_TYPE_HINFO:
+ case ARES_REC_TYPE_MX:
+ case ARES_REC_TYPE_TXT:
+ case ARES_REC_TYPE_AAAA:
+ case ARES_REC_TYPE_SRV:
+ case ARES_REC_TYPE_NAPTR:
+ case ARES_REC_TYPE_OPT:
+ case ARES_REC_TYPE_TLSA:
+ case ARES_REC_TYPE_SVCB:
+ case ARES_REC_TYPE_HTTPS:
+ case ARES_REC_TYPE_ANY:
+ case ARES_REC_TYPE_URI:
+ case ARES_REC_TYPE_CAA:
+ return ARES_TRUE;
+ case ARES_REC_TYPE_RAW_RR:
+ return is_query ? ARES_FALSE : ARES_TRUE;
+ default:
+ break;
+ }
+ return is_query ? ARES_TRUE : ARES_FALSE;
+}
+
+ares_bool_t ares_dns_rec_type_allow_name_compression(ares_dns_rec_type_t type)
+{
+ /* Only record types defined in RFC1035 allow name compression within the
+ * RDATA. Otherwise nameservers that don't understand an RR may not be
+ * able to pass along the RR in a proper manner */
+ switch (type) {
+ case ARES_REC_TYPE_A:
+ case ARES_REC_TYPE_NS:
+ case ARES_REC_TYPE_CNAME:
+ case ARES_REC_TYPE_SOA:
+ case ARES_REC_TYPE_PTR:
+ case ARES_REC_TYPE_HINFO:
+ case ARES_REC_TYPE_MX:
+ case ARES_REC_TYPE_TXT:
+ return ARES_TRUE;
+ default:
+ break;
+ }
+ return ARES_FALSE;
+}
+
+ares_bool_t ares_dns_class_isvalid(ares_dns_class_t qclass,
+ ares_bool_t is_query)
+{
+ switch (qclass) {
+ case ARES_CLASS_IN:
+ case ARES_CLASS_CHAOS:
+ case ARES_CLASS_HESOID:
+ case ARES_CLASS_NONE:
+ return ARES_TRUE;
+ case ARES_CLASS_ANY:
+ return is_query ? ARES_TRUE : ARES_FALSE;
+ }
+ return ARES_FALSE;
+}
+
+ares_bool_t ares_dns_section_isvalid(ares_dns_section_t sect)
+{
+ switch (sect) {
+ case ARES_SECTION_ANSWER:
+ case ARES_SECTION_AUTHORITY:
+ case ARES_SECTION_ADDITIONAL:
+ return ARES_TRUE;
+ }
+ return ARES_FALSE;
+}
+
+ares_dns_rec_type_t ares_dns_rr_key_to_rec_type(ares_dns_rr_key_t key)
+{
+ /* NOTE: due to the way we've numerated the keys, we can simply divide by
+ * 100 to get the type rather than having to do a huge switch
+ * statement. That said, we do then validate the type returned is
+ * valid in case something completely bogus is passed in */
+ ares_dns_rec_type_t type = key / 100;
+ if (!ares_dns_rec_type_isvalid(type, ARES_FALSE)) {
+ return 0;
+ }
+ return type;
+}
+
+const char *ares_dns_rec_type_tostr(ares_dns_rec_type_t type)
+{
+ switch (type) {
+ case ARES_REC_TYPE_A:
+ return "A";
+ case ARES_REC_TYPE_NS:
+ return "NS";
+ case ARES_REC_TYPE_CNAME:
+ return "CNAME";
+ case ARES_REC_TYPE_SOA:
+ return "SOA";
+ case ARES_REC_TYPE_PTR:
+ return "PTR";
+ case ARES_REC_TYPE_HINFO:
+ return "HINFO";
+ case ARES_REC_TYPE_MX:
+ return "MX";
+ case ARES_REC_TYPE_TXT:
+ return "TXT";
+ case ARES_REC_TYPE_AAAA:
+ return "AAAA";
+ case ARES_REC_TYPE_SRV:
+ return "SRV";
+ case ARES_REC_TYPE_NAPTR:
+ return "NAPTR";
+ case ARES_REC_TYPE_OPT:
+ return "OPT";
+ case ARES_REC_TYPE_TLSA:
+ return "TLSA";
+ case ARES_REC_TYPE_SVCB:
+ return "SVCB";
+ case ARES_REC_TYPE_HTTPS:
+ return "HTTPS";
+ case ARES_REC_TYPE_ANY:
+ return "ANY";
+ case ARES_REC_TYPE_URI:
+ return "URI";
+ case ARES_REC_TYPE_CAA:
+ return "CAA";
+ case ARES_REC_TYPE_RAW_RR:
+ return "RAWRR";
+ }
+ return "UNKNOWN";
+}
+
+const char *ares_dns_class_tostr(ares_dns_class_t qclass)
+{
+ switch (qclass) {
+ case ARES_CLASS_IN:
+ return "IN";
+ case ARES_CLASS_CHAOS:
+ return "CH";
+ case ARES_CLASS_HESOID:
+ return "HS";
+ case ARES_CLASS_ANY:
+ return "ANY";
+ case ARES_CLASS_NONE:
+ return "NONE";
+ }
+ return "UNKNOWN";
+}
+
+const char *ares_dns_opcode_tostr(ares_dns_opcode_t opcode)
+{
+ switch (opcode) {
+ case ARES_OPCODE_QUERY:
+ return "QUERY";
+ case ARES_OPCODE_IQUERY:
+ return "IQUERY";
+ case ARES_OPCODE_STATUS:
+ return "STATUS";
+ case ARES_OPCODE_NOTIFY:
+ return "NOTIFY";
+ case ARES_OPCODE_UPDATE:
+ return "UPDATE";
+ }
+ return "UNKNOWN";
+}
+
+const char *ares_dns_rr_key_tostr(ares_dns_rr_key_t key)
+{
+ switch (key) {
+ case ARES_RR_A_ADDR:
+ return "ADDR";
+
+ case ARES_RR_NS_NSDNAME:
+ return "NSDNAME";
+
+ case ARES_RR_CNAME_CNAME:
+ return "CNAME";
+
+ case ARES_RR_SOA_MNAME:
+ return "MNAME";
+
+ case ARES_RR_SOA_RNAME:
+ return "RNAME";
+
+ case ARES_RR_SOA_SERIAL:
+ return "SERIAL";
+
+ case ARES_RR_SOA_REFRESH:
+ return "REFRESH";
+
+ case ARES_RR_SOA_RETRY:
+ return "RETRY";
+
+ case ARES_RR_SOA_EXPIRE:
+ return "EXPIRE";
+
+ case ARES_RR_SOA_MINIMUM:
+ return "MINIMUM";
+
+ case ARES_RR_PTR_DNAME:
+ return "DNAME";
+
+ case ARES_RR_AAAA_ADDR:
+ return "ADDR";
+
+ case ARES_RR_HINFO_CPU:
+ return "CPU";
+
+ case ARES_RR_HINFO_OS:
+ return "OS";
+
+ case ARES_RR_MX_PREFERENCE:
+ return "PREFERENCE";
+
+ case ARES_RR_MX_EXCHANGE:
+ return "EXCHANGE";
+
+ case ARES_RR_TXT_DATA:
+ return "DATA";
+
+ case ARES_RR_SRV_PRIORITY:
+ return "PRIORITY";
+
+ case ARES_RR_SRV_WEIGHT:
+ return "WEIGHT";
+
+ case ARES_RR_SRV_PORT:
+ return "PORT";
+
+ case ARES_RR_SRV_TARGET:
+ return "TARGET";
+
+ case ARES_RR_NAPTR_ORDER:
+ return "ORDER";
+
+ case ARES_RR_NAPTR_PREFERENCE:
+ return "PREFERENCE";
+
+ case ARES_RR_NAPTR_FLAGS:
+ return "FLAGS";
+
+ case ARES_RR_NAPTR_SERVICES:
+ return "SERVICES";
+
+ case ARES_RR_NAPTR_REGEXP:
+ return "REGEXP";
+
+ case ARES_RR_NAPTR_REPLACEMENT:
+ return "REPLACEMENT";
+
+ case ARES_RR_OPT_UDP_SIZE:
+ return "UDP_SIZE";
+
+ case ARES_RR_OPT_VERSION:
+ return "VERSION";
+
+ case ARES_RR_OPT_FLAGS:
+ return "FLAGS";
+
+ case ARES_RR_OPT_OPTIONS:
+ return "OPTIONS";
+
+ case ARES_RR_TLSA_CERT_USAGE:
+ return "CERT_USAGE";
+
+ case ARES_RR_TLSA_SELECTOR:
+ return "SELECTOR";
+
+ case ARES_RR_TLSA_MATCH:
+ return "MATCH";
+
+ case ARES_RR_TLSA_DATA:
+ return "DATA";
+
+ case ARES_RR_SVCB_PRIORITY:
+ return "PRIORITY";
+
+ case ARES_RR_SVCB_TARGET:
+ return "TARGET";
+
+ case ARES_RR_SVCB_PARAMS:
+ return "PARAMS";
+
+ case ARES_RR_HTTPS_PRIORITY:
+ return "PRIORITY";
+
+ case ARES_RR_HTTPS_TARGET:
+ return "TARGET";
+
+ case ARES_RR_HTTPS_PARAMS:
+ return "PARAMS";
+
+ case ARES_RR_URI_PRIORITY:
+ return "PRIORITY";
+
+ case ARES_RR_URI_WEIGHT:
+ return "WEIGHT";
+
+ case ARES_RR_URI_TARGET:
+ return "TARGET";
+
+ case ARES_RR_CAA_CRITICAL:
+ return "CRITICAL";
+
+ case ARES_RR_CAA_TAG:
+ return "TAG";
+
+ case ARES_RR_CAA_VALUE:
+ return "VALUE";
+
+ case ARES_RR_RAW_RR_TYPE:
+ return "TYPE";
+
+ case ARES_RR_RAW_RR_DATA:
+ return "DATA";
+ }
+
+ return "UNKNOWN";
+}
+
+ares_dns_datatype_t ares_dns_rr_key_datatype(ares_dns_rr_key_t key)
+{
+ switch (key) {
+ case ARES_RR_A_ADDR:
+ return ARES_DATATYPE_INADDR;
+
+ case ARES_RR_AAAA_ADDR:
+ return ARES_DATATYPE_INADDR6;
+
+ case ARES_RR_NS_NSDNAME:
+ case ARES_RR_CNAME_CNAME:
+ case ARES_RR_SOA_MNAME:
+ case ARES_RR_SOA_RNAME:
+ case ARES_RR_PTR_DNAME:
+ case ARES_RR_MX_EXCHANGE:
+ case ARES_RR_SRV_TARGET:
+ case ARES_RR_SVCB_TARGET:
+ case ARES_RR_HTTPS_TARGET:
+ case ARES_RR_NAPTR_REPLACEMENT:
+ case ARES_RR_URI_TARGET:
+ return ARES_DATATYPE_NAME;
+
+ case ARES_RR_HINFO_CPU:
+ case ARES_RR_HINFO_OS:
+ case ARES_RR_NAPTR_FLAGS:
+ case ARES_RR_NAPTR_SERVICES:
+ case ARES_RR_NAPTR_REGEXP:
+ case ARES_RR_CAA_TAG:
+ return ARES_DATATYPE_STR;
+
+ case ARES_RR_SOA_SERIAL:
+ case ARES_RR_SOA_REFRESH:
+ case ARES_RR_SOA_RETRY:
+ case ARES_RR_SOA_EXPIRE:
+ case ARES_RR_SOA_MINIMUM:
+ return ARES_DATATYPE_U32;
+
+ case ARES_RR_MX_PREFERENCE:
+ case ARES_RR_SRV_PRIORITY:
+ case ARES_RR_SRV_WEIGHT:
+ case ARES_RR_SRV_PORT:
+ case ARES_RR_NAPTR_ORDER:
+ case ARES_RR_NAPTR_PREFERENCE:
+ case ARES_RR_OPT_UDP_SIZE:
+ case ARES_RR_OPT_FLAGS:
+ case ARES_RR_SVCB_PRIORITY:
+ case ARES_RR_HTTPS_PRIORITY:
+ case ARES_RR_URI_PRIORITY:
+ case ARES_RR_URI_WEIGHT:
+ case ARES_RR_RAW_RR_TYPE:
+ return ARES_DATATYPE_U16;
+
+ case ARES_RR_OPT_VERSION:
+ case ARES_RR_TLSA_CERT_USAGE:
+ case ARES_RR_TLSA_SELECTOR:
+ case ARES_RR_TLSA_MATCH:
+ case ARES_RR_CAA_CRITICAL:
+ return ARES_DATATYPE_U8;
+
+ case ARES_RR_CAA_VALUE:
+ case ARES_RR_TXT_DATA:
+ return ARES_DATATYPE_BINP;
+
+ case ARES_RR_TLSA_DATA:
+ case ARES_RR_RAW_RR_DATA:
+ return ARES_DATATYPE_BIN;
+
+ case ARES_RR_OPT_OPTIONS:
+ case ARES_RR_SVCB_PARAMS:
+ case ARES_RR_HTTPS_PARAMS:
+ return ARES_DATATYPE_OPT;
+ }
+
+ return 0;
+}
+
+static const ares_dns_rr_key_t rr_a_keys[] = { ARES_RR_A_ADDR };
+static const ares_dns_rr_key_t rr_ns_keys[] = { ARES_RR_NS_NSDNAME };
+static const ares_dns_rr_key_t rr_cname_keys[] = { ARES_RR_CNAME_CNAME };
+static const ares_dns_rr_key_t rr_soa_keys[] = {
+ ARES_RR_SOA_MNAME, ARES_RR_SOA_RNAME, ARES_RR_SOA_SERIAL,
+ ARES_RR_SOA_REFRESH, ARES_RR_SOA_RETRY, ARES_RR_SOA_EXPIRE,
+ ARES_RR_SOA_MINIMUM
+};
+static const ares_dns_rr_key_t rr_ptr_keys[] = { ARES_RR_PTR_DNAME };
+static const ares_dns_rr_key_t rr_hinfo_keys[] = { ARES_RR_HINFO_CPU,
+ ARES_RR_HINFO_OS };
+static const ares_dns_rr_key_t rr_mx_keys[] = { ARES_RR_MX_PREFERENCE,
+ ARES_RR_MX_EXCHANGE };
+static const ares_dns_rr_key_t rr_txt_keys[] = { ARES_RR_TXT_DATA };
+static const ares_dns_rr_key_t rr_aaaa_keys[] = { ARES_RR_AAAA_ADDR };
+static const ares_dns_rr_key_t rr_srv_keys[] = {
+ ARES_RR_SRV_PRIORITY, ARES_RR_SRV_WEIGHT, ARES_RR_SRV_PORT, ARES_RR_SRV_TARGET
+};
+static const ares_dns_rr_key_t rr_naptr_keys[] = {
+ ARES_RR_NAPTR_ORDER, ARES_RR_NAPTR_PREFERENCE, ARES_RR_NAPTR_FLAGS,
+ ARES_RR_NAPTR_SERVICES, ARES_RR_NAPTR_REGEXP, ARES_RR_NAPTR_REPLACEMENT
+};
+static const ares_dns_rr_key_t rr_opt_keys[] = { ARES_RR_OPT_UDP_SIZE,
+ ARES_RR_OPT_VERSION,
+ ARES_RR_OPT_FLAGS,
+ ARES_RR_OPT_OPTIONS };
+static const ares_dns_rr_key_t rr_tlsa_keys[] = { ARES_RR_TLSA_CERT_USAGE,
+ ARES_RR_TLSA_SELECTOR,
+ ARES_RR_TLSA_MATCH,
+ ARES_RR_TLSA_DATA };
+static const ares_dns_rr_key_t rr_svcb_keys[] = { ARES_RR_SVCB_PRIORITY,
+ ARES_RR_SVCB_TARGET,
+ ARES_RR_SVCB_PARAMS };
+static const ares_dns_rr_key_t rr_https_keys[] = { ARES_RR_HTTPS_PRIORITY,
+ ARES_RR_HTTPS_TARGET,
+ ARES_RR_HTTPS_PARAMS };
+static const ares_dns_rr_key_t rr_uri_keys[] = { ARES_RR_URI_PRIORITY,
+ ARES_RR_URI_WEIGHT,
+ ARES_RR_URI_TARGET };
+static const ares_dns_rr_key_t rr_caa_keys[] = { ARES_RR_CAA_CRITICAL,
+ ARES_RR_CAA_TAG,
+ ARES_RR_CAA_VALUE };
+static const ares_dns_rr_key_t rr_raw_rr_keys[] = { ARES_RR_RAW_RR_TYPE,
+ ARES_RR_RAW_RR_DATA };
+
+const ares_dns_rr_key_t *ares_dns_rr_get_keys(ares_dns_rec_type_t type,
+ size_t *cnt)
+{
+ if (cnt == NULL) {
+ return NULL;
+ }
+
+ *cnt = 0;
+
+ switch (type) {
+ case ARES_REC_TYPE_A:
+ *cnt = sizeof(rr_a_keys) / sizeof(*rr_a_keys);
+ return rr_a_keys;
+ case ARES_REC_TYPE_NS:
+ *cnt = sizeof(rr_ns_keys) / sizeof(*rr_ns_keys);
+ return rr_ns_keys;
+ case ARES_REC_TYPE_CNAME:
+ *cnt = sizeof(rr_cname_keys) / sizeof(*rr_cname_keys);
+ return rr_cname_keys;
+ case ARES_REC_TYPE_SOA:
+ *cnt = sizeof(rr_soa_keys) / sizeof(*rr_soa_keys);
+ return rr_soa_keys;
+ case ARES_REC_TYPE_PTR:
+ *cnt = sizeof(rr_ptr_keys) / sizeof(*rr_ptr_keys);
+ return rr_ptr_keys;
+ case ARES_REC_TYPE_HINFO:
+ *cnt = sizeof(rr_hinfo_keys) / sizeof(*rr_hinfo_keys);
+ return rr_hinfo_keys;
+ case ARES_REC_TYPE_MX:
+ *cnt = sizeof(rr_mx_keys) / sizeof(*rr_mx_keys);
+ return rr_mx_keys;
+ case ARES_REC_TYPE_TXT:
+ *cnt = sizeof(rr_txt_keys) / sizeof(*rr_txt_keys);
+ return rr_txt_keys;
+ case ARES_REC_TYPE_AAAA:
+ *cnt = sizeof(rr_aaaa_keys) / sizeof(*rr_aaaa_keys);
+ return rr_aaaa_keys;
+ case ARES_REC_TYPE_SRV:
+ *cnt = sizeof(rr_srv_keys) / sizeof(*rr_srv_keys);
+ return rr_srv_keys;
+ case ARES_REC_TYPE_NAPTR:
+ *cnt = sizeof(rr_naptr_keys) / sizeof(*rr_naptr_keys);
+ return rr_naptr_keys;
+ case ARES_REC_TYPE_OPT:
+ *cnt = sizeof(rr_opt_keys) / sizeof(*rr_opt_keys);
+ return rr_opt_keys;
+ case ARES_REC_TYPE_TLSA:
+ *cnt = sizeof(rr_tlsa_keys) / sizeof(*rr_tlsa_keys);
+ return rr_tlsa_keys;
+ case ARES_REC_TYPE_SVCB:
+ *cnt = sizeof(rr_svcb_keys) / sizeof(*rr_svcb_keys);
+ return rr_svcb_keys;
+ case ARES_REC_TYPE_HTTPS:
+ *cnt = sizeof(rr_https_keys) / sizeof(*rr_https_keys);
+ return rr_https_keys;
+ case ARES_REC_TYPE_ANY:
+ /* Not real */
+ break;
+ case ARES_REC_TYPE_URI:
+ *cnt = sizeof(rr_uri_keys) / sizeof(*rr_uri_keys);
+ return rr_uri_keys;
+ case ARES_REC_TYPE_CAA:
+ *cnt = sizeof(rr_caa_keys) / sizeof(*rr_caa_keys);
+ return rr_caa_keys;
+ case ARES_REC_TYPE_RAW_RR:
+ *cnt = sizeof(rr_raw_rr_keys) / sizeof(*rr_raw_rr_keys);
+ return rr_raw_rr_keys;
+ }
+
+ return NULL;
+}
+
+ares_bool_t ares_dns_class_fromstr(ares_dns_class_t *qclass, const char *str)
+{
+ size_t i;
+
+ static const struct {
+ const char *name;
+ ares_dns_class_t qclass;
+ } list[] = {
+ {"IN", ARES_CLASS_IN },
+ { "CH", ARES_CLASS_CHAOS },
+ { "HS", ARES_CLASS_HESOID},
+ { "NONE", ARES_CLASS_NONE },
+ { "ANY", ARES_CLASS_ANY },
+ { NULL, 0 }
+ };
+
+ if (qclass == NULL || str == NULL) {
+ return ARES_FALSE;
+ }
+
+ for (i = 0; list[i].name != NULL; i++) {
+ if (strcasecmp(list[i].name, str) == 0) {
+ *qclass = list[i].qclass;
+ return ARES_TRUE;
+ }
+ }
+ return ARES_FALSE;
+}
+
+ares_bool_t ares_dns_rec_type_fromstr(ares_dns_rec_type_t *qtype,
+ const char *str)
+{
+ size_t i;
+
+ static const struct {
+ const char *name;
+ ares_dns_rec_type_t type;
+ } list[] = {
+ {"A", ARES_REC_TYPE_A },
+ { "NS", ARES_REC_TYPE_NS },
+ { "CNAME", ARES_REC_TYPE_CNAME },
+ { "SOA", ARES_REC_TYPE_SOA },
+ { "PTR", ARES_REC_TYPE_PTR },
+ { "HINFO", ARES_REC_TYPE_HINFO },
+ { "MX", ARES_REC_TYPE_MX },
+ { "TXT", ARES_REC_TYPE_TXT },
+ { "AAAA", ARES_REC_TYPE_AAAA },
+ { "SRV", ARES_REC_TYPE_SRV },
+ { "NAPTR", ARES_REC_TYPE_NAPTR },
+ { "OPT", ARES_REC_TYPE_OPT },
+ { "TLSA", ARES_REC_TYPE_TLSA },
+ { "SVCB", ARES_REC_TYPE_SVCB },
+ { "HTTPS", ARES_REC_TYPE_HTTPS },
+ { "ANY", ARES_REC_TYPE_ANY },
+ { "URI", ARES_REC_TYPE_URI },
+ { "CAA", ARES_REC_TYPE_CAA },
+ { "RAW_RR", ARES_REC_TYPE_RAW_RR},
+ { NULL, 0 }
+ };
+
+ if (qtype == NULL || str == NULL) {
+ return ARES_FALSE;
+ }
+
+ for (i = 0; list[i].name != NULL; i++) {
+ if (strcasecmp(list[i].name, str) == 0) {
+ *qtype = list[i].type;
+ return ARES_TRUE;
+ }
+ }
+ return ARES_FALSE;
+}
+
+const char *ares_dns_section_tostr(ares_dns_section_t section)
+{
+ switch (section) {
+ case ARES_SECTION_ANSWER:
+ return "ANSWER";
+ case ARES_SECTION_AUTHORITY:
+ return "AUTHORITY";
+ case ARES_SECTION_ADDITIONAL:
+ return "ADDITIONAL";
+ }
+ return "UNKNOWN";
+}
+
+static ares_dns_opt_datatype_t ares_dns_opt_get_type_opt(unsigned short opt)
+{
+ ares_opt_param_t param = (ares_opt_param_t)opt;
+ switch (param) {
+ case ARES_OPT_PARAM_LLQ:
+ /* Really it is u16 version, u16 opcode, u16 error, u64 id, u32 lease */
+ return ARES_OPT_DATATYPE_BIN;
+ case ARES_OPT_PARAM_UL:
+ return ARES_OPT_DATATYPE_U32;
+ case ARES_OPT_PARAM_NSID:
+ return ARES_OPT_DATATYPE_BIN;
+ case ARES_OPT_PARAM_DAU:
+ return ARES_OPT_DATATYPE_U8_LIST;
+ case ARES_OPT_PARAM_DHU:
+ return ARES_OPT_DATATYPE_U8_LIST;
+ case ARES_OPT_PARAM_N3U:
+ return ARES_OPT_DATATYPE_U8_LIST;
+ case ARES_OPT_PARAM_EDNS_CLIENT_SUBNET:
+ /* Really it is a u16 address family, u8 source prefix length,
+ * u8 scope prefix length, address */
+ return ARES_OPT_DATATYPE_BIN;
+ case ARES_OPT_PARAM_EDNS_EXPIRE:
+ return ARES_OPT_DATATYPE_U32;
+ case ARES_OPT_PARAM_COOKIE:
+ /* 8 bytes for client, 16-40 bytes for server */
+ return ARES_OPT_DATATYPE_BIN;
+ case ARES_OPT_PARAM_EDNS_TCP_KEEPALIVE:
+ /* Timeout in 100ms intervals */
+ return ARES_OPT_DATATYPE_U16;
+ case ARES_OPT_PARAM_PADDING:
+ /* Arbitrary padding */
+ return ARES_OPT_DATATYPE_BIN;
+ case ARES_OPT_PARAM_CHAIN:
+ return ARES_OPT_DATATYPE_NAME;
+ case ARES_OPT_PARAM_EDNS_KEY_TAG:
+ return ARES_OPT_DATATYPE_U16_LIST;
+ case ARES_OPT_PARAM_EXTENDED_DNS_ERROR:
+ /* Really 16bit code followed by textual message */
+ return ARES_OPT_DATATYPE_BIN;
+ }
+ return ARES_OPT_DATATYPE_BIN;
+}
+
+static ares_dns_opt_datatype_t ares_dns_opt_get_type_svcb(unsigned short opt)
+{
+ ares_svcb_param_t param = (ares_svcb_param_t)opt;
+ switch (param) {
+ case ARES_SVCB_PARAM_NO_DEFAULT_ALPN:
+ return ARES_OPT_DATATYPE_NONE;
+ case ARES_SVCB_PARAM_ECH:
+ return ARES_OPT_DATATYPE_BIN;
+ case ARES_SVCB_PARAM_MANDATORY:
+ return ARES_OPT_DATATYPE_U16_LIST;
+ case ARES_SVCB_PARAM_ALPN:
+ return ARES_OPT_DATATYPE_STR_LIST;
+ case ARES_SVCB_PARAM_PORT:
+ return ARES_OPT_DATATYPE_U16;
+ case ARES_SVCB_PARAM_IPV4HINT:
+ return ARES_OPT_DATATYPE_INADDR4_LIST;
+ case ARES_SVCB_PARAM_IPV6HINT:
+ return ARES_OPT_DATATYPE_INADDR6_LIST;
+ }
+ return ARES_OPT_DATATYPE_BIN;
+}
+
+ares_dns_opt_datatype_t ares_dns_opt_get_datatype(ares_dns_rr_key_t key,
+ unsigned short opt)
+{
+ switch (key) {
+ case ARES_RR_OPT_OPTIONS:
+ return ares_dns_opt_get_type_opt(opt);
+ case ARES_RR_SVCB_PARAMS:
+ case ARES_RR_HTTPS_PARAMS:
+ return ares_dns_opt_get_type_svcb(opt);
+ default:
+ break;
+ }
+ return ARES_OPT_DATATYPE_BIN;
+}
+
+static const char *ares_dns_opt_get_name_opt(unsigned short opt)
+{
+ ares_opt_param_t param = (ares_opt_param_t)opt;
+ switch (param) {
+ case ARES_OPT_PARAM_LLQ:
+ return "LLQ";
+ case ARES_OPT_PARAM_UL:
+ return "UL";
+ case ARES_OPT_PARAM_NSID:
+ return "NSID";
+ case ARES_OPT_PARAM_DAU:
+ return "DAU";
+ case ARES_OPT_PARAM_DHU:
+ return "DHU";
+ case ARES_OPT_PARAM_N3U:
+ return "N3U";
+ case ARES_OPT_PARAM_EDNS_CLIENT_SUBNET:
+ return "edns-client-subnet";
+ case ARES_OPT_PARAM_EDNS_EXPIRE:
+ return "edns-expire";
+ case ARES_OPT_PARAM_COOKIE:
+ return "COOKIE";
+ case ARES_OPT_PARAM_EDNS_TCP_KEEPALIVE:
+ return "edns-tcp-keepalive";
+ case ARES_OPT_PARAM_PADDING:
+ return "Padding";
+ case ARES_OPT_PARAM_CHAIN:
+ return "CHAIN";
+ case ARES_OPT_PARAM_EDNS_KEY_TAG:
+ return "edns-key-tag";
+ case ARES_OPT_PARAM_EXTENDED_DNS_ERROR:
+ return "extended-dns-error";
+ }
+ return NULL;
+}
+
+static const char *ares_dns_opt_get_name_svcb(unsigned short opt)
+{
+ ares_svcb_param_t param = (ares_svcb_param_t)opt;
+ switch (param) {
+ case ARES_SVCB_PARAM_NO_DEFAULT_ALPN:
+ return "no-default-alpn";
+ case ARES_SVCB_PARAM_ECH:
+ return "ech";
+ case ARES_SVCB_PARAM_MANDATORY:
+ return "mandatory";
+ case ARES_SVCB_PARAM_ALPN:
+ return "alpn";
+ case ARES_SVCB_PARAM_PORT:
+ return "port";
+ case ARES_SVCB_PARAM_IPV4HINT:
+ return "ipv4hint";
+ case ARES_SVCB_PARAM_IPV6HINT:
+ return "ipv6hint";
+ }
+ return NULL;
+}
+
+const char *ares_dns_opt_get_name(ares_dns_rr_key_t key, unsigned short opt)
+{
+ switch (key) {
+ case ARES_RR_OPT_OPTIONS:
+ return ares_dns_opt_get_name_opt(opt);
+ case ARES_RR_SVCB_PARAMS:
+ case ARES_RR_HTTPS_PARAMS:
+ return ares_dns_opt_get_name_svcb(opt);
+ default:
+ break;
+ }
+ return NULL;
+}
+
+const char *ares_dns_rcode_tostr(ares_dns_rcode_t rcode)
+{
+ switch (rcode) {
+ case ARES_RCODE_NOERROR:
+ return "NOERROR";
+ case ARES_RCODE_FORMERR:
+ return "FORMERR";
+ case ARES_RCODE_SERVFAIL:
+ return "SERVFAIL";
+ case ARES_RCODE_NXDOMAIN:
+ return "NXDOMAIN";
+ case ARES_RCODE_NOTIMP:
+ return "NOTIMP";
+ case ARES_RCODE_REFUSED:
+ return "REFUSED";
+ case ARES_RCODE_YXDOMAIN:
+ return "YXDOMAIN";
+ case ARES_RCODE_YXRRSET:
+ return "YXRRSET";
+ case ARES_RCODE_NXRRSET:
+ return "NXRRSET";
+ case ARES_RCODE_NOTAUTH:
+ return "NOTAUTH";
+ case ARES_RCODE_NOTZONE:
+ return "NOTZONE";
+ case ARES_RCODE_DSOTYPEI:
+ return "DSOTYPEI";
+ case ARES_RCODE_BADSIG:
+ return "BADSIG";
+ case ARES_RCODE_BADKEY:
+ return "BADKEY";
+ case ARES_RCODE_BADTIME:
+ return "BADTIME";
+ case ARES_RCODE_BADMODE:
+ return "BADMODE";
+ case ARES_RCODE_BADNAME:
+ return "BADNAME";
+ case ARES_RCODE_BADALG:
+ return "BADALG";
+ case ARES_RCODE_BADTRUNC:
+ return "BADTRUNC";
+ case ARES_RCODE_BADCOOKIE:
+ return "BADCOOKIE";
+ }
+
+ return "UNKNOWN";
+}
diff --git a/subprojects/c-ares/src/lib/ares_dns_name.c b/subprojects/c-ares/src/lib/ares_dns_name.c
@@ -0,0 +1,676 @@
+/* MIT License
+ *
+ * Copyright (c) 2023 Brad House
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice (including the next
+ * paragraph) shall be included in all copies or substantial portions of the
+ * Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ *
+ * SPDX-License-Identifier: MIT
+ */
+#include "ares_setup.h"
+#include "ares.h"
+#include "ares_private.h"
+
+typedef struct {
+ char *name;
+ size_t name_len;
+ size_t idx;
+} ares_nameoffset_t;
+
+static void ares__nameoffset_free(void *arg)
+{
+ ares_nameoffset_t *off = arg;
+ if (off == NULL) {
+ return;
+ }
+ ares_free(off->name);
+ ares_free(off);
+}
+
+static ares_status_t ares__nameoffset_create(ares__llist_t **list,
+ const char *name, size_t idx)
+{
+ ares_status_t status;
+ ares_nameoffset_t *off = NULL;
+
+ if (list == NULL || name == NULL || ares_strlen(name) == 0 ||
+ ares_strlen(name) > 255) {
+ return ARES_EFORMERR;
+ }
+
+ if (*list == NULL) {
+ *list = ares__llist_create(ares__nameoffset_free);
+ }
+ if (*list == NULL) {
+ status = ARES_ENOMEM;
+ goto fail;
+ }
+
+ off = ares_malloc_zero(sizeof(*off));
+ if (off == NULL) {
+ return ARES_ENOMEM;
+ }
+
+ off->name = ares_strdup(name);
+ off->name_len = ares_strlen(off->name);
+ off->idx = idx;
+
+ if (ares__llist_insert_last(*list, off) == NULL) {
+ status = ARES_ENOMEM;
+ goto fail;
+ }
+
+ return ARES_SUCCESS;
+
+fail:
+ ares__nameoffset_free(off);
+ return status;
+}
+
+static const ares_nameoffset_t *ares__nameoffset_find(ares__llist_t *list,
+ const char *name)
+{
+ size_t name_len = ares_strlen(name);
+ ares__llist_node_t *node;
+ const ares_nameoffset_t *longest_match = NULL;
+
+ if (list == NULL || name == NULL || name_len == 0) {
+ return NULL;
+ }
+
+ for (node = ares__llist_node_first(list); node != NULL;
+ node = ares__llist_node_next(node)) {
+ const ares_nameoffset_t *val = ares__llist_node_val(node);
+ size_t prefix_len;
+
+ /* Can't be a match if the stored name is longer */
+ if (val->name_len > name_len) {
+ continue;
+ }
+
+ /* Can't be the longest match if our existing longest match is longer */
+ if (longest_match != NULL && longest_match->name_len > val->name_len) {
+ continue;
+ }
+
+ prefix_len = name_len - val->name_len;
+
+ if (strcasecmp(val->name, name + prefix_len) != 0) {
+ continue;
+ }
+
+ /* We need to make sure if `val->name` is "example.com" that name is
+ * is separated by a label, e.g. "myexample.com" is not ok, however
+ * "my.example.com" is, so we look for the preceding "." */
+ if (prefix_len != 0 && name[prefix_len - 1] != '.') {
+ continue;
+ }
+
+ longest_match = val;
+ }
+
+ return longest_match;
+}
+
+typedef struct {
+ ares__buf_t **label;
+ size_t num;
+} ares_dns_labels_t;
+
+static void ares_dns_labels_free(ares_dns_labels_t *labels)
+{
+ size_t i;
+
+ if (labels == NULL) {
+ return;
+ }
+
+ for (i = 0; i < labels->num; i++) {
+ ares__buf_destroy(labels->label[i]);
+ labels->label[i] = NULL;
+ }
+ ares_free(labels->label);
+ labels->label = NULL;
+ labels->num = 0;
+}
+
+static ares__buf_t *ares_dns_labels_add(ares_dns_labels_t *labels)
+{
+ void *temp;
+
+ if (labels == NULL) {
+ return NULL;
+ }
+
+ temp = ares_realloc_zero(labels->label, sizeof(*labels->label) * labels->num,
+ sizeof(*labels->label) * (labels->num + 1));
+ if (temp == NULL) {
+ return NULL;
+ }
+
+ labels->label = temp;
+
+ labels->label[labels->num] = ares__buf_create();
+ if (labels->label[labels->num] == NULL) {
+ return NULL;
+ }
+
+ labels->num++;
+ return labels->label[labels->num - 1];
+}
+
+static const ares__buf_t *
+ ares_dns_labels_get_last(const ares_dns_labels_t *labels)
+{
+ if (labels == NULL || labels->num == 0) {
+ return NULL;
+ }
+
+ return labels->label[labels->num - 1];
+}
+
+static void ares_dns_name_labels_del_last(ares_dns_labels_t *labels)
+{
+ if (labels == NULL || labels->num == 0) {
+ return;
+ }
+
+ ares__buf_destroy(labels->label[labels->num - 1]);
+ labels->label[labels->num - 1] = NULL;
+ labels->num--;
+}
+
+static ares_status_t ares_parse_dns_name_escape(ares__buf_t *namebuf,
+ ares__buf_t *label,
+ ares_bool_t validate_hostname)
+{
+ ares_status_t status;
+ unsigned char c;
+
+ status = ares__buf_fetch_bytes(namebuf, &c, 1);
+ if (status != ARES_SUCCESS) {
+ return ARES_EBADNAME;
+ }
+
+ /* If next character is a digit, read 2 more digits */
+ if (isdigit(c)) {
+ size_t i;
+ unsigned int val = 0;
+
+ val = c - '0';
+
+ for (i = 0; i < 2; i++) {
+ status = ares__buf_fetch_bytes(namebuf, &c, 1);
+ if (status != ARES_SUCCESS) {
+ return ARES_EBADNAME;
+ }
+
+ if (!isdigit(c)) {
+ return ARES_EBADNAME;
+ }
+ val *= 10;
+ val += c - '0';
+ }
+
+ /* Out of range */
+ if (val > 255) {
+ return ARES_EBADNAME;
+ }
+
+ if (validate_hostname && !ares__is_hostnamech((unsigned char)val)) {
+ return ARES_EBADNAME;
+ }
+
+ return ares__buf_append_byte(label, (unsigned char)val);
+ }
+
+ /* We can just output the character */
+ if (validate_hostname && !ares__is_hostnamech(c)) {
+ return ARES_EBADNAME;
+ }
+
+ return ares__buf_append_byte(label, c);
+}
+
+static ares_status_t ares_split_dns_name(ares_dns_labels_t *labels,
+ ares_bool_t validate_hostname,
+ const char *name)
+{
+ ares_status_t status;
+ ares__buf_t *label = NULL;
+ ares__buf_t *namebuf = NULL;
+ size_t i;
+ size_t total_len = 0;
+ unsigned char c;
+
+ if (name == NULL || labels == NULL) {
+ return ARES_EFORMERR;
+ }
+
+ /* Put name into a buffer for parsing */
+ namebuf = ares__buf_create();
+ if (namebuf == NULL) {
+ status = ARES_ENOMEM;
+ goto done;
+ }
+
+ if (*name != '\0') {
+ status =
+ ares__buf_append(namebuf, (const unsigned char *)name, ares_strlen(name));
+ if (status != ARES_SUCCESS) {
+ goto done;
+ }
+ }
+
+ /* Start with 1 label */
+ label = ares_dns_labels_add(labels);
+ if (label == NULL) {
+ status = ARES_ENOMEM;
+ goto done;
+ }
+
+ while (ares__buf_fetch_bytes(namebuf, &c, 1) == ARES_SUCCESS) {
+ /* New label */
+ if (c == '.') {
+ label = ares_dns_labels_add(labels);
+ if (label == NULL) {
+ status = ARES_ENOMEM;
+ goto done;
+ }
+ continue;
+ }
+
+ /* Escape */
+ if (c == '\\') {
+ status = ares_parse_dns_name_escape(namebuf, label, validate_hostname);
+ if (status != ARES_SUCCESS) {
+ goto done;
+ }
+ continue;
+ }
+
+ /* Output direct character */
+ if (validate_hostname && !ares__is_hostnamech(c)) {
+ status = ARES_EBADNAME;
+ goto done;
+ }
+
+ status = ares__buf_append_byte(label, c);
+ if (status != ARES_SUCCESS) {
+ goto done;
+ }
+ }
+
+ /* Remove trailing blank label */
+ if (ares__buf_len(ares_dns_labels_get_last(labels)) == 0) {
+ ares_dns_name_labels_del_last(labels);
+ }
+
+ /* If someone passed in "." there could have been 2 blank labels, check for
+ * that */
+ if (labels->num == 1 &&
+ ares__buf_len(ares_dns_labels_get_last(labels)) == 0) {
+ ares_dns_name_labels_del_last(labels);
+ }
+
+ /* Scan to make sure label lengths are valid */
+ for (i = 0; i < labels->num; i++) {
+ size_t len = ares__buf_len(labels->label[i]);
+ /* No 0-length labels, and no labels over 63 bytes */
+ if (len == 0 || len > 63) {
+ status = ARES_EBADNAME;
+ goto done;
+ }
+ total_len += len;
+ }
+
+ /* Can't exceed maximum (unescaped) length */
+ if (labels->num && total_len + labels->num - 1 > 255) {
+ status = ARES_EBADNAME;
+ goto done;
+ }
+
+ status = ARES_SUCCESS;
+
+done:
+ ares__buf_destroy(namebuf);
+ if (status != ARES_SUCCESS) {
+ ares_dns_labels_free(labels);
+ }
+ return status;
+}
+
+ares_status_t ares__dns_name_write(ares__buf_t *buf, ares__llist_t **list,
+ ares_bool_t validate_hostname,
+ const char *name)
+{
+ const ares_nameoffset_t *off = NULL;
+ size_t name_len;
+ size_t pos = ares__buf_len(buf);
+ ares_dns_labels_t labels;
+ char name_copy[512];
+ ares_status_t status;
+
+ if (buf == NULL || name == NULL) {
+ return ARES_EFORMERR;
+ }
+
+ memset(&labels, 0, sizeof(labels));
+
+ /* NOTE: due to possible escaping, name_copy buffer is > 256 to allow for
+ * this */
+ name_len = ares_strcpy(name_copy, name, sizeof(name_copy));
+
+ /* Find longest match */
+ if (list != NULL) {
+ off = ares__nameoffset_find(*list, name_copy);
+ if (off != NULL && off->name_len != name_len) {
+ /* truncate */
+ name_len -= (off->name_len + 1);
+ name_copy[name_len] = 0;
+ }
+ }
+
+ /* Output labels */
+ if (off == NULL || off->name_len != name_len) {
+ size_t i;
+
+ status = ares_split_dns_name(&labels, validate_hostname, name_copy);
+ if (status != ARES_SUCCESS) {
+ goto done;
+ }
+
+ for (i = 0; i < labels.num; i++) {
+ size_t len = 0;
+ const unsigned char *ptr = ares__buf_peek(labels.label[i], &len);
+
+ status = ares__buf_append_byte(buf, (unsigned char)(len & 0xFF));
+ if (status != ARES_SUCCESS) {
+ goto done;
+ }
+
+ status = ares__buf_append(buf, ptr, len);
+ if (status != ARES_SUCCESS) {
+ goto done;
+ }
+ }
+
+ /* If we are NOT jumping to another label, output terminator */
+ if (off == NULL) {
+ status = ares__buf_append_byte(buf, 0);
+ if (status != ARES_SUCCESS) {
+ goto done;
+ }
+ }
+ }
+
+ /* Output name compression offset jump */
+ if (off != NULL) {
+ unsigned short u16 =
+ (unsigned short)0xC000 | (unsigned short)(off->idx & 0x3FFF);
+ status = ares__buf_append_be16(buf, u16);
+ if (status != ARES_SUCCESS) {
+ goto done;
+ }
+ }
+
+ /* Store pointer for future jumps as long as its not an exact match for
+ * a prior entry */
+ if (list != NULL && (off == NULL || off->name_len != name_len) &&
+ name_len > 0) {
+ status = ares__nameoffset_create(list, name /* not truncated copy! */, pos);
+ if (status != ARES_SUCCESS) {
+ goto done;
+ }
+ }
+
+ status = ARES_SUCCESS;
+
+done:
+ ares_dns_labels_free(&labels);
+ return status;
+}
+
+/* Reserved characters for names that need to be escaped */
+static ares_bool_t is_reservedch(int ch)
+{
+ switch (ch) {
+ case '"':
+ case '.':
+ case ';':
+ case '\\':
+ case '(':
+ case ')':
+ case '@':
+ case '$':
+ return ARES_TRUE;
+ default:
+ break;
+ }
+
+ return ARES_FALSE;
+}
+
+static ares_status_t ares__fetch_dnsname_into_buf(ares__buf_t *buf,
+ ares__buf_t *dest, size_t len,
+ ares_bool_t is_hostname)
+{
+ size_t remaining_len;
+ const unsigned char *ptr = ares__buf_peek(buf, &remaining_len);
+ ares_status_t status;
+ size_t i;
+
+ if (buf == NULL || len == 0 || remaining_len < len) {
+ return ARES_EBADRESP;
+ }
+
+ for (i = 0; i < len; i++) {
+ unsigned char c = ptr[i];
+
+ /* Hostnames have a very specific allowed character set. Anything outside
+ * of that (non-printable and reserved included) are disallowed */
+ if (is_hostname && !ares__is_hostnamech(c)) {
+ status = ARES_EBADRESP;
+ goto fail;
+ }
+
+ /* NOTE: dest may be NULL if the user is trying to skip the name. validation
+ * still occurs above. */
+ if (dest == NULL) {
+ continue;
+ }
+
+ /* Non-printable characters need to be output as \DDD */
+ if (!ares__isprint(c)) {
+ unsigned char escape[4];
+
+ escape[0] = '\\';
+ escape[1] = '0' + (c / 100);
+ escape[2] = '0' + ((c % 100) / 10);
+ escape[3] = '0' + (c % 10);
+
+ status = ares__buf_append(dest, escape, sizeof(escape));
+ if (status != ARES_SUCCESS) {
+ goto fail;
+ }
+
+ continue;
+ }
+
+ /* Reserved characters need to be escaped, otherwise normal */
+ if (is_reservedch(c)) {
+ status = ares__buf_append_byte(dest, '\\');
+ if (status != ARES_SUCCESS) {
+ goto fail;
+ }
+ }
+
+ status = ares__buf_append_byte(dest, c);
+ if (status != ARES_SUCCESS) {
+ return status;
+ }
+ }
+
+ return ares__buf_consume(buf, len);
+
+fail:
+ return status;
+}
+
+ares_status_t ares__dns_name_parse(ares__buf_t *buf, char **name,
+ ares_bool_t is_hostname)
+{
+ size_t save_offset = 0;
+ unsigned char c;
+ ares_status_t status;
+ ares__buf_t *namebuf = NULL;
+ size_t label_start = ares__buf_get_position(buf);
+
+ if (buf == NULL) {
+ return ARES_EFORMERR;
+ }
+
+ if (name != NULL) {
+ namebuf = ares__buf_create();
+ if (namebuf == NULL) {
+ status = ARES_ENOMEM;
+ goto fail;
+ }
+ }
+
+ /* The compression scheme allows a domain name in a message to be
+ * represented as either:
+ *
+ * - a sequence of labels ending in a zero octet
+ * - a pointer
+ * - a sequence of labels ending with a pointer
+ */
+ while (1) {
+ /* Keep track of the minimum label starting position to prevent forward
+ * jumping */
+ if (label_start > ares__buf_get_position(buf)) {
+ label_start = ares__buf_get_position(buf);
+ }
+
+ status = ares__buf_fetch_bytes(buf, &c, 1);
+ if (status != ARES_SUCCESS) {
+ goto fail;
+ }
+
+ /* Pointer/Redirect */
+ if ((c & 0xc0) == 0xc0) {
+ /* The pointer takes the form of a two octet sequence:
+ *
+ * +--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+
+ * | 1 1| OFFSET |
+ * +--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+
+ *
+ * The first two bits are ones. This allows a pointer to be distinguished
+ * from a label, since the label must begin with two zero bits because
+ * labels are restricted to 63 octets or less. (The 10 and 01
+ * combinations are reserved for future use.) The OFFSET field specifies
+ * an offset from the start of the message (i.e., the first octet of the
+ * ID field in the domain header). A zero offset specifies the first byte
+ * of the ID field, etc.
+ */
+ size_t offset = (size_t)((c & 0x3F) << 8);
+
+ /* Fetch second byte of the redirect length */
+ status = ares__buf_fetch_bytes(buf, &c, 1);
+ if (status != ARES_SUCCESS) {
+ goto fail;
+ }
+
+ offset |= ((size_t)c);
+
+ /* According to RFC 1035 4.1.4:
+ * In this scheme, an entire domain name or a list of labels at
+ * the end of a domain name is replaced with a pointer to a prior
+ * occurrence of the same name.
+ * Note the word "prior", meaning it must go backwards. This was
+ * confirmed via the ISC BIND code that it also prevents forward
+ * pointers.
+ */
+ if (offset >= label_start) {
+ status = ARES_EBADNAME;
+ goto fail;
+ }
+
+ /* First time we make a jump, save the current position */
+ if (save_offset == 0) {
+ save_offset = ares__buf_get_position(buf);
+ }
+
+ status = ares__buf_set_position(buf, offset);
+ if (status != ARES_SUCCESS) {
+ status = ARES_EBADNAME;
+ goto fail;
+ }
+
+ continue;
+ } else if ((c & 0xc0) != 0) {
+ /* 10 and 01 are reserved */
+ status = ARES_EBADNAME;
+ goto fail;
+ } else if (c == 0) {
+ /* termination via zero octet*/
+ break;
+ }
+
+ /* New label */
+
+ /* Labels are separated by periods */
+ if (ares__buf_len(namebuf) != 0 && name != NULL) {
+ status = ares__buf_append_byte(namebuf, '.');
+ if (status != ARES_SUCCESS) {
+ goto fail;
+ }
+ }
+
+ status = ares__fetch_dnsname_into_buf(buf, namebuf, c, is_hostname);
+ if (status != ARES_SUCCESS) {
+ goto fail;
+ }
+ }
+
+ /* Restore offset read after first redirect/pointer as this is where the DNS
+ * message continues */
+ if (save_offset) {
+ ares__buf_set_position(buf, save_offset);
+ }
+
+ if (name != NULL) {
+ *name = ares__buf_finish_str(namebuf, NULL);
+ if (*name == NULL) {
+ status = ARES_ENOMEM;
+ goto fail;
+ }
+ }
+
+ return ARES_SUCCESS;
+
+fail:
+ /* We want badname response if we couldn't parse */
+ if (status == ARES_EBADRESP) {
+ status = ARES_EBADNAME;
+ }
+
+ ares__buf_destroy(namebuf);
+ return status;
+}
diff --git a/subprojects/c-ares/src/lib/ares_dns_parse.c b/subprojects/c-ares/src/lib/ares_dns_parse.c
@@ -0,0 +1,1234 @@
+/* MIT License
+ *
+ * Copyright (c) 2023 Brad House
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice (including the next
+ * paragraph) shall be included in all copies or substantial portions of the
+ * Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ *
+ * SPDX-License-Identifier: MIT
+ */
+#include "ares_setup.h"
+#include "ares.h"
+#include "ares_private.h"
+#include <limits.h>
+#ifdef HAVE_STDINT_H
+# include <stdint.h>
+#endif
+
+static size_t ares_dns_rr_remaining_len(const ares__buf_t *buf, size_t orig_len,
+ size_t rdlength)
+{
+ size_t used_len = orig_len - ares__buf_len(buf);
+ if (used_len >= rdlength) {
+ return 0;
+ }
+ return rdlength - used_len;
+}
+
+static ares_status_t ares_dns_parse_and_set_dns_name(ares__buf_t *buf,
+ ares_bool_t is_hostname,
+ ares_dns_rr_t *rr,
+ ares_dns_rr_key_t key)
+{
+ ares_status_t status;
+ char *name = NULL;
+
+ status = ares__dns_name_parse(buf, &name, is_hostname);
+ if (status != ARES_SUCCESS) {
+ return status;
+ }
+
+ status = ares_dns_rr_set_str_own(rr, key, name);
+ if (status != ARES_SUCCESS) {
+ ares_free(name);
+ return status;
+ }
+ return ARES_SUCCESS;
+}
+
+static ares_status_t ares_dns_parse_and_set_dns_str(
+ ares__buf_t *buf, size_t max_len, ares_bool_t allow_multiple,
+ ares_dns_rr_t *rr, ares_dns_rr_key_t key, ares_bool_t blank_allowed)
+{
+ ares_status_t status;
+ char *str = NULL;
+
+ status = ares__buf_parse_dns_str(buf, max_len, &str, allow_multiple);
+ if (status != ARES_SUCCESS) {
+ return status;
+ }
+
+ if (!blank_allowed && ares_strlen(str) == 0) {
+ ares_free(str);
+ return ARES_EBADRESP;
+ }
+
+ status = ares_dns_rr_set_str_own(rr, key, str);
+ if (status != ARES_SUCCESS) {
+ ares_free(str);
+ return status;
+ }
+ return ARES_SUCCESS;
+}
+
+static ares_status_t
+ ares_dns_parse_and_set_dns_binstr(ares__buf_t *buf, size_t max_len,
+ ares_bool_t allow_multiple,
+ ares_dns_rr_t *rr, ares_dns_rr_key_t key)
+{
+ ares_status_t status;
+ unsigned char *bin = NULL;
+ size_t bin_len = 0;
+
+ status =
+ ares__buf_parse_dns_binstr(buf, max_len, &bin, &bin_len, allow_multiple);
+ if (status != ARES_SUCCESS) {
+ return status;
+ }
+
+ status = ares_dns_rr_set_bin_own(rr, key, bin, bin_len);
+ if (status != ARES_SUCCESS) {
+ ares_free(bin);
+ return status;
+ }
+ return ARES_SUCCESS;
+}
+
+static ares_status_t ares_dns_parse_and_set_be32(ares__buf_t *buf,
+ ares_dns_rr_t *rr,
+ ares_dns_rr_key_t key)
+{
+ ares_status_t status;
+ unsigned int u32;
+
+ status = ares__buf_fetch_be32(buf, &u32);
+ if (status != ARES_SUCCESS) {
+ return status;
+ }
+
+ return ares_dns_rr_set_u32(rr, key, u32);
+}
+
+static ares_status_t ares_dns_parse_and_set_be16(ares__buf_t *buf,
+ ares_dns_rr_t *rr,
+ ares_dns_rr_key_t key)
+{
+ ares_status_t status;
+ unsigned short u16;
+
+ status = ares__buf_fetch_be16(buf, &u16);
+ if (status != ARES_SUCCESS) {
+ return status;
+ }
+
+ return ares_dns_rr_set_u16(rr, key, u16);
+}
+
+static ares_status_t ares_dns_parse_and_set_u8(ares__buf_t *buf,
+ ares_dns_rr_t *rr,
+ ares_dns_rr_key_t key)
+{
+ ares_status_t status;
+ unsigned char u8;
+
+ status = ares__buf_fetch_bytes(buf, &u8, 1);
+ if (status != ARES_SUCCESS) {
+ return status;
+ }
+
+ return ares_dns_rr_set_u8(rr, key, u8);
+}
+
+static ares_status_t ares_dns_parse_rr_a(ares__buf_t *buf, ares_dns_rr_t *rr,
+ size_t rdlength)
+{
+ struct in_addr addr;
+ ares_status_t status;
+
+ (void)rdlength; /* Not needed */
+
+ status = ares__buf_fetch_bytes(buf, (unsigned char *)&addr, sizeof(addr));
+ if (status != ARES_SUCCESS) {
+ return status;
+ }
+
+ return ares_dns_rr_set_addr(rr, ARES_RR_A_ADDR, &addr);
+}
+
+static ares_status_t ares_dns_parse_rr_ns(ares__buf_t *buf, ares_dns_rr_t *rr,
+ size_t rdlength)
+{
+ (void)rdlength; /* Not needed */
+
+ return ares_dns_parse_and_set_dns_name(buf, ARES_FALSE, rr,
+ ARES_RR_NS_NSDNAME);
+}
+
+static ares_status_t ares_dns_parse_rr_cname(ares__buf_t *buf,
+ ares_dns_rr_t *rr, size_t rdlength)
+{
+ (void)rdlength; /* Not needed */
+
+ return ares_dns_parse_and_set_dns_name(buf, ARES_FALSE, rr,
+ ARES_RR_CNAME_CNAME);
+}
+
+static ares_status_t ares_dns_parse_rr_soa(ares__buf_t *buf, ares_dns_rr_t *rr,
+ size_t rdlength)
+{
+ ares_status_t status;
+
+ (void)rdlength; /* Not needed */
+
+ /* MNAME */
+ status =
+ ares_dns_parse_and_set_dns_name(buf, ARES_FALSE, rr, ARES_RR_SOA_MNAME);
+ if (status != ARES_SUCCESS) {
+ return status;
+ }
+
+ /* RNAME */
+ status =
+ ares_dns_parse_and_set_dns_name(buf, ARES_FALSE, rr, ARES_RR_SOA_RNAME);
+ if (status != ARES_SUCCESS) {
+ return status;
+ }
+
+ /* SERIAL */
+ status = ares_dns_parse_and_set_be32(buf, rr, ARES_RR_SOA_SERIAL);
+ if (status != ARES_SUCCESS) {
+ return status;
+ }
+
+ /* REFRESH */
+ status = ares_dns_parse_and_set_be32(buf, rr, ARES_RR_SOA_REFRESH);
+ if (status != ARES_SUCCESS) {
+ return status;
+ }
+
+ /* RETRY */
+ status = ares_dns_parse_and_set_be32(buf, rr, ARES_RR_SOA_RETRY);
+ if (status != ARES_SUCCESS) {
+ return status;
+ }
+
+ /* EXPIRE */
+ status = ares_dns_parse_and_set_be32(buf, rr, ARES_RR_SOA_EXPIRE);
+ if (status != ARES_SUCCESS) {
+ return status;
+ }
+
+ /* MINIMUM */
+ return ares_dns_parse_and_set_be32(buf, rr, ARES_RR_SOA_MINIMUM);
+}
+
+static ares_status_t ares_dns_parse_rr_ptr(ares__buf_t *buf, ares_dns_rr_t *rr,
+ size_t rdlength)
+{
+ (void)rdlength; /* Not needed */
+
+ return ares_dns_parse_and_set_dns_name(buf, ARES_FALSE, rr,
+ ARES_RR_PTR_DNAME);
+}
+
+static ares_status_t ares_dns_parse_rr_hinfo(ares__buf_t *buf,
+ ares_dns_rr_t *rr, size_t rdlength)
+{
+ ares_status_t status;
+ size_t orig_len = ares__buf_len(buf);
+
+ (void)rdlength; /* Not needed */
+
+ /* CPU */
+ status = ares_dns_parse_and_set_dns_str(
+ buf, ares_dns_rr_remaining_len(buf, orig_len, rdlength), ARES_FALSE, rr,
+ ARES_RR_HINFO_CPU, ARES_TRUE);
+ if (status != ARES_SUCCESS) {
+ return status;
+ }
+
+ /* OS */
+ status = ares_dns_parse_and_set_dns_str(
+ buf, ares_dns_rr_remaining_len(buf, orig_len, rdlength), ARES_FALSE, rr,
+ ARES_RR_HINFO_OS, ARES_TRUE);
+
+ return status;
+}
+
+static ares_status_t ares_dns_parse_rr_mx(ares__buf_t *buf, ares_dns_rr_t *rr,
+ size_t rdlength)
+{
+ ares_status_t status;
+
+ (void)rdlength; /* Not needed */
+
+ /* PREFERENCE */
+ status = ares_dns_parse_and_set_be16(buf, rr, ARES_RR_MX_PREFERENCE);
+ if (status != ARES_SUCCESS) {
+ return status;
+ }
+
+ /* EXCHANGE */
+ return ares_dns_parse_and_set_dns_name(buf, ARES_FALSE, rr,
+ ARES_RR_MX_EXCHANGE);
+}
+
+static ares_status_t ares_dns_parse_rr_txt(ares__buf_t *buf, ares_dns_rr_t *rr,
+ size_t rdlength)
+{
+ return ares_dns_parse_and_set_dns_binstr(buf, rdlength, ARES_TRUE, rr,
+ ARES_RR_TXT_DATA);
+}
+
+static ares_status_t ares_dns_parse_rr_aaaa(ares__buf_t *buf, ares_dns_rr_t *rr,
+ size_t rdlength)
+{
+ struct ares_in6_addr addr;
+ ares_status_t status;
+
+ (void)rdlength; /* Not needed */
+
+ status = ares__buf_fetch_bytes(buf, (unsigned char *)&addr, sizeof(addr));
+ if (status != ARES_SUCCESS) {
+ return status;
+ }
+
+ return ares_dns_rr_set_addr6(rr, ARES_RR_AAAA_ADDR, &addr);
+}
+
+static ares_status_t ares_dns_parse_rr_srv(ares__buf_t *buf, ares_dns_rr_t *rr,
+ size_t rdlength)
+{
+ ares_status_t status;
+
+ (void)rdlength; /* Not needed */
+
+ /* PRIORITY */
+ status = ares_dns_parse_and_set_be16(buf, rr, ARES_RR_SRV_PRIORITY);
+ if (status != ARES_SUCCESS) {
+ return status;
+ }
+
+ /* WEIGHT */
+ status = ares_dns_parse_and_set_be16(buf, rr, ARES_RR_SRV_WEIGHT);
+ if (status != ARES_SUCCESS) {
+ return status;
+ }
+
+ /* PORT */
+ status = ares_dns_parse_and_set_be16(buf, rr, ARES_RR_SRV_PORT);
+ if (status != ARES_SUCCESS) {
+ return status;
+ }
+
+ /* TARGET */
+ return ares_dns_parse_and_set_dns_name(buf, ARES_FALSE, rr,
+ ARES_RR_SRV_TARGET);
+}
+
+static ares_status_t ares_dns_parse_rr_naptr(ares__buf_t *buf,
+ ares_dns_rr_t *rr, size_t rdlength)
+{
+ ares_status_t status;
+ size_t orig_len = ares__buf_len(buf);
+
+ /* ORDER */
+ status = ares_dns_parse_and_set_be16(buf, rr, ARES_RR_NAPTR_ORDER);
+ if (status != ARES_SUCCESS) {
+ return status;
+ }
+
+ /* PREFERENCE */
+ status = ares_dns_parse_and_set_be16(buf, rr, ARES_RR_NAPTR_PREFERENCE);
+ if (status != ARES_SUCCESS) {
+ return status;
+ }
+
+ /* FLAGS */
+ status = ares_dns_parse_and_set_dns_str(
+ buf, ares_dns_rr_remaining_len(buf, orig_len, rdlength), ARES_FALSE, rr,
+ ARES_RR_NAPTR_FLAGS, ARES_TRUE);
+ if (status != ARES_SUCCESS) {
+ return status;
+ }
+
+ /* SERVICES */
+ status = ares_dns_parse_and_set_dns_str(
+ buf, ares_dns_rr_remaining_len(buf, orig_len, rdlength), ARES_FALSE, rr,
+ ARES_RR_NAPTR_SERVICES, ARES_TRUE);
+ if (status != ARES_SUCCESS) {
+ return status;
+ }
+
+ /* REGEXP */
+ status = ares_dns_parse_and_set_dns_str(
+ buf, ares_dns_rr_remaining_len(buf, orig_len, rdlength), ARES_FALSE, rr,
+ ARES_RR_NAPTR_REGEXP, ARES_TRUE);
+ if (status != ARES_SUCCESS) {
+ return status;
+ }
+
+ /* REPLACEMENT */
+ return ares_dns_parse_and_set_dns_name(buf, ARES_FALSE, rr,
+ ARES_RR_NAPTR_REPLACEMENT);
+}
+
+static ares_status_t ares_dns_parse_rr_opt(ares__buf_t *buf, ares_dns_rr_t *rr,
+ size_t rdlength,
+ unsigned short raw_class,
+ unsigned int raw_ttl)
+{
+ ares_status_t status;
+ size_t orig_len = ares__buf_len(buf);
+ unsigned short rcode_high;
+
+ status = ares_dns_rr_set_u16(rr, ARES_RR_OPT_UDP_SIZE, raw_class);
+ if (status != ARES_SUCCESS) {
+ return status;
+ }
+
+ /* First 8 bits of TTL are an extended RCODE, and they go in the higher order
+ * after the original 4-bit rcode */
+ rcode_high = (unsigned short)((raw_ttl >> 20) & 0x0FF0);
+ rr->parent->raw_rcode |= rcode_high;
+
+ status = ares_dns_rr_set_u8(rr, ARES_RR_OPT_VERSION,
+ (unsigned char)(raw_ttl >> 16) & 0xFF);
+ if (status != ARES_SUCCESS) {
+ return status;
+ }
+
+ status = ares_dns_rr_set_u16(rr, ARES_RR_OPT_FLAGS,
+ (unsigned short)(raw_ttl & 0xFFFF));
+ if (status != ARES_SUCCESS) {
+ return status;
+ }
+
+ /* Parse options */
+ while (ares_dns_rr_remaining_len(buf, orig_len, rdlength)) {
+ unsigned short opt = 0;
+ unsigned short len = 0;
+ unsigned char *val = NULL;
+
+ /* Fetch be16 option */
+ status = ares__buf_fetch_be16(buf, &opt);
+ if (status != ARES_SUCCESS) {
+ return status;
+ }
+
+ /* Fetch be16 length */
+ status = ares__buf_fetch_be16(buf, &len);
+ if (status != ARES_SUCCESS) {
+ return status;
+ }
+
+ if (len) {
+ status = ares__buf_fetch_bytes_dup(buf, len, ARES_TRUE, &val);
+ if (status != ARES_SUCCESS) {
+ return status;
+ }
+ }
+
+ status = ares_dns_rr_set_opt_own(rr, ARES_RR_OPT_OPTIONS, opt, val, len);
+ if (status != ARES_SUCCESS) {
+ return status;
+ }
+ }
+
+ return ARES_SUCCESS;
+}
+
+static ares_status_t ares_dns_parse_rr_tlsa(ares__buf_t *buf, ares_dns_rr_t *rr,
+ size_t rdlength)
+{
+ ares_status_t status;
+ size_t orig_len = ares__buf_len(buf);
+ size_t len;
+ unsigned char *data;
+
+ status = ares_dns_parse_and_set_u8(buf, rr, ARES_RR_TLSA_CERT_USAGE);
+ if (status != ARES_SUCCESS) {
+ return status;
+ }
+
+ status = ares_dns_parse_and_set_u8(buf, rr, ARES_RR_TLSA_SELECTOR);
+ if (status != ARES_SUCCESS) {
+ return status;
+ }
+
+ status = ares_dns_parse_and_set_u8(buf, rr, ARES_RR_TLSA_MATCH);
+ if (status != ARES_SUCCESS) {
+ return status;
+ }
+
+ len = ares_dns_rr_remaining_len(buf, orig_len, rdlength);
+ if (len == 0) {
+ return ARES_EBADRESP;
+ }
+
+ status = ares__buf_fetch_bytes_dup(buf, len, ARES_FALSE, &data);
+ if (status != ARES_SUCCESS) {
+ return status;
+ }
+
+ status = ares_dns_rr_set_bin_own(rr, ARES_RR_TLSA_DATA, data, len);
+ if (status != ARES_SUCCESS) {
+ ares_free(data);
+ return status;
+ }
+
+ return ARES_SUCCESS;
+}
+
+static ares_status_t ares_dns_parse_rr_svcb(ares__buf_t *buf, ares_dns_rr_t *rr,
+ size_t rdlength)
+{
+ ares_status_t status;
+ size_t orig_len = ares__buf_len(buf);
+
+ status = ares_dns_parse_and_set_be16(buf, rr, ARES_RR_SVCB_PRIORITY);
+ if (status != ARES_SUCCESS) {
+ return status;
+ }
+
+ status =
+ ares_dns_parse_and_set_dns_name(buf, ARES_FALSE, rr, ARES_RR_SVCB_TARGET);
+ if (status != ARES_SUCCESS) {
+ return status;
+ }
+
+ /* Parse params */
+ while (ares_dns_rr_remaining_len(buf, orig_len, rdlength)) {
+ unsigned short opt = 0;
+ unsigned short len = 0;
+ unsigned char *val = NULL;
+
+ /* Fetch be16 option */
+ status = ares__buf_fetch_be16(buf, &opt);
+ if (status != ARES_SUCCESS) {
+ return status;
+ }
+
+ /* Fetch be16 length */
+ status = ares__buf_fetch_be16(buf, &len);
+ if (status != ARES_SUCCESS) {
+ return status;
+ }
+
+ if (len) {
+ status = ares__buf_fetch_bytes_dup(buf, len, ARES_TRUE, &val);
+ if (status != ARES_SUCCESS) {
+ return status;
+ }
+ }
+
+ status = ares_dns_rr_set_opt_own(rr, ARES_RR_SVCB_PARAMS, opt, val, len);
+ if (status != ARES_SUCCESS) {
+ return status;
+ }
+ }
+
+ return ARES_SUCCESS;
+}
+
+static ares_status_t ares_dns_parse_rr_https(ares__buf_t *buf,
+ ares_dns_rr_t *rr, size_t rdlength)
+{
+ ares_status_t status;
+ size_t orig_len = ares__buf_len(buf);
+
+ status = ares_dns_parse_and_set_be16(buf, rr, ARES_RR_HTTPS_PRIORITY);
+ if (status != ARES_SUCCESS) {
+ return status;
+ }
+
+ status =
+ ares_dns_parse_and_set_dns_name(buf, ARES_FALSE, rr, ARES_RR_HTTPS_TARGET);
+ if (status != ARES_SUCCESS) {
+ return status;
+ }
+
+ /* Parse params */
+ while (ares_dns_rr_remaining_len(buf, orig_len, rdlength)) {
+ unsigned short opt = 0;
+ unsigned short len = 0;
+ unsigned char *val = NULL;
+
+ /* Fetch be16 option */
+ status = ares__buf_fetch_be16(buf, &opt);
+ if (status != ARES_SUCCESS) {
+ return status;
+ }
+
+ /* Fetch be16 length */
+ status = ares__buf_fetch_be16(buf, &len);
+ if (status != ARES_SUCCESS) {
+ return status;
+ }
+
+ if (len) {
+ status = ares__buf_fetch_bytes_dup(buf, len, ARES_TRUE, &val);
+ if (status != ARES_SUCCESS) {
+ return status;
+ }
+ }
+
+ status = ares_dns_rr_set_opt_own(rr, ARES_RR_HTTPS_PARAMS, opt, val, len);
+ if (status != ARES_SUCCESS) {
+ return status;
+ }
+ }
+
+ return ARES_SUCCESS;
+}
+
+static ares_status_t ares_dns_parse_rr_uri(ares__buf_t *buf, ares_dns_rr_t *rr,
+ size_t rdlength)
+{
+ char *name = NULL;
+ ares_status_t status;
+ size_t orig_len = ares__buf_len(buf);
+ size_t remaining_len;
+
+ /* PRIORITY */
+ status = ares_dns_parse_and_set_be16(buf, rr, ARES_RR_URI_PRIORITY);
+ if (status != ARES_SUCCESS) {
+ return status;
+ }
+
+ /* WEIGHT */
+ status = ares_dns_parse_and_set_be16(buf, rr, ARES_RR_URI_WEIGHT);
+ if (status != ARES_SUCCESS) {
+ return status;
+ }
+
+ /* TARGET -- not in string format, rest of buffer, required to be
+ * non-zero length */
+ remaining_len = ares_dns_rr_remaining_len(buf, orig_len, rdlength);
+ if (remaining_len == 0) {
+ status = ARES_EBADRESP;
+ return status;
+ }
+
+ /* NOTE: Not in DNS string format */
+ status = ares__buf_fetch_str_dup(buf, remaining_len, &name);
+ if (status != ARES_SUCCESS) {
+ return status;
+ }
+
+ status = ares_dns_rr_set_str_own(rr, ARES_RR_URI_TARGET, name);
+ if (status != ARES_SUCCESS) {
+ ares_free(name);
+ return status;
+ }
+ name = NULL;
+
+ return ARES_SUCCESS;
+}
+
+static ares_status_t ares_dns_parse_rr_caa(ares__buf_t *buf, ares_dns_rr_t *rr,
+ size_t rdlength)
+{
+ unsigned char *data = NULL;
+ size_t data_len = 0;
+ ares_status_t status;
+ size_t orig_len = ares__buf_len(buf);
+
+ /* CRITICAL */
+ status = ares_dns_parse_and_set_u8(buf, rr, ARES_RR_CAA_CRITICAL);
+ if (status != ARES_SUCCESS) {
+ return status;
+ }
+
+ /* Tag */
+ status = ares_dns_parse_and_set_dns_str(
+ buf, ares_dns_rr_remaining_len(buf, orig_len, rdlength), ARES_FALSE, rr,
+ ARES_RR_CAA_TAG, ARES_FALSE);
+ if (status != ARES_SUCCESS) {
+ return status;
+ }
+
+ /* Value - binary! (remaining buffer */
+ data_len = ares_dns_rr_remaining_len(buf, orig_len, rdlength);
+ if (data_len == 0) {
+ status = ARES_EBADRESP;
+ return status;
+ }
+ status = ares__buf_fetch_bytes_dup(buf, data_len, ARES_TRUE, &data);
+ if (status != ARES_SUCCESS) {
+ return status;
+ }
+
+ status = ares_dns_rr_set_bin_own(rr, ARES_RR_CAA_VALUE, data, data_len);
+ if (status != ARES_SUCCESS) {
+ ares_free(data);
+ return status;
+ }
+ data = NULL;
+
+ return ARES_SUCCESS;
+}
+
+static ares_status_t ares_dns_parse_rr_raw_rr(ares__buf_t *buf,
+ ares_dns_rr_t *rr,
+ size_t rdlength,
+ unsigned short raw_type)
+{
+ ares_status_t status;
+ unsigned char *bytes = NULL;
+
+ if (rdlength == 0) {
+ return ARES_SUCCESS;
+ }
+
+ status = ares__buf_fetch_bytes_dup(buf, rdlength, ARES_FALSE, &bytes);
+ if (status != ARES_SUCCESS) {
+ return status;
+ }
+
+ /* Can't fail */
+ status = ares_dns_rr_set_u16(rr, ARES_RR_RAW_RR_TYPE, raw_type);
+ if (status != ARES_SUCCESS) {
+ ares_free(bytes);
+ return status;
+ }
+
+ status = ares_dns_rr_set_bin_own(rr, ARES_RR_RAW_RR_DATA, bytes, rdlength);
+ if (status != ARES_SUCCESS) {
+ ares_free(bytes);
+ return status;
+ }
+
+ return ARES_SUCCESS;
+}
+
+static ares_status_t ares_dns_parse_header(ares__buf_t *buf, unsigned int flags,
+ ares_dns_record_t **dnsrec,
+ unsigned short *qdcount,
+ unsigned short *ancount,
+ unsigned short *nscount,
+ unsigned short *arcount)
+{
+ ares_status_t status = ARES_EBADRESP;
+ unsigned short u16;
+ unsigned short id;
+ unsigned short dns_flags = 0;
+ ares_dns_opcode_t opcode;
+ unsigned short rcode;
+
+ (void)flags; /* currently unused */
+
+ if (buf == NULL || dnsrec == NULL || qdcount == NULL || ancount == NULL ||
+ nscount == NULL || arcount == NULL) {
+ return ARES_EFORMERR;
+ }
+
+ *dnsrec = NULL;
+
+ /*
+ * RFC 1035 4.1.1. Header section format.
+ * and Updated by RFC 2065 to add AD and CD bits.
+ * 1 1 1 1 1 1
+ * 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5
+ * +--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+
+ * | ID |
+ * +--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+
+ * |QR| Opcode |AA|TC|RD|RA| Z|AD|CD| RCODE |
+ * +--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+
+ * | QDCOUNT |
+ * +--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+
+ * | ANCOUNT |
+ * +--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+
+ * | NSCOUNT |
+ * +--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+
+ * | ARCOUNT |
+ * +--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+
+ */
+
+ /* ID */
+ status = ares__buf_fetch_be16(buf, &id);
+ if (status != ARES_SUCCESS) {
+ goto fail;
+ }
+
+ /* Flags */
+ status = ares__buf_fetch_be16(buf, &u16);
+ if (status != ARES_SUCCESS) {
+ goto fail;
+ }
+
+ /* QR */
+ if (u16 & 0x8000) {
+ dns_flags |= ARES_FLAG_QR;
+ }
+
+ /* OPCODE */
+ opcode = (u16 >> 11) & 0xf;
+
+ /* AA */
+ if (u16 & 0x400) {
+ dns_flags |= ARES_FLAG_AA;
+ }
+
+ /* TC */
+ if (u16 & 0x200) {
+ dns_flags |= ARES_FLAG_TC;
+ }
+
+ /* RD */
+ if (u16 & 0x100) {
+ dns_flags |= ARES_FLAG_RD;
+ }
+
+ /* RA */
+ if (u16 & 0x80) {
+ dns_flags |= ARES_FLAG_RA;
+ }
+
+ /* Z -- unused */
+
+ /* AD */
+ if (u16 & 0x20) {
+ dns_flags |= ARES_FLAG_AD;
+ }
+
+ /* CD */
+ if (u16 & 0x10) {
+ dns_flags |= ARES_FLAG_CD;
+ }
+
+ /* RCODE */
+ rcode = u16 & 0xf;
+
+ /* QDCOUNT */
+ status = ares__buf_fetch_be16(buf, qdcount);
+ if (status != ARES_SUCCESS) {
+ goto fail;
+ }
+
+ /* ANCOUNT */
+ status = ares__buf_fetch_be16(buf, ancount);
+ if (status != ARES_SUCCESS) {
+ goto fail;
+ }
+
+ /* NSCOUNT */
+ status = ares__buf_fetch_be16(buf, nscount);
+ if (status != ARES_SUCCESS) {
+ goto fail;
+ }
+
+ /* ARCOUNT */
+ status = ares__buf_fetch_be16(buf, arcount);
+ if (status != ARES_SUCCESS) {
+ goto fail;
+ }
+
+ status = ares_dns_record_create(dnsrec, id, dns_flags, opcode,
+ ARES_RCODE_NOERROR /* Temporary */);
+ if (status != ARES_SUCCESS) {
+ goto fail;
+ }
+
+ (*dnsrec)->raw_rcode = rcode;
+
+ if (*ancount > 0) {
+ status =
+ ares_dns_record_rr_prealloc(*dnsrec, ARES_SECTION_ANSWER, *ancount);
+ if (status != ARES_SUCCESS) {
+ goto fail;
+ }
+ }
+
+ if (*nscount > 0) {
+ status =
+ ares_dns_record_rr_prealloc(*dnsrec, ARES_SECTION_AUTHORITY, *nscount);
+ if (status != ARES_SUCCESS) {
+ goto fail;
+ }
+ }
+
+ if (*arcount > 0) {
+ status =
+ ares_dns_record_rr_prealloc(*dnsrec, ARES_SECTION_ADDITIONAL, *arcount);
+ if (status != ARES_SUCCESS) {
+ goto fail;
+ }
+ }
+
+ return ARES_SUCCESS;
+
+fail:
+ ares_dns_record_destroy(*dnsrec);
+ *dnsrec = NULL;
+ *qdcount = 0;
+ *ancount = 0;
+ *nscount = 0;
+ *arcount = 0;
+
+ return status;
+}
+
+static ares_status_t
+ ares_dns_parse_rr_data(ares__buf_t *buf, size_t rdlength, ares_dns_rr_t *rr,
+ ares_dns_rec_type_t type, unsigned short raw_type,
+ unsigned short raw_class, unsigned int raw_ttl)
+{
+ switch (type) {
+ case ARES_REC_TYPE_A:
+ return ares_dns_parse_rr_a(buf, rr, rdlength);
+ case ARES_REC_TYPE_NS:
+ return ares_dns_parse_rr_ns(buf, rr, rdlength);
+ case ARES_REC_TYPE_CNAME:
+ return ares_dns_parse_rr_cname(buf, rr, rdlength);
+ case ARES_REC_TYPE_SOA:
+ return ares_dns_parse_rr_soa(buf, rr, rdlength);
+ case ARES_REC_TYPE_PTR:
+ return ares_dns_parse_rr_ptr(buf, rr, rdlength);
+ case ARES_REC_TYPE_HINFO:
+ return ares_dns_parse_rr_hinfo(buf, rr, rdlength);
+ case ARES_REC_TYPE_MX:
+ return ares_dns_parse_rr_mx(buf, rr, rdlength);
+ case ARES_REC_TYPE_TXT:
+ return ares_dns_parse_rr_txt(buf, rr, rdlength);
+ case ARES_REC_TYPE_AAAA:
+ return ares_dns_parse_rr_aaaa(buf, rr, rdlength);
+ case ARES_REC_TYPE_SRV:
+ return ares_dns_parse_rr_srv(buf, rr, rdlength);
+ case ARES_REC_TYPE_NAPTR:
+ return ares_dns_parse_rr_naptr(buf, rr, rdlength);
+ case ARES_REC_TYPE_ANY:
+ return ARES_EBADRESP;
+ case ARES_REC_TYPE_OPT:
+ return ares_dns_parse_rr_opt(buf, rr, rdlength, raw_class, raw_ttl);
+ case ARES_REC_TYPE_TLSA:
+ return ares_dns_parse_rr_tlsa(buf, rr, rdlength);
+ case ARES_REC_TYPE_SVCB:
+ return ares_dns_parse_rr_svcb(buf, rr, rdlength);
+ case ARES_REC_TYPE_HTTPS:
+ return ares_dns_parse_rr_https(buf, rr, rdlength);
+ case ARES_REC_TYPE_URI:
+ return ares_dns_parse_rr_uri(buf, rr, rdlength);
+ case ARES_REC_TYPE_CAA:
+ return ares_dns_parse_rr_caa(buf, rr, rdlength);
+ case ARES_REC_TYPE_RAW_RR:
+ return ares_dns_parse_rr_raw_rr(buf, rr, rdlength, raw_type);
+ }
+ return ARES_EFORMERR;
+}
+
+static ares_status_t ares_dns_parse_qd(ares__buf_t *buf,
+ ares_dns_record_t *dnsrec)
+{
+ char *name = NULL;
+ unsigned short u16;
+ ares_status_t status;
+ ares_dns_rec_type_t type;
+ ares_dns_class_t qclass;
+ /* The question section is used to carry the "question" in most queries,
+ * i.e., the parameters that define what is being asked. The section
+ * contains QDCOUNT (usually 1) entries, each of the following format:
+ * 1 1 1 1 1 1
+ * 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5
+ * +--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+
+ * | |
+ * / QNAME /
+ * / /
+ * +--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+
+ * | QTYPE |
+ * +--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+
+ * | QCLASS |
+ * +--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+
+ */
+
+ /* Name */
+ status = ares__dns_name_parse(buf, &name, ARES_FALSE);
+ if (status != ARES_SUCCESS) {
+ goto done;
+ }
+
+ /* Type */
+ status = ares__buf_fetch_be16(buf, &u16);
+ if (status != ARES_SUCCESS) {
+ goto done;
+ }
+ type = u16;
+
+ /* Class */
+ status = ares__buf_fetch_be16(buf, &u16);
+ if (status != ARES_SUCCESS) {
+ goto done;
+ }
+ qclass = u16;
+
+ /* Add question */
+ status = ares_dns_record_query_add(dnsrec, name, type, qclass);
+ if (status != ARES_SUCCESS) {
+ goto done;
+ }
+
+done:
+ ares_free(name);
+ return status;
+}
+
+static ares_status_t ares_dns_parse_rr(ares__buf_t *buf, unsigned int flags,
+ ares_dns_section_t sect,
+ ares_dns_record_t *dnsrec)
+{
+ char *name = NULL;
+ unsigned short u16;
+ unsigned short raw_type;
+ ares_status_t status;
+ ares_dns_rec_type_t type;
+ ares_dns_class_t qclass;
+ unsigned int ttl;
+ size_t rdlength;
+ ares_dns_rr_t *rr = NULL;
+ size_t remaining_len = 0;
+ size_t processed_len = 0;
+
+ (void)flags; /* currently unused */
+
+ /* All RRs have the same top level format shown below:
+ * 1 1 1 1 1 1
+ * 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5
+ * +--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+
+ * | |
+ * / /
+ * / NAME /
+ * | |
+ * +--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+
+ * | TYPE |
+ * +--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+
+ * | CLASS |
+ * +--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+
+ * | TTL |
+ * | |
+ * +--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+
+ * | RDLENGTH |
+ * +--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+--|
+ * / RDATA /
+ * / /
+ * +--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+--+
+ */
+
+ /* Name */
+ status = ares__dns_name_parse(buf, &name, ARES_FALSE);
+ if (status != ARES_SUCCESS) {
+ goto done;
+ }
+
+ /* Type */
+ status = ares__buf_fetch_be16(buf, &u16);
+ if (status != ARES_SUCCESS) {
+ goto done;
+ }
+ type = u16;
+ raw_type = u16; /* Only used for raw rr data */
+
+ /* Class */
+ status = ares__buf_fetch_be16(buf, &u16);
+ if (status != ARES_SUCCESS) {
+ goto done;
+ }
+ qclass = u16;
+
+ /* TTL */
+ status = ares__buf_fetch_be32(buf, &ttl);
+ if (status != ARES_SUCCESS) {
+ goto done;
+ }
+
+ /* Length */
+ status = ares__buf_fetch_be16(buf, &u16);
+ if (status != ARES_SUCCESS) {
+ goto done;
+ }
+ rdlength = u16;
+
+ if (!ares_dns_rec_type_isvalid(type, ARES_FALSE)) {
+ type = ARES_REC_TYPE_RAW_RR;
+ }
+
+ /* Pull into another buffer for safety */
+ if (rdlength > ares__buf_len(buf)) {
+ status = ARES_EBADRESP;
+ goto done;
+ }
+
+ /* Add the base rr */
+ status =
+ ares_dns_record_rr_add(&rr, dnsrec, sect, name, type,
+ type == ARES_REC_TYPE_OPT ? ARES_CLASS_IN : qclass,
+ type == ARES_REC_TYPE_OPT ? 0 : ttl);
+ if (status != ARES_SUCCESS) {
+ goto done;
+ }
+
+ /* Record the current remaining length in the buffer so we can tell how
+ * much was processed */
+ remaining_len = ares__buf_len(buf);
+
+ /* Fill in the data for the rr */
+ status = ares_dns_parse_rr_data(buf, rdlength, rr, type, raw_type,
+ (unsigned short)qclass, ttl);
+ if (status != ARES_SUCCESS) {
+ goto done;
+ }
+
+ /* Determine how many bytes were processed */
+ processed_len = remaining_len - ares__buf_len(buf);
+
+ /* If too many bytes were processed, error! */
+ if (processed_len > rdlength) {
+ status = ARES_EBADRESP;
+ goto done;
+ }
+
+ /* If too few bytes were processed, consume the unprocessed data for this
+ * record as the parser may not have wanted/needed to use it */
+ if (processed_len < rdlength) {
+ ares__buf_consume(buf, rdlength - processed_len);
+ }
+
+
+done:
+ ares_free(name);
+ return status;
+}
+
+static ares_status_t ares_dns_parse_buf(ares__buf_t *buf, unsigned int flags,
+ ares_dns_record_t **dnsrec)
+{
+ ares_status_t status;
+ unsigned short qdcount;
+ unsigned short ancount;
+ unsigned short nscount;
+ unsigned short arcount;
+ unsigned short i;
+
+ if (buf == NULL || dnsrec == NULL) {
+ return ARES_EFORMERR;
+ }
+
+ /* All communications inside of the domain protocol are carried in a single
+ * format called a message. The top level format of message is divided
+ * into 5 sections (some of which are empty in certain cases) shown below:
+ *
+ * +---------------------+
+ * | Header |
+ * +---------------------+
+ * | Question | the question for the name server
+ * +---------------------+
+ * | Answer | RRs answering the question
+ * +---------------------+
+ * | Authority | RRs pointing toward an authority
+ * +---------------------+
+ * | Additional | RRs holding additional information
+ * +---------------------+
+ */
+
+ /* Parse header */
+ status = ares_dns_parse_header(buf, flags, dnsrec, &qdcount, &ancount,
+ &nscount, &arcount);
+ if (status != ARES_SUCCESS) {
+ goto fail;
+ }
+
+ /* Must have questions */
+ if (qdcount == 0) {
+ status = ARES_EBADRESP;
+ goto fail;
+ }
+
+ /* XXX: this should be controlled by a flag in case we want to allow
+ * multiple questions. I think mDNS allows this */
+ if (qdcount > 1) {
+ status = ARES_EBADRESP;
+ goto fail;
+ }
+
+ /* Parse questions */
+ for (i = 0; i < qdcount; i++) {
+ status = ares_dns_parse_qd(buf, *dnsrec);
+ if (status != ARES_SUCCESS) {
+ goto fail;
+ }
+ }
+
+ /* Parse Answers */
+ for (i = 0; i < ancount; i++) {
+ status = ares_dns_parse_rr(buf, flags, ARES_SECTION_ANSWER, *dnsrec);
+ if (status != ARES_SUCCESS) {
+ goto fail;
+ }
+ }
+
+ /* Parse Authority */
+ for (i = 0; i < nscount; i++) {
+ status = ares_dns_parse_rr(buf, flags, ARES_SECTION_AUTHORITY, *dnsrec);
+ if (status != ARES_SUCCESS) {
+ goto fail;
+ }
+ }
+
+ /* Parse Additional */
+ for (i = 0; i < arcount; i++) {
+ status = ares_dns_parse_rr(buf, flags, ARES_SECTION_ADDITIONAL, *dnsrec);
+ if (status != ARES_SUCCESS) {
+ goto fail;
+ }
+ }
+
+ /* Finalize rcode now that if we have OPT it is processed */
+ if (!ares_dns_rcode_isvalid((*dnsrec)->raw_rcode)) {
+ (*dnsrec)->rcode = ARES_RCODE_SERVFAIL;
+ } else {
+ (*dnsrec)->rcode = (ares_dns_rcode_t)(*dnsrec)->raw_rcode;
+ }
+
+ return ARES_SUCCESS;
+
+fail:
+ ares_dns_record_destroy(*dnsrec);
+ *dnsrec = NULL;
+ return status;
+}
+
+ares_status_t ares_dns_parse(const unsigned char *buf, size_t buf_len,
+ unsigned int flags, ares_dns_record_t **dnsrec)
+{
+ ares__buf_t *parser = NULL;
+ ares_status_t status;
+
+ if (buf == NULL || buf_len == 0 || dnsrec == NULL) {
+ return ARES_EFORMERR;
+ }
+
+ parser = ares__buf_create_const(buf, buf_len);
+ if (parser == NULL) {
+ return ARES_ENOMEM;
+ }
+
+ status = ares_dns_parse_buf(parser, flags, dnsrec);
+ ares__buf_destroy(parser);
+
+ return status;
+}
diff --git a/subprojects/c-ares/src/lib/ares_dns_private.h b/subprojects/c-ares/src/lib/ares_dns_private.h
@@ -0,0 +1,236 @@
+/* MIT License
+ *
+ * Copyright (c) 2023 Brad House
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice (including the next
+ * paragraph) shall be included in all copies or substantial portions of the
+ * Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ *
+ * SPDX-License-Identifier: MIT
+ */
+#ifndef __ARES_DNS_PRIVATE_H
+#define __ARES_DNS_PRIVATE_H
+
+ares_bool_t ares_dns_rec_type_allow_name_compression(ares_dns_rec_type_t type);
+ares_bool_t ares_dns_opcode_isvalid(ares_dns_opcode_t opcode);
+ares_bool_t ares_dns_rcode_isvalid(ares_dns_rcode_t rcode);
+ares_bool_t ares_dns_flags_arevalid(unsigned short flags);
+ares_bool_t ares_dns_rec_type_isvalid(ares_dns_rec_type_t type,
+ ares_bool_t is_query);
+ares_bool_t ares_dns_class_isvalid(ares_dns_class_t qclass,
+ ares_bool_t is_query);
+ares_bool_t ares_dns_section_isvalid(ares_dns_section_t sect);
+ares_status_t ares_dns_rr_set_str_own(ares_dns_rr_t *dns_rr,
+ ares_dns_rr_key_t key, char *val);
+ares_status_t ares_dns_rr_set_bin_own(ares_dns_rr_t *dns_rr,
+ ares_dns_rr_key_t key, unsigned char *val,
+ size_t len);
+ares_status_t ares_dns_rr_set_opt_own(ares_dns_rr_t *dns_rr,
+ ares_dns_rr_key_t key, unsigned short opt,
+ unsigned char *val, size_t val_len);
+ares_status_t ares_dns_record_rr_prealloc(ares_dns_record_t *dnsrec,
+ ares_dns_section_t sect, size_t cnt);
+ares_bool_t ares_dns_has_opt_rr(const ares_dns_record_t *rec);
+void ares_dns_record_write_ttl_decrement(ares_dns_record_t *dnsrec,
+ unsigned int ttl_decrement);
+
+struct ares_dns_qd {
+ char *name;
+ ares_dns_rec_type_t qtype;
+ ares_dns_class_t qclass;
+};
+
+typedef struct {
+ struct in_addr addr;
+} ares__dns_a_t;
+
+typedef struct {
+ char *nsdname;
+} ares__dns_ns_t;
+
+typedef struct {
+ char *cname;
+} ares__dns_cname_t;
+
+typedef struct {
+ char *mname;
+ char *rname;
+ unsigned int serial;
+ unsigned int refresh;
+ unsigned int retry;
+ unsigned int expire;
+ unsigned int minimum;
+} ares__dns_soa_t;
+
+typedef struct {
+ char *dname;
+} ares__dns_ptr_t;
+
+typedef struct {
+ char *cpu;
+ char *os;
+} ares__dns_hinfo_t;
+
+typedef struct {
+ unsigned short preference;
+ char *exchange;
+} ares__dns_mx_t;
+
+typedef struct {
+ char *data;
+ size_t data_len;
+} ares__dns_txt_t;
+
+typedef struct {
+ struct ares_in6_addr addr;
+} ares__dns_aaaa_t;
+
+typedef struct {
+ unsigned short priority;
+ unsigned short weight;
+ unsigned short port;
+ char *target;
+} ares__dns_srv_t;
+
+typedef struct {
+ unsigned short order;
+ unsigned short preference;
+ char *flags;
+ char *services;
+ char *regexp;
+ char *replacement;
+} ares__dns_naptr_t;
+
+typedef struct {
+ unsigned short opt;
+ unsigned char *val;
+ size_t val_len;
+} ares__dns_optval_t;
+
+typedef struct {
+ ares__dns_optval_t *optval; /*!< Attribute/value pairs */
+ size_t cnt; /*!< Count of Attribute/Value pairs */
+ size_t alloc; /*!< Allocated count of attribute/value
+ * pairs */
+} ares__dns_options_t;
+
+typedef struct {
+ unsigned short udp_size; /*!< taken from class */
+ unsigned char version; /*!< taken from bits 8-16 of ttl */
+ unsigned short flags; /*!< Flags, remaining 16 bits, though only
+ * 1 currently defined */
+ ares__dns_options_t *options; /*!< Attribute/Value pairs */
+} ares__dns_opt_t;
+
+typedef struct {
+ unsigned char cert_usage;
+ unsigned char selector;
+ unsigned char match;
+ unsigned char *data;
+ size_t data_len;
+} ares__dns_tlsa_t;
+
+typedef struct {
+ unsigned short priority;
+ char *target;
+ ares__dns_options_t *params;
+} ares__dns_svcb_t;
+
+typedef struct {
+ unsigned short priority;
+ unsigned short weight;
+ char *target;
+} ares__dns_uri_t;
+
+typedef struct {
+ unsigned char critical;
+ char *tag;
+ unsigned char *value;
+ size_t value_len;
+} ares__dns_caa_t;
+
+/*! Raw, unparsed RR data */
+typedef struct {
+ unsigned short type; /*!< Not ares_rec_type_t because it likely isn't one
+ * of those values since it wasn't parsed */
+ unsigned char *data; /*!< Raw RR data */
+ size_t length; /*!< Length of raw RR data */
+} ares__dns_raw_rr_t;
+
+/*! DNS RR data structure */
+struct ares_dns_rr {
+ ares_dns_record_t *parent;
+ char *name;
+ ares_dns_rec_type_t type;
+ ares_dns_class_t rclass;
+ unsigned int ttl;
+
+ union {
+ ares__dns_a_t a;
+ ares__dns_ns_t ns;
+ ares__dns_cname_t cname;
+ ares__dns_soa_t soa;
+ ares__dns_ptr_t ptr;
+ ares__dns_hinfo_t hinfo;
+ ares__dns_mx_t mx;
+ ares__dns_txt_t txt;
+ ares__dns_aaaa_t aaaa;
+ ares__dns_srv_t srv;
+ ares__dns_naptr_t naptr;
+ ares__dns_opt_t opt;
+ ares__dns_tlsa_t tlsa;
+ ares__dns_svcb_t svcb;
+ ares__dns_svcb_t https; /*!< https is a type of svcb, so this is right */
+ ares__dns_uri_t uri;
+ ares__dns_caa_t caa;
+ ares__dns_raw_rr_t raw_rr;
+ } r;
+};
+
+/*! DNS data structure */
+struct ares_dns_record {
+ unsigned short id; /*!< DNS query id */
+ unsigned short flags; /*!< One or more ares_dns_flags_t */
+ ares_dns_opcode_t opcode; /*!< DNS Opcode */
+ ares_dns_rcode_t rcode; /*!< DNS RCODE */
+ unsigned short raw_rcode; /*!< Raw rcode, used to ultimately form real
+ * rcode after reading OPT record if it
+ * exists */
+ unsigned int ttl_decrement; /*!< Special case to apply to writing out
+ * this record, where it will decrement
+ * the ttl of any resource records by
+ * this amount. Used for cache */
+
+ ares_dns_qd_t *qd;
+ size_t qdcount;
+ size_t qdalloc;
+
+ ares_dns_rr_t *an;
+ size_t ancount;
+ size_t analloc;
+
+ ares_dns_rr_t *ns;
+ size_t nscount;
+ size_t nsalloc;
+
+ ares_dns_rr_t *ar;
+ size_t arcount;
+ size_t aralloc;
+};
+
+#endif
diff --git a/subprojects/c-ares/src/lib/ares_dns_record.c b/subprojects/c-ares/src/lib/ares_dns_record.c
@@ -0,0 +1,1316 @@
+/* MIT License
+ *
+ * Copyright (c) 2023 Brad House
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice (including the next
+ * paragraph) shall be included in all copies or substantial portions of the
+ * Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ *
+ * SPDX-License-Identifier: MIT
+ */
+#include "ares_setup.h"
+#include "ares.h"
+#include "ares_private.h"
+#include <limits.h>
+#ifdef HAVE_STDINT_H
+# include <stdint.h>
+#endif
+
+
+ares_status_t ares_dns_record_create(ares_dns_record_t **dnsrec,
+ unsigned short id, unsigned short flags,
+ ares_dns_opcode_t opcode,
+ ares_dns_rcode_t rcode)
+{
+ if (dnsrec == NULL) {
+ return ARES_EFORMERR;
+ }
+
+ *dnsrec = NULL;
+
+ if (!ares_dns_opcode_isvalid(opcode) || !ares_dns_rcode_isvalid(rcode) ||
+ !ares_dns_flags_arevalid(flags)) {
+ return ARES_EFORMERR;
+ }
+
+ *dnsrec = ares_malloc_zero(sizeof(**dnsrec));
+ if (*dnsrec == NULL) {
+ return ARES_ENOMEM;
+ }
+
+ (*dnsrec)->id = id;
+ (*dnsrec)->flags = flags;
+ (*dnsrec)->opcode = opcode;
+ (*dnsrec)->rcode = rcode;
+ return ARES_SUCCESS;
+}
+
+unsigned short ares_dns_record_get_id(const ares_dns_record_t *dnsrec)
+{
+ if (dnsrec == NULL) {
+ return 0;
+ }
+ return dnsrec->id;
+}
+
+unsigned short ares_dns_record_get_flags(const ares_dns_record_t *dnsrec)
+{
+ if (dnsrec == NULL) {
+ return 0;
+ }
+ return dnsrec->flags;
+}
+
+ares_dns_opcode_t ares_dns_record_get_opcode(const ares_dns_record_t *dnsrec)
+{
+ if (dnsrec == NULL) {
+ return 0;
+ }
+ return dnsrec->opcode;
+}
+
+ares_dns_rcode_t ares_dns_record_get_rcode(const ares_dns_record_t *dnsrec)
+{
+ if (dnsrec == NULL) {
+ return 0;
+ }
+ return dnsrec->rcode;
+}
+
+static void ares__dns_options_free(ares__dns_options_t *options)
+{
+ size_t i;
+
+ if (options == NULL) {
+ return;
+ }
+
+ for (i = 0; i < options->cnt; i++) {
+ ares_free(options->optval[i].val);
+ }
+ ares_free(options->optval);
+ ares_free(options);
+}
+
+static void ares__dns_rr_free(ares_dns_rr_t *rr)
+{
+ ares_free(rr->name);
+
+ switch (rr->type) {
+ case ARES_REC_TYPE_A:
+ case ARES_REC_TYPE_AAAA:
+ case ARES_REC_TYPE_ANY:
+ /* Nothing to free */
+ break;
+
+ case ARES_REC_TYPE_NS:
+ ares_free(rr->r.ns.nsdname);
+ break;
+
+ case ARES_REC_TYPE_CNAME:
+ ares_free(rr->r.cname.cname);
+ break;
+
+ case ARES_REC_TYPE_SOA:
+ ares_free(rr->r.soa.mname);
+ ares_free(rr->r.soa.rname);
+ break;
+
+ case ARES_REC_TYPE_PTR:
+ ares_free(rr->r.ptr.dname);
+ break;
+
+ case ARES_REC_TYPE_HINFO:
+ ares_free(rr->r.hinfo.cpu);
+ ares_free(rr->r.hinfo.os);
+ break;
+
+ case ARES_REC_TYPE_MX:
+ ares_free(rr->r.mx.exchange);
+ break;
+
+ case ARES_REC_TYPE_TXT:
+ ares_free(rr->r.txt.data);
+ break;
+
+ case ARES_REC_TYPE_SRV:
+ ares_free(rr->r.srv.target);
+ break;
+
+ case ARES_REC_TYPE_NAPTR:
+ ares_free(rr->r.naptr.flags);
+ ares_free(rr->r.naptr.services);
+ ares_free(rr->r.naptr.regexp);
+ ares_free(rr->r.naptr.replacement);
+ break;
+
+ case ARES_REC_TYPE_OPT:
+ ares__dns_options_free(rr->r.opt.options);
+ break;
+
+ case ARES_REC_TYPE_TLSA:
+ ares_free(rr->r.tlsa.data);
+ break;
+
+ case ARES_REC_TYPE_SVCB:
+ ares_free(rr->r.svcb.target);
+ ares__dns_options_free(rr->r.svcb.params);
+ break;
+
+ case ARES_REC_TYPE_HTTPS:
+ ares_free(rr->r.https.target);
+ ares__dns_options_free(rr->r.https.params);
+ break;
+
+ case ARES_REC_TYPE_URI:
+ ares_free(rr->r.uri.target);
+ break;
+
+ case ARES_REC_TYPE_CAA:
+ ares_free(rr->r.caa.tag);
+ ares_free(rr->r.caa.value);
+ break;
+
+ case ARES_REC_TYPE_RAW_RR:
+ ares_free(rr->r.raw_rr.data);
+ break;
+ }
+}
+
+void ares_dns_record_destroy(ares_dns_record_t *dnsrec)
+{
+ size_t i;
+
+ if (dnsrec == NULL) {
+ return;
+ }
+
+ /* Free questions */
+ for (i = 0; i < dnsrec->qdcount; i++) {
+ ares_free(dnsrec->qd[i].name);
+ }
+ ares_free(dnsrec->qd);
+
+ /* Free answers */
+ for (i = 0; i < dnsrec->ancount; i++) {
+ ares__dns_rr_free(&dnsrec->an[i]);
+ }
+ ares_free(dnsrec->an);
+
+ /* Free authority */
+ for (i = 0; i < dnsrec->nscount; i++) {
+ ares__dns_rr_free(&dnsrec->ns[i]);
+ }
+ ares_free(dnsrec->ns);
+
+ /* Free additional */
+ for (i = 0; i < dnsrec->arcount; i++) {
+ ares__dns_rr_free(&dnsrec->ar[i]);
+ }
+ ares_free(dnsrec->ar);
+
+ ares_free(dnsrec);
+}
+
+size_t ares_dns_record_query_cnt(const ares_dns_record_t *dnsrec)
+{
+ if (dnsrec == NULL) {
+ return 0;
+ }
+ return dnsrec->qdcount;
+}
+
+ares_status_t ares_dns_record_query_add(ares_dns_record_t *dnsrec,
+ const char *name,
+ ares_dns_rec_type_t qtype,
+ ares_dns_class_t qclass)
+{
+ ares_dns_qd_t *temp = NULL;
+ size_t idx;
+
+ if (dnsrec == NULL || name == NULL ||
+ !ares_dns_rec_type_isvalid(qtype, ARES_TRUE) ||
+ !ares_dns_class_isvalid(qclass, ARES_TRUE)) {
+ return ARES_EFORMERR;
+ }
+
+ if (dnsrec->qdcount >= dnsrec->qdalloc) {
+ size_t alloc_cnt = ares__round_up_pow2(dnsrec->qdcount + 1);
+
+ temp = ares_realloc_zero(dnsrec->qd, sizeof(*temp) * (dnsrec->qdalloc),
+ sizeof(*temp) * alloc_cnt);
+ if (temp == NULL) {
+ return ARES_ENOMEM;
+ }
+
+ dnsrec->qdalloc = alloc_cnt;
+ dnsrec->qd = temp;
+ }
+
+ idx = dnsrec->qdcount;
+
+ dnsrec->qd[idx].name = ares_strdup(name);
+ if (dnsrec->qd[idx].name == NULL) {
+ /* No need to clean up anything */
+ return ARES_ENOMEM;
+ }
+
+ dnsrec->qd[idx].qtype = qtype;
+ dnsrec->qd[idx].qclass = qclass;
+ dnsrec->qdcount++;
+ return ARES_SUCCESS;
+}
+
+ares_status_t ares_dns_record_query_get(const ares_dns_record_t *dnsrec,
+ size_t idx, const char **name,
+ ares_dns_rec_type_t *qtype,
+ ares_dns_class_t *qclass)
+{
+ if (dnsrec == NULL || idx >= dnsrec->qdcount) {
+ return ARES_EFORMERR;
+ }
+
+ if (name != NULL) {
+ *name = dnsrec->qd[idx].name;
+ }
+
+ if (qtype != NULL) {
+ *qtype = dnsrec->qd[idx].qtype;
+ }
+
+ if (qclass != NULL) {
+ *qclass = dnsrec->qd[idx].qclass;
+ }
+
+ return ARES_SUCCESS;
+}
+
+size_t ares_dns_record_rr_cnt(const ares_dns_record_t *dnsrec,
+ ares_dns_section_t sect)
+{
+ if (dnsrec == NULL || !ares_dns_section_isvalid(sect)) {
+ return 0;
+ }
+
+ switch (sect) {
+ case ARES_SECTION_ANSWER:
+ return dnsrec->ancount;
+ case ARES_SECTION_AUTHORITY:
+ return dnsrec->nscount;
+ case ARES_SECTION_ADDITIONAL:
+ return dnsrec->arcount;
+ }
+
+ return 0;
+}
+
+ares_status_t ares_dns_record_rr_prealloc(ares_dns_record_t *dnsrec,
+ ares_dns_section_t sect, size_t cnt)
+{
+ ares_dns_rr_t **rr_ptr = NULL;
+ size_t *rr_alloc = NULL;
+ ares_dns_rr_t *temp = NULL;
+
+ if (dnsrec == NULL || cnt == 0 || !ares_dns_section_isvalid(sect)) {
+ return ARES_EFORMERR;
+ }
+
+ switch (sect) {
+ case ARES_SECTION_ANSWER:
+ rr_ptr = &dnsrec->an;
+ rr_alloc = &dnsrec->analloc;
+ break;
+ case ARES_SECTION_AUTHORITY:
+ rr_ptr = &dnsrec->ns;
+ rr_alloc = &dnsrec->nsalloc;
+ break;
+ case ARES_SECTION_ADDITIONAL:
+ rr_ptr = &dnsrec->ar;
+ rr_alloc = &dnsrec->aralloc;
+ break;
+ }
+
+ /* Round up cnt to a power of 2 */
+ cnt = ares__round_up_pow2(cnt);
+
+ /* Already have that */
+ if (cnt <= *rr_alloc) {
+ return ARES_SUCCESS;
+ }
+
+ temp = ares_realloc_zero(*rr_ptr, sizeof(*temp) * (*rr_alloc),
+ sizeof(*temp) * cnt);
+ if (temp == NULL) {
+ return ARES_ENOMEM;
+ }
+
+ *rr_alloc = cnt;
+ *rr_ptr = temp;
+ return ARES_SUCCESS;
+}
+
+ares_status_t ares_dns_record_rr_add(ares_dns_rr_t **rr_out,
+ ares_dns_record_t *dnsrec,
+ ares_dns_section_t sect, const char *name,
+ ares_dns_rec_type_t type,
+ ares_dns_class_t rclass, unsigned int ttl)
+{
+ ares_dns_rr_t **rr_ptr = NULL;
+ ares_dns_rr_t *rr = NULL;
+ size_t *rr_len = NULL;
+ ares_status_t status;
+ size_t idx;
+
+ if (dnsrec == NULL || name == NULL || rr_out == NULL ||
+ !ares_dns_section_isvalid(sect) ||
+ !ares_dns_rec_type_isvalid(type, ARES_FALSE) ||
+ !ares_dns_class_isvalid(rclass, ARES_FALSE)) {
+ return ARES_EFORMERR;
+ }
+
+ *rr_out = NULL;
+
+ switch (sect) {
+ case ARES_SECTION_ANSWER:
+ rr_ptr = &dnsrec->an;
+ rr_len = &dnsrec->ancount;
+ break;
+ case ARES_SECTION_AUTHORITY:
+ rr_ptr = &dnsrec->ns;
+ rr_len = &dnsrec->nscount;
+ break;
+ case ARES_SECTION_ADDITIONAL:
+ rr_ptr = &dnsrec->ar;
+ rr_len = &dnsrec->arcount;
+ break;
+ }
+
+ status = ares_dns_record_rr_prealloc(dnsrec, sect, *rr_len + 1);
+ if (status != ARES_SUCCESS) {
+ return status;
+ }
+
+ idx = *rr_len;
+ rr = &(*rr_ptr)[idx];
+
+ rr->name = ares_strdup(name);
+ if (rr->name == NULL) {
+ /* No need to clean up anything */
+ return ARES_ENOMEM;
+ }
+
+ rr->parent = dnsrec;
+ rr->type = type;
+ rr->rclass = rclass;
+ rr->ttl = ttl;
+ (*rr_len)++;
+
+ *rr_out = rr;
+
+ return ARES_SUCCESS;
+}
+
+ares_status_t ares_dns_record_rr_del(ares_dns_record_t *dnsrec,
+ ares_dns_section_t sect, size_t idx)
+{
+ ares_dns_rr_t *rr_ptr = NULL;
+ size_t *rr_len = NULL;
+ size_t cnt_after;
+
+ if (dnsrec == NULL || !ares_dns_section_isvalid(sect)) {
+ return ARES_EFORMERR;
+ }
+
+ switch (sect) {
+ case ARES_SECTION_ANSWER:
+ rr_ptr = dnsrec->an;
+ rr_len = &dnsrec->ancount;
+ break;
+ case ARES_SECTION_AUTHORITY:
+ rr_ptr = dnsrec->ns;
+ rr_len = &dnsrec->nscount;
+ break;
+ case ARES_SECTION_ADDITIONAL:
+ rr_ptr = dnsrec->ar;
+ rr_len = &dnsrec->arcount;
+ break;
+ }
+
+ if (idx >= *rr_len) {
+ return ARES_EFORMERR;
+ }
+
+ ares__dns_rr_free(&rr_ptr[idx]);
+
+ cnt_after = *rr_len - idx - 1;
+
+ if (cnt_after) {
+ memmove(&rr_ptr[idx], &rr_ptr[idx + 1], sizeof(*rr_ptr) * cnt_after);
+ }
+
+ (*rr_len)--;
+ return ARES_SUCCESS;
+}
+
+ares_dns_rr_t *ares_dns_record_rr_get(ares_dns_record_t *dnsrec,
+ ares_dns_section_t sect, size_t idx)
+{
+ ares_dns_rr_t *rr_ptr = NULL;
+ size_t rr_len = 0;
+
+ if (dnsrec == NULL || !ares_dns_section_isvalid(sect)) {
+ return NULL;
+ }
+
+ switch (sect) {
+ case ARES_SECTION_ANSWER:
+ rr_ptr = dnsrec->an;
+ rr_len = dnsrec->ancount;
+ break;
+ case ARES_SECTION_AUTHORITY:
+ rr_ptr = dnsrec->ns;
+ rr_len = dnsrec->nscount;
+ break;
+ case ARES_SECTION_ADDITIONAL:
+ rr_ptr = dnsrec->ar;
+ rr_len = dnsrec->arcount;
+ break;
+ }
+
+ if (idx >= rr_len) {
+ return NULL;
+ }
+
+ return &rr_ptr[idx];
+}
+
+static const ares_dns_rr_t *
+ ares_dns_record_rr_get_const(const ares_dns_record_t *dnsrec,
+ ares_dns_section_t sect, size_t idx)
+{
+ return ares_dns_record_rr_get((void *)((size_t)dnsrec), sect, idx);
+}
+
+const char *ares_dns_rr_get_name(const ares_dns_rr_t *rr)
+{
+ if (rr == NULL) {
+ return NULL;
+ }
+ return rr->name;
+}
+
+ares_dns_rec_type_t ares_dns_rr_get_type(const ares_dns_rr_t *rr)
+{
+ if (rr == NULL) {
+ return 0;
+ }
+ return rr->type;
+}
+
+ares_dns_class_t ares_dns_rr_get_class(const ares_dns_rr_t *rr)
+{
+ if (rr == NULL) {
+ return 0;
+ }
+ return rr->rclass;
+}
+
+unsigned int ares_dns_rr_get_ttl(const ares_dns_rr_t *rr)
+{
+ if (rr == NULL) {
+ return 0;
+ }
+ return rr->ttl;
+}
+
+static void *ares_dns_rr_data_ptr(ares_dns_rr_t *dns_rr, ares_dns_rr_key_t key,
+ size_t **lenptr)
+{
+ if (dns_rr == NULL || dns_rr->type != ares_dns_rr_key_to_rec_type(key)) {
+ return NULL;
+ }
+
+ switch (key) {
+ case ARES_RR_A_ADDR:
+ return &dns_rr->r.a.addr;
+
+ case ARES_RR_NS_NSDNAME:
+ return &dns_rr->r.ns.nsdname;
+
+ case ARES_RR_CNAME_CNAME:
+ return &dns_rr->r.cname.cname;
+
+ case ARES_RR_SOA_MNAME:
+ return &dns_rr->r.soa.mname;
+
+ case ARES_RR_SOA_RNAME:
+ return &dns_rr->r.soa.rname;
+
+ case ARES_RR_SOA_SERIAL:
+ return &dns_rr->r.soa.serial;
+
+ case ARES_RR_SOA_REFRESH:
+ return &dns_rr->r.soa.refresh;
+
+ case ARES_RR_SOA_RETRY:
+ return &dns_rr->r.soa.retry;
+
+ case ARES_RR_SOA_EXPIRE:
+ return &dns_rr->r.soa.expire;
+
+ case ARES_RR_SOA_MINIMUM:
+ return &dns_rr->r.soa.minimum;
+
+ case ARES_RR_PTR_DNAME:
+ return &dns_rr->r.ptr.dname;
+
+ case ARES_RR_AAAA_ADDR:
+ return &dns_rr->r.aaaa.addr;
+
+ case ARES_RR_HINFO_CPU:
+ return &dns_rr->r.hinfo.cpu;
+
+ case ARES_RR_HINFO_OS:
+ return &dns_rr->r.hinfo.os;
+
+ case ARES_RR_MX_PREFERENCE:
+ return &dns_rr->r.mx.preference;
+
+ case ARES_RR_MX_EXCHANGE:
+ return &dns_rr->r.mx.exchange;
+
+ case ARES_RR_TXT_DATA:
+ if (lenptr == NULL) {
+ return NULL;
+ }
+ *lenptr = &dns_rr->r.txt.data_len;
+ return &dns_rr->r.txt.data;
+
+ case ARES_RR_SRV_PRIORITY:
+ return &dns_rr->r.srv.priority;
+
+ case ARES_RR_SRV_WEIGHT:
+ return &dns_rr->r.srv.weight;
+
+ case ARES_RR_SRV_PORT:
+ return &dns_rr->r.srv.port;
+
+ case ARES_RR_SRV_TARGET:
+ return &dns_rr->r.srv.target;
+
+ case ARES_RR_NAPTR_ORDER:
+ return &dns_rr->r.naptr.order;
+
+ case ARES_RR_NAPTR_PREFERENCE:
+ return &dns_rr->r.naptr.preference;
+
+ case ARES_RR_NAPTR_FLAGS:
+ return &dns_rr->r.naptr.flags;
+
+ case ARES_RR_NAPTR_SERVICES:
+ return &dns_rr->r.naptr.services;
+
+ case ARES_RR_NAPTR_REGEXP:
+ return &dns_rr->r.naptr.regexp;
+
+ case ARES_RR_NAPTR_REPLACEMENT:
+ return &dns_rr->r.naptr.replacement;
+
+ case ARES_RR_OPT_UDP_SIZE:
+ return &dns_rr->r.opt.udp_size;
+
+ case ARES_RR_OPT_VERSION:
+ return &dns_rr->r.opt.version;
+
+ case ARES_RR_OPT_FLAGS:
+ return &dns_rr->r.opt.flags;
+
+ case ARES_RR_OPT_OPTIONS:
+ return &dns_rr->r.opt.options;
+
+ case ARES_RR_TLSA_CERT_USAGE:
+ return &dns_rr->r.tlsa.cert_usage;
+
+ case ARES_RR_TLSA_SELECTOR:
+ return &dns_rr->r.tlsa.selector;
+
+ case ARES_RR_TLSA_MATCH:
+ return &dns_rr->r.tlsa.match;
+
+ case ARES_RR_TLSA_DATA:
+ if (lenptr == NULL) {
+ return NULL;
+ }
+ *lenptr = &dns_rr->r.tlsa.data_len;
+ return &dns_rr->r.tlsa.data;
+
+ case ARES_RR_SVCB_PRIORITY:
+ return &dns_rr->r.svcb.priority;
+
+ case ARES_RR_SVCB_TARGET:
+ return &dns_rr->r.svcb.target;
+
+ case ARES_RR_SVCB_PARAMS:
+ return &dns_rr->r.svcb.params;
+
+ case ARES_RR_HTTPS_PRIORITY:
+ return &dns_rr->r.https.priority;
+
+ case ARES_RR_HTTPS_TARGET:
+ return &dns_rr->r.https.target;
+
+ case ARES_RR_HTTPS_PARAMS:
+ return &dns_rr->r.https.params;
+
+ case ARES_RR_URI_PRIORITY:
+ return &dns_rr->r.uri.priority;
+
+ case ARES_RR_URI_WEIGHT:
+ return &dns_rr->r.uri.weight;
+
+ case ARES_RR_URI_TARGET:
+ return &dns_rr->r.uri.target;
+
+ case ARES_RR_CAA_CRITICAL:
+ return &dns_rr->r.caa.critical;
+
+ case ARES_RR_CAA_TAG:
+ return &dns_rr->r.caa.tag;
+
+ case ARES_RR_CAA_VALUE:
+ if (lenptr == NULL) {
+ return NULL;
+ }
+ *lenptr = &dns_rr->r.caa.value_len;
+ return &dns_rr->r.caa.value;
+
+ case ARES_RR_RAW_RR_TYPE:
+ return &dns_rr->r.raw_rr.type;
+
+ case ARES_RR_RAW_RR_DATA:
+ if (lenptr == NULL) {
+ return NULL;
+ }
+ *lenptr = &dns_rr->r.raw_rr.length;
+ return &dns_rr->r.raw_rr.data;
+ }
+
+ return NULL;
+}
+
+static const void *ares_dns_rr_data_ptr_const(const ares_dns_rr_t *dns_rr,
+ ares_dns_rr_key_t key,
+ const size_t **lenptr)
+{
+ /* We're going to cast off the const */
+ return ares_dns_rr_data_ptr((void *)((size_t)dns_rr), key,
+ (void *)((size_t)lenptr));
+}
+
+const struct in_addr *ares_dns_rr_get_addr(const ares_dns_rr_t *dns_rr,
+ ares_dns_rr_key_t key)
+{
+ const struct in_addr *addr;
+
+ if (ares_dns_rr_key_datatype(key) != ARES_DATATYPE_INADDR) {
+ return NULL;
+ }
+
+ addr = ares_dns_rr_data_ptr_const(dns_rr, key, NULL);
+ if (addr == NULL) {
+ return NULL;
+ }
+
+ return addr;
+}
+
+const struct ares_in6_addr *ares_dns_rr_get_addr6(const ares_dns_rr_t *dns_rr,
+ ares_dns_rr_key_t key)
+{
+ const struct ares_in6_addr *addr;
+
+ if (ares_dns_rr_key_datatype(key) != ARES_DATATYPE_INADDR6) {
+ return NULL;
+ }
+
+ addr = ares_dns_rr_data_ptr_const(dns_rr, key, NULL);
+ if (addr == NULL) {
+ return NULL;
+ }
+
+ return addr;
+}
+
+unsigned char ares_dns_rr_get_u8(const ares_dns_rr_t *dns_rr,
+ ares_dns_rr_key_t key)
+{
+ const unsigned char *u8;
+
+ if (ares_dns_rr_key_datatype(key) != ARES_DATATYPE_U8) {
+ return 0;
+ }
+
+ u8 = ares_dns_rr_data_ptr_const(dns_rr, key, NULL);
+ if (u8 == NULL) {
+ return 0;
+ }
+
+ return *u8;
+}
+
+unsigned short ares_dns_rr_get_u16(const ares_dns_rr_t *dns_rr,
+ ares_dns_rr_key_t key)
+{
+ const unsigned short *u16;
+
+ if (ares_dns_rr_key_datatype(key) != ARES_DATATYPE_U16) {
+ return 0;
+ }
+
+ u16 = ares_dns_rr_data_ptr_const(dns_rr, key, NULL);
+ if (u16 == NULL) {
+ return 0;
+ }
+
+ return *u16;
+}
+
+unsigned int ares_dns_rr_get_u32(const ares_dns_rr_t *dns_rr,
+ ares_dns_rr_key_t key)
+{
+ const unsigned int *u32;
+
+ if (ares_dns_rr_key_datatype(key) != ARES_DATATYPE_U32) {
+ return 0;
+ }
+
+ u32 = ares_dns_rr_data_ptr_const(dns_rr, key, NULL);
+ if (u32 == NULL) {
+ return 0;
+ }
+
+ return *u32;
+}
+
+const unsigned char *ares_dns_rr_get_bin(const ares_dns_rr_t *dns_rr,
+ ares_dns_rr_key_t key, size_t *len)
+{
+ unsigned char * const *bin = NULL;
+ size_t const *bin_len = NULL;
+
+ if ((ares_dns_rr_key_datatype(key) != ARES_DATATYPE_BIN &&
+ ares_dns_rr_key_datatype(key) != ARES_DATATYPE_BINP) ||
+ len == NULL) {
+ return NULL;
+ }
+
+ bin = ares_dns_rr_data_ptr_const(dns_rr, key, &bin_len);
+ if (bin == NULL) {
+ return 0;
+ }
+
+ /* Shouldn't be possible */
+ if (bin_len == NULL) {
+ return NULL;
+ }
+
+ *len = *bin_len;
+
+ return *bin;
+}
+
+const char *ares_dns_rr_get_str(const ares_dns_rr_t *dns_rr,
+ ares_dns_rr_key_t key)
+{
+ char * const *str;
+
+ if (ares_dns_rr_key_datatype(key) != ARES_DATATYPE_STR &&
+ ares_dns_rr_key_datatype(key) != ARES_DATATYPE_NAME) {
+ return NULL;
+ }
+
+ str = ares_dns_rr_data_ptr_const(dns_rr, key, NULL);
+ if (str == NULL) {
+ return NULL;
+ }
+
+ return *str;
+}
+
+size_t ares_dns_rr_get_opt_cnt(const ares_dns_rr_t *dns_rr,
+ ares_dns_rr_key_t key)
+{
+ ares__dns_options_t * const *opts;
+
+ if (ares_dns_rr_key_datatype(key) != ARES_DATATYPE_OPT) {
+ return 0;
+ }
+
+ opts = ares_dns_rr_data_ptr_const(dns_rr, key, NULL);
+ if (opts == NULL || *opts == NULL) {
+ return 0;
+ }
+
+ return (*opts)->cnt;
+}
+
+unsigned short ares_dns_rr_get_opt(const ares_dns_rr_t *dns_rr,
+ ares_dns_rr_key_t key, size_t idx,
+ const unsigned char **val, size_t *val_len)
+{
+ ares__dns_options_t * const *opts;
+
+ if (val) {
+ *val = NULL;
+ }
+ if (val_len) {
+ *val_len = 0;
+ }
+
+ if (ares_dns_rr_key_datatype(key) != ARES_DATATYPE_OPT) {
+ return 65535;
+ }
+
+ opts = ares_dns_rr_data_ptr_const(dns_rr, key, NULL);
+ if (opts == NULL || *opts == NULL) {
+ return 65535;
+ }
+
+ if (idx >= (*opts)->cnt) {
+ return 65535;
+ }
+
+ if (val) {
+ *val = (*opts)->optval[idx].val;
+ }
+ if (val_len) {
+ *val_len = (*opts)->optval[idx].val_len;
+ }
+
+ return (*opts)->optval[idx].opt;
+}
+
+ares_bool_t ares_dns_rr_get_opt_byid(const ares_dns_rr_t *dns_rr,
+ ares_dns_rr_key_t key, unsigned short opt,
+ const unsigned char **val, size_t *val_len)
+{
+ ares__dns_options_t * const *opts;
+ size_t i;
+
+ if (val) {
+ *val = NULL;
+ }
+ if (val_len) {
+ *val_len = 0;
+ }
+
+ if (ares_dns_rr_key_datatype(key) != ARES_DATATYPE_OPT) {
+ return ARES_FALSE;
+ }
+
+ opts = ares_dns_rr_data_ptr_const(dns_rr, key, NULL);
+ if (opts == NULL || *opts == NULL) {
+ return ARES_FALSE;
+ }
+
+ for (i = 0; i < (*opts)->cnt; i++) {
+ if ((*opts)->optval[i].opt == opt) {
+ break;
+ }
+ }
+
+ if (i >= (*opts)->cnt) {
+ return ARES_FALSE;
+ }
+
+ if (val) {
+ *val = (*opts)->optval[i].val;
+ }
+ if (val_len) {
+ *val_len = (*opts)->optval[i].val_len;
+ }
+ return ARES_TRUE;
+}
+
+ares_status_t ares_dns_rr_set_addr(ares_dns_rr_t *dns_rr, ares_dns_rr_key_t key,
+ const struct in_addr *addr)
+{
+ struct in_addr *a;
+
+ if (ares_dns_rr_key_datatype(key) != ARES_DATATYPE_INADDR || addr == NULL) {
+ return ARES_EFORMERR;
+ }
+
+ a = ares_dns_rr_data_ptr(dns_rr, key, NULL);
+ if (a == NULL) {
+ return ARES_EFORMERR;
+ }
+
+ memcpy(a, addr, sizeof(*a));
+ return ARES_SUCCESS;
+}
+
+ares_status_t ares_dns_rr_set_addr6(ares_dns_rr_t *dns_rr,
+ ares_dns_rr_key_t key,
+ const struct ares_in6_addr *addr)
+{
+ struct ares_in6_addr *a;
+
+ if (ares_dns_rr_key_datatype(key) != ARES_DATATYPE_INADDR6 || addr == NULL) {
+ return ARES_EFORMERR;
+ }
+
+ a = ares_dns_rr_data_ptr(dns_rr, key, NULL);
+ if (a == NULL) {
+ return ARES_EFORMERR;
+ }
+
+ memcpy(a, addr, sizeof(*a));
+ return ARES_SUCCESS;
+}
+
+ares_status_t ares_dns_rr_set_u8(ares_dns_rr_t *dns_rr, ares_dns_rr_key_t key,
+ unsigned char val)
+{
+ unsigned char *u8;
+
+ if (ares_dns_rr_key_datatype(key) != ARES_DATATYPE_U8) {
+ return ARES_EFORMERR;
+ }
+
+ u8 = ares_dns_rr_data_ptr(dns_rr, key, NULL);
+ if (u8 == NULL) {
+ return ARES_EFORMERR;
+ }
+
+ *u8 = val;
+ return ARES_SUCCESS;
+}
+
+ares_status_t ares_dns_rr_set_u16(ares_dns_rr_t *dns_rr, ares_dns_rr_key_t key,
+ unsigned short val)
+{
+ unsigned short *u16;
+
+ if (ares_dns_rr_key_datatype(key) != ARES_DATATYPE_U16) {
+ return ARES_EFORMERR;
+ }
+
+ u16 = ares_dns_rr_data_ptr(dns_rr, key, NULL);
+ if (u16 == NULL) {
+ return ARES_EFORMERR;
+ }
+
+ *u16 = val;
+ return ARES_SUCCESS;
+}
+
+ares_status_t ares_dns_rr_set_u32(ares_dns_rr_t *dns_rr, ares_dns_rr_key_t key,
+ unsigned int val)
+{
+ unsigned int *u32;
+
+ if (ares_dns_rr_key_datatype(key) != ARES_DATATYPE_U32) {
+ return ARES_EFORMERR;
+ }
+
+ u32 = ares_dns_rr_data_ptr(dns_rr, key, NULL);
+ if (u32 == NULL) {
+ return ARES_EFORMERR;
+ }
+
+ *u32 = val;
+ return ARES_SUCCESS;
+}
+
+ares_status_t ares_dns_rr_set_bin_own(ares_dns_rr_t *dns_rr,
+ ares_dns_rr_key_t key, unsigned char *val,
+ size_t len)
+{
+ unsigned char **bin;
+ size_t *bin_len = NULL;
+
+ if (ares_dns_rr_key_datatype(key) != ARES_DATATYPE_BIN &&
+ ares_dns_rr_key_datatype(key) != ARES_DATATYPE_BINP) {
+ return ARES_EFORMERR;
+ }
+
+ bin = ares_dns_rr_data_ptr(dns_rr, key, &bin_len);
+ if (bin == NULL || bin_len == NULL) {
+ return ARES_EFORMERR;
+ }
+
+ if (*bin) {
+ ares_free(*bin);
+ }
+ *bin = val;
+ *bin_len = len;
+
+ return ARES_SUCCESS;
+}
+
+ares_status_t ares_dns_rr_set_bin(ares_dns_rr_t *dns_rr, ares_dns_rr_key_t key,
+ const unsigned char *val, size_t len)
+{
+ ares_status_t status;
+ ares_dns_datatype_t datatype = ares_dns_rr_key_datatype(key);
+ size_t alloclen = (datatype == ARES_DATATYPE_BINP) ? len + 1 : len;
+ unsigned char *temp = ares_malloc(alloclen);
+
+ if (temp == NULL) {
+ return ARES_ENOMEM;
+ }
+
+ memcpy(temp, val, len);
+
+ /* NULL-term BINP */
+ if (datatype == ARES_DATATYPE_BINP) {
+ temp[len] = 0;
+ }
+
+ status = ares_dns_rr_set_bin_own(dns_rr, key, temp, len);
+ if (status != ARES_SUCCESS) {
+ ares_free(temp);
+ }
+
+ return status;
+}
+
+ares_status_t ares_dns_rr_set_str_own(ares_dns_rr_t *dns_rr,
+ ares_dns_rr_key_t key, char *val)
+{
+ char **str;
+
+ if (ares_dns_rr_key_datatype(key) != ARES_DATATYPE_STR &&
+ ares_dns_rr_key_datatype(key) != ARES_DATATYPE_NAME) {
+ return ARES_EFORMERR;
+ }
+
+ str = ares_dns_rr_data_ptr(dns_rr, key, NULL);
+ if (str == NULL) {
+ return ARES_EFORMERR;
+ }
+
+ if (*str) {
+ ares_free(*str);
+ }
+ *str = val;
+
+ return ARES_SUCCESS;
+}
+
+ares_status_t ares_dns_rr_set_str(ares_dns_rr_t *dns_rr, ares_dns_rr_key_t key,
+ const char *val)
+{
+ ares_status_t status;
+ char *temp = NULL;
+
+ if (val != NULL) {
+ temp = ares_strdup(val);
+ if (temp == NULL) {
+ return ARES_ENOMEM;
+ }
+ }
+
+ status = ares_dns_rr_set_str_own(dns_rr, key, temp);
+ if (status != ARES_SUCCESS) {
+ ares_free(temp);
+ }
+
+ return status;
+}
+
+ares_status_t ares_dns_rr_set_opt_own(ares_dns_rr_t *dns_rr,
+ ares_dns_rr_key_t key, unsigned short opt,
+ unsigned char *val, size_t val_len)
+{
+ ares__dns_options_t **options;
+ size_t idx;
+
+ if (ares_dns_rr_key_datatype(key) != ARES_DATATYPE_OPT) {
+ return ARES_EFORMERR;
+ }
+
+ options = ares_dns_rr_data_ptr(dns_rr, key, NULL);
+ if (options == NULL) {
+ return ARES_EFORMERR;
+ }
+
+ if (*options == NULL) {
+ *options = ares_malloc_zero(sizeof(**options));
+ }
+ if (*options == NULL) {
+ return ARES_ENOMEM;
+ }
+
+ for (idx = 0; idx < (*options)->cnt; idx++) {
+ if ((*options)->optval[idx].opt == opt) {
+ break;
+ }
+ }
+
+ /* Duplicate entry, replace */
+ if (idx != (*options)->cnt) {
+ goto done;
+ }
+
+ idx = (*options)->cnt;
+
+ /* Expand by powers of 2 */
+ if (idx >= (*options)->alloc) {
+ size_t alloc_size = (*options)->alloc;
+ void *temp;
+
+ if (alloc_size == 0) {
+ alloc_size = 1;
+ } else {
+ alloc_size <<= 1;
+ }
+
+ temp = ares_realloc_zero((*options)->optval,
+ (*options)->alloc * sizeof(*(*options)->optval),
+ alloc_size * sizeof(*(*options)->optval));
+ if (temp == NULL) {
+ return ARES_ENOMEM;
+ }
+
+ (*options)->optval = temp;
+ (*options)->alloc = alloc_size;
+ }
+
+ (*options)->cnt++;
+
+done:
+ ares_free((*options)->optval[idx].val);
+ (*options)->optval[idx].opt = opt;
+ (*options)->optval[idx].val = val;
+ (*options)->optval[idx].val_len = val_len;
+
+ return ARES_SUCCESS;
+}
+
+ares_status_t ares_dns_rr_set_opt(ares_dns_rr_t *dns_rr, ares_dns_rr_key_t key,
+ unsigned short opt, const unsigned char *val,
+ size_t val_len)
+{
+ unsigned char *temp = NULL;
+ ares_status_t status;
+
+ if (val != NULL) {
+ temp = ares_malloc(val_len + 1);
+ if (temp == NULL) {
+ return ARES_ENOMEM;
+ }
+ memcpy(temp, val, val_len);
+ temp[val_len] = 0;
+ }
+
+ status = ares_dns_rr_set_opt_own(dns_rr, key, opt, temp, val_len);
+ if (status != ARES_SUCCESS) {
+ ares_free(temp);
+ }
+
+ return status;
+}
+
+char *ares_dns_addr_to_ptr(const struct ares_addr *addr)
+{
+ ares__buf_t *buf = NULL;
+ const unsigned char *ptr = NULL;
+ size_t ptr_len = 0;
+ size_t i;
+ ares_status_t status;
+ static const unsigned char hexbytes[] = "0123456789abcdef";
+
+ if (addr->family != AF_INET && addr->family != AF_INET6) {
+ goto fail;
+ }
+
+ buf = ares__buf_create();
+ if (buf == NULL) {
+ goto fail;
+ }
+
+ if (addr->family == AF_INET) {
+ ptr = (const unsigned char *)&addr->addr.addr4;
+ ptr_len = 4;
+ } else {
+ ptr = (const unsigned char *)&addr->addr.addr6;
+ ptr_len = 16;
+ }
+
+ for (i = ptr_len; i > 0; i--) {
+ if (addr->family == AF_INET) {
+ status = ares__buf_append_num_dec(buf, (size_t)ptr[i - 1], 0);
+ } else {
+ unsigned char c;
+
+ c = ptr[i - 1] & 0xF;
+ status = ares__buf_append_byte(buf, hexbytes[c]);
+ if (status != ARES_SUCCESS) {
+ goto fail;
+ }
+
+ status = ares__buf_append_byte(buf, '.');
+ if (status != ARES_SUCCESS) {
+ goto fail;
+ }
+
+ c = (ptr[i - 1] >> 4) & 0xF;
+ status = ares__buf_append_byte(buf, hexbytes[c]);
+ }
+ if (status != ARES_SUCCESS) {
+ goto fail;
+ }
+
+ status = ares__buf_append_byte(buf, '.');
+ if (status != ARES_SUCCESS) {
+ goto fail;
+ }
+ }
+
+ if (addr->family == AF_INET) {
+ status = ares__buf_append(buf, (const unsigned char *)"in-addr.arpa", 12);
+ } else {
+ status = ares__buf_append(buf, (const unsigned char *)"ip6.arpa", 8);
+ }
+ if (status != ARES_SUCCESS) {
+ goto fail;
+ }
+
+ return ares__buf_finish_str(buf, NULL);
+
+fail:
+ ares__buf_destroy(buf);
+ return NULL;
+}
+
+/* search for an OPT RR in the response */
+ares_bool_t ares_dns_has_opt_rr(const ares_dns_record_t *rec)
+{
+ size_t i;
+ for (i = 0; i < ares_dns_record_rr_cnt(rec, ARES_SECTION_ADDITIONAL); i++) {
+ const ares_dns_rr_t *rr =
+ ares_dns_record_rr_get_const(rec, ARES_SECTION_ADDITIONAL, i);
+
+ if (ares_dns_rr_get_type(rr) == ARES_REC_TYPE_OPT) {
+ return ARES_TRUE;
+ }
+ }
+ return ARES_FALSE;
+}
diff --git a/subprojects/c-ares/src/lib/ares_dns_write.c b/subprojects/c-ares/src/lib/ares_dns_write.c
@@ -0,0 +1,1054 @@
+/* MIT License
+ *
+ * Copyright (c) 2023 Brad House
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice (including the next
+ * paragraph) shall be included in all copies or substantial portions of the
+ * Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ *
+ * SPDX-License-Identifier: MIT
+ */
+#include "ares_setup.h"
+#include "ares.h"
+#include "ares_private.h"
+#include <limits.h>
+#ifdef HAVE_STDINT_H
+# include <stdint.h>
+#endif
+
+
+static ares_status_t ares_dns_write_header(const ares_dns_record_t *dnsrec,
+ ares__buf_t *buf)
+{
+ unsigned short u16;
+ unsigned short opcode;
+ unsigned short rcode;
+
+ ares_status_t status;
+
+ /* ID */
+ status = ares__buf_append_be16(buf, dnsrec->id);
+ if (status != ARES_SUCCESS) {
+ return status;
+ }
+
+ /* Flags */
+ u16 = 0;
+
+ /* QR */
+ if (dnsrec->flags & ARES_FLAG_QR) {
+ u16 |= 0x8000;
+ }
+
+ /* OPCODE */
+ opcode = (unsigned short)(dnsrec->opcode & 0xF);
+ opcode <<= 11;
+ u16 |= opcode;
+
+ /* AA */
+ if (dnsrec->flags & ARES_FLAG_AA) {
+ u16 |= 0x400;
+ }
+
+ /* TC */
+ if (dnsrec->flags & ARES_FLAG_TC) {
+ u16 |= 0x200;
+ }
+
+ /* RD */
+ if (dnsrec->flags & ARES_FLAG_RD) {
+ u16 |= 0x100;
+ }
+
+ /* RA */
+ if (dnsrec->flags & ARES_FLAG_RA) {
+ u16 |= 0x80;
+ }
+
+ /* Z -- unused */
+
+ /* AD */
+ if (dnsrec->flags & ARES_FLAG_AD) {
+ u16 |= 0x20;
+ }
+
+ /* CD */
+ if (dnsrec->flags & ARES_FLAG_CD) {
+ u16 |= 0x10;
+ }
+
+ /* RCODE */
+ if (dnsrec->rcode > 15 && !ares_dns_has_opt_rr(dnsrec)) {
+ /* Must have OPT RR in order to write extended error codes */
+ rcode = ARES_RCODE_SERVFAIL;
+ } else {
+ rcode = (unsigned short)(dnsrec->rcode & 0xF);
+ }
+ u16 |= rcode;
+
+ status = ares__buf_append_be16(buf, u16);
+ if (status != ARES_SUCCESS) {
+ return status;
+ }
+
+ /* QDCOUNT */
+ status = ares__buf_append_be16(buf, (unsigned short)dnsrec->qdcount);
+ if (status != ARES_SUCCESS) {
+ return status;
+ }
+
+ /* ANCOUNT */
+ status = ares__buf_append_be16(buf, (unsigned short)dnsrec->ancount);
+ if (status != ARES_SUCCESS) {
+ return status;
+ }
+
+ /* NSCOUNT */
+ status = ares__buf_append_be16(buf, (unsigned short)dnsrec->nscount);
+ if (status != ARES_SUCCESS) {
+ return status;
+ }
+
+ /* ARCOUNT */
+ status = ares__buf_append_be16(buf, (unsigned short)dnsrec->arcount);
+ if (status != ARES_SUCCESS) {
+ return status;
+ }
+
+ return ARES_SUCCESS;
+}
+
+static ares_status_t ares_dns_write_questions(const ares_dns_record_t *dnsrec,
+ ares__llist_t **namelist,
+ ares__buf_t *buf)
+{
+ size_t i;
+
+ for (i = 0; i < ares_dns_record_query_cnt(dnsrec); i++) {
+ ares_status_t status;
+ const char *name = NULL;
+ ares_dns_rec_type_t qtype;
+ ares_dns_class_t qclass;
+
+ status = ares_dns_record_query_get(dnsrec, i, &name, &qtype, &qclass);
+ if (status != ARES_SUCCESS) {
+ return status;
+ }
+
+ /* Name */
+ status = ares__dns_name_write(buf, namelist, ARES_TRUE, name);
+ if (status != ARES_SUCCESS) {
+ return status;
+ }
+
+ /* Type */
+ status = ares__buf_append_be16(buf, (unsigned short)qtype);
+ if (status != ARES_SUCCESS) {
+ return status;
+ }
+
+ /* Class */
+ status = ares__buf_append_be16(buf, (unsigned short)qclass);
+ if (status != ARES_SUCCESS) {
+ return status;
+ }
+ }
+
+ return ARES_SUCCESS;
+}
+
+static ares_status_t ares_dns_write_rr_name(ares__buf_t *buf,
+ const ares_dns_rr_t *rr,
+ ares__llist_t **namelist,
+ ares_bool_t validate_hostname,
+ ares_dns_rr_key_t key)
+{
+ const char *name;
+
+ name = ares_dns_rr_get_str(rr, key);
+ if (name == NULL) {
+ return ARES_EFORMERR;
+ }
+
+ return ares__dns_name_write(buf, namelist, validate_hostname, name);
+}
+
+static ares_status_t ares_dns_write_rr_str(ares__buf_t *buf,
+ const ares_dns_rr_t *rr,
+ ares_dns_rr_key_t key)
+{
+ const char *str;
+ size_t len;
+ ares_status_t status;
+
+ str = ares_dns_rr_get_str(rr, key);
+ if (str == NULL) {
+ return ARES_EFORMERR;
+ }
+
+ len = ares_strlen(str);
+ if (len > 255) {
+ return ARES_EFORMERR;
+ }
+
+ /* Write 1 byte length */
+ status = ares__buf_append_byte(buf, (unsigned char)(len & 0xFF));
+ if (status != ARES_SUCCESS) {
+ return status;
+ }
+
+ if (len == 0) {
+ return ARES_SUCCESS;
+ }
+
+ /* Write string */
+ return ares__buf_append(buf, (const unsigned char *)str, len);
+}
+
+static ares_status_t ares_dns_write_rr_binstrs(ares__buf_t *buf,
+ const ares_dns_rr_t *rr,
+ ares_dns_rr_key_t key)
+{
+ const unsigned char *bin;
+ const unsigned char *ptr;
+ size_t bin_len;
+ size_t ptr_len;
+ ares_status_t status;
+
+ bin = ares_dns_rr_get_bin(rr, key, &bin_len);
+ if (bin == NULL) {
+ return ARES_EFORMERR;
+ }
+ /* split into possible multiple 255-byte or less length strings */
+ ptr = bin;
+ ptr_len = bin_len;
+ do {
+ size_t len = ptr_len;
+ if (len > 255) {
+ len = 255;
+ }
+
+ /* Length */
+ status = ares__buf_append_byte(buf, (unsigned char)(len & 0xFF));
+ if (status != ARES_SUCCESS) {
+ return status;
+ }
+
+ /* String */
+ if (len) {
+ status = ares__buf_append(buf, ptr, len);
+ if (status != ARES_SUCCESS) {
+ return status;
+ }
+ }
+
+ ptr += len;
+ ptr_len -= len;
+ } while (ptr_len > 0);
+
+ return ARES_SUCCESS;
+}
+
+static ares_status_t ares_dns_write_rr_be32(ares__buf_t *buf,
+ const ares_dns_rr_t *rr,
+ ares_dns_rr_key_t key)
+{
+ if (ares_dns_rr_key_datatype(key) != ARES_DATATYPE_U32) {
+ return ARES_EFORMERR;
+ }
+ return ares__buf_append_be32(buf, ares_dns_rr_get_u32(rr, key));
+}
+
+static ares_status_t ares_dns_write_rr_be16(ares__buf_t *buf,
+ const ares_dns_rr_t *rr,
+ ares_dns_rr_key_t key)
+{
+ if (ares_dns_rr_key_datatype(key) != ARES_DATATYPE_U16) {
+ return ARES_EFORMERR;
+ }
+ return ares__buf_append_be16(buf, ares_dns_rr_get_u16(rr, key));
+}
+
+static ares_status_t ares_dns_write_rr_u8(ares__buf_t *buf,
+ const ares_dns_rr_t *rr,
+ ares_dns_rr_key_t key)
+{
+ if (ares_dns_rr_key_datatype(key) != ARES_DATATYPE_U8) {
+ return ARES_EFORMERR;
+ }
+ return ares__buf_append_byte(buf, ares_dns_rr_get_u8(rr, key));
+}
+
+static ares_status_t ares_dns_write_rr_a(ares__buf_t *buf,
+ const ares_dns_rr_t *rr,
+ ares__llist_t **namelist)
+{
+ const struct in_addr *addr;
+ (void)namelist;
+
+ addr = ares_dns_rr_get_addr(rr, ARES_RR_A_ADDR);
+ if (addr == NULL) {
+ return ARES_EFORMERR;
+ }
+
+ return ares__buf_append(buf, (const unsigned char *)addr, sizeof(*addr));
+}
+
+static ares_status_t ares_dns_write_rr_ns(ares__buf_t *buf,
+ const ares_dns_rr_t *rr,
+ ares__llist_t **namelist)
+{
+ return ares_dns_write_rr_name(buf, rr, namelist, ARES_FALSE,
+ ARES_RR_NS_NSDNAME);
+}
+
+static ares_status_t ares_dns_write_rr_cname(ares__buf_t *buf,
+ const ares_dns_rr_t *rr,
+ ares__llist_t **namelist)
+{
+ return ares_dns_write_rr_name(buf, rr, namelist, ARES_FALSE,
+ ARES_RR_CNAME_CNAME);
+}
+
+static ares_status_t ares_dns_write_rr_soa(ares__buf_t *buf,
+ const ares_dns_rr_t *rr,
+ ares__llist_t **namelist)
+{
+ ares_status_t status;
+
+ /* MNAME */
+ status =
+ ares_dns_write_rr_name(buf, rr, namelist, ARES_FALSE, ARES_RR_SOA_MNAME);
+ if (status != ARES_SUCCESS) {
+ return status;
+ }
+
+ /* RNAME */
+ status =
+ ares_dns_write_rr_name(buf, rr, namelist, ARES_FALSE, ARES_RR_SOA_RNAME);
+ if (status != ARES_SUCCESS) {
+ return status;
+ }
+
+ /* SERIAL */
+ status = ares_dns_write_rr_be32(buf, rr, ARES_RR_SOA_SERIAL);
+ if (status != ARES_SUCCESS) {
+ return status;
+ }
+
+ /* REFRESH */
+ status = ares_dns_write_rr_be32(buf, rr, ARES_RR_SOA_REFRESH);
+ if (status != ARES_SUCCESS) {
+ return status;
+ }
+
+ /* RETRY */
+ status = ares_dns_write_rr_be32(buf, rr, ARES_RR_SOA_RETRY);
+ if (status != ARES_SUCCESS) {
+ return status;
+ }
+
+ /* EXPIRE */
+ status = ares_dns_write_rr_be32(buf, rr, ARES_RR_SOA_EXPIRE);
+ if (status != ARES_SUCCESS) {
+ return status;
+ }
+
+ /* MINIMUM */
+ return ares_dns_write_rr_be32(buf, rr, ARES_RR_SOA_MINIMUM);
+}
+
+static ares_status_t ares_dns_write_rr_ptr(ares__buf_t *buf,
+ const ares_dns_rr_t *rr,
+ ares__llist_t **namelist)
+{
+ return ares_dns_write_rr_name(buf, rr, namelist, ARES_FALSE,
+ ARES_RR_PTR_DNAME);
+}
+
+static ares_status_t ares_dns_write_rr_hinfo(ares__buf_t *buf,
+ const ares_dns_rr_t *rr,
+ ares__llist_t **namelist)
+{
+ ares_status_t status;
+
+ (void)namelist;
+
+ /* CPU */
+ status = ares_dns_write_rr_str(buf, rr, ARES_RR_HINFO_CPU);
+ if (status != ARES_SUCCESS) {
+ return status;
+ }
+
+ /* OS */
+ return ares_dns_write_rr_str(buf, rr, ARES_RR_HINFO_OS);
+}
+
+static ares_status_t ares_dns_write_rr_mx(ares__buf_t *buf,
+ const ares_dns_rr_t *rr,
+ ares__llist_t **namelist)
+{
+ ares_status_t status;
+
+ /* PREFERENCE */
+ status = ares_dns_write_rr_be16(buf, rr, ARES_RR_MX_PREFERENCE);
+ if (status != ARES_SUCCESS) {
+ return status;
+ }
+
+ /* EXCHANGE */
+ return ares_dns_write_rr_name(buf, rr, namelist, ARES_FALSE,
+ ARES_RR_MX_EXCHANGE);
+}
+
+static ares_status_t ares_dns_write_rr_txt(ares__buf_t *buf,
+ const ares_dns_rr_t *rr,
+ ares__llist_t **namelist)
+{
+ (void)namelist;
+ return ares_dns_write_rr_binstrs(buf, rr, ARES_RR_TXT_DATA);
+}
+
+static ares_status_t ares_dns_write_rr_aaaa(ares__buf_t *buf,
+ const ares_dns_rr_t *rr,
+ ares__llist_t **namelist)
+{
+ const struct ares_in6_addr *addr;
+ (void)namelist;
+
+ addr = ares_dns_rr_get_addr6(rr, ARES_RR_AAAA_ADDR);
+ if (addr == NULL) {
+ return ARES_EFORMERR;
+ }
+
+ return ares__buf_append(buf, (const unsigned char *)addr, sizeof(*addr));
+}
+
+static ares_status_t ares_dns_write_rr_srv(ares__buf_t *buf,
+ const ares_dns_rr_t *rr,
+ ares__llist_t **namelist)
+{
+ ares_status_t status;
+
+ /* PRIORITY */
+ status = ares_dns_write_rr_be16(buf, rr, ARES_RR_SRV_PRIORITY);
+ if (status != ARES_SUCCESS) {
+ return status;
+ }
+
+ /* WEIGHT */
+ status = ares_dns_write_rr_be16(buf, rr, ARES_RR_SRV_WEIGHT);
+ if (status != ARES_SUCCESS) {
+ return status;
+ }
+
+ /* PORT */
+ status = ares_dns_write_rr_be16(buf, rr, ARES_RR_SRV_PORT);
+ if (status != ARES_SUCCESS) {
+ return status;
+ }
+
+ /* TARGET */
+ return ares_dns_write_rr_name(buf, rr, namelist, ARES_FALSE,
+ ARES_RR_SRV_TARGET);
+}
+
+static ares_status_t ares_dns_write_rr_naptr(ares__buf_t *buf,
+ const ares_dns_rr_t *rr,
+ ares__llist_t **namelist)
+{
+ ares_status_t status;
+
+ /* ORDER */
+ status = ares_dns_write_rr_be16(buf, rr, ARES_RR_NAPTR_ORDER);
+ if (status != ARES_SUCCESS) {
+ return status;
+ }
+
+ /* PREFERENCE */
+ status = ares_dns_write_rr_be16(buf, rr, ARES_RR_NAPTR_PREFERENCE);
+ if (status != ARES_SUCCESS) {
+ return status;
+ }
+
+ /* FLAGS */
+ status = ares_dns_write_rr_str(buf, rr, ARES_RR_NAPTR_FLAGS);
+ if (status != ARES_SUCCESS) {
+ return status;
+ }
+
+ /* SERVICES */
+ status = ares_dns_write_rr_str(buf, rr, ARES_RR_NAPTR_SERVICES);
+ if (status != ARES_SUCCESS) {
+ return status;
+ }
+
+ /* REGEXP */
+ status = ares_dns_write_rr_str(buf, rr, ARES_RR_NAPTR_REGEXP);
+ if (status != ARES_SUCCESS) {
+ return status;
+ }
+
+ /* REPLACEMENT */
+ return ares_dns_write_rr_name(buf, rr, namelist, ARES_FALSE,
+ ARES_RR_NAPTR_REPLACEMENT);
+}
+
+static ares_status_t ares_dns_write_rr_opt(ares__buf_t *buf,
+ const ares_dns_rr_t *rr,
+ ares__llist_t **namelist)
+{
+ size_t len = ares__buf_len(buf);
+ ares_status_t status;
+ unsigned int ttl = 0;
+ size_t i;
+ unsigned short rcode = (unsigned short)((rr->parent->rcode >> 4) & 0xFF);
+
+ (void)namelist;
+
+ /* We need to go back and overwrite the class and ttl that were emitted as
+ * the OPT record overloads them for its own use (yes, very strange!) */
+ status = ares__buf_set_length(buf, len - 2 /* RDLENGTH */
+ - 4 /* TTL */
+ - 2 /* CLASS */);
+ if (status != ARES_SUCCESS) {
+ return status;
+ }
+
+ /* Class -> UDP Size */
+ status = ares_dns_write_rr_be16(buf, rr, ARES_RR_OPT_UDP_SIZE);
+ if (status != ARES_SUCCESS) {
+ return status;
+ }
+
+ /* TTL -> rcode (u8) << 24 | version (u8) << 16 | flags (u16) */
+ ttl |= (unsigned int)rcode << 24;
+ ttl |= (unsigned int)ares_dns_rr_get_u8(rr, ARES_RR_OPT_VERSION) << 16;
+ ttl |= (unsigned int)ares_dns_rr_get_u16(rr, ARES_RR_OPT_FLAGS);
+
+ status = ares__buf_append_be32(buf, ttl);
+ if (status != ARES_SUCCESS) {
+ return status;
+ }
+
+ /* Now go back to real end */
+ status = ares__buf_set_length(buf, len);
+ if (status != ARES_SUCCESS) {
+ return status;
+ }
+
+ /* Append Options */
+ for (i = 0; i < ares_dns_rr_get_opt_cnt(rr, ARES_RR_OPT_OPTIONS); i++) {
+ unsigned short opt;
+ size_t val_len;
+ const unsigned char *val;
+
+ opt = ares_dns_rr_get_opt(rr, ARES_RR_OPT_OPTIONS, i, &val, &val_len);
+
+ /* BE16 option */
+ status = ares__buf_append_be16(buf, opt);
+ if (status != ARES_SUCCESS) {
+ return status;
+ }
+
+ /* BE16 length */
+ status = ares__buf_append_be16(buf, (unsigned short)(val_len & 0xFFFF));
+ if (status != ARES_SUCCESS) {
+ return status;
+ }
+
+ /* Value */
+ if (val && val_len) {
+ status = ares__buf_append(buf, val, val_len);
+ if (status != ARES_SUCCESS) {
+ return status;
+ }
+ }
+ }
+
+ return ARES_SUCCESS;
+}
+
+static ares_status_t ares_dns_write_rr_tlsa(ares__buf_t *buf,
+ const ares_dns_rr_t *rr,
+ ares__llist_t **namelist)
+{
+ ares_status_t status;
+ const unsigned char *data;
+ size_t len = 0;
+
+ (void)namelist;
+
+ /* CERT_USAGE */
+ status = ares_dns_write_rr_u8(buf, rr, ARES_RR_TLSA_CERT_USAGE);
+ if (status != ARES_SUCCESS) {
+ return status;
+ }
+
+ /* SELECTOR */
+ status = ares_dns_write_rr_u8(buf, rr, ARES_RR_TLSA_SELECTOR);
+ if (status != ARES_SUCCESS) {
+ return status;
+ }
+
+ /* MATCH */
+ status = ares_dns_write_rr_u8(buf, rr, ARES_RR_TLSA_MATCH);
+ if (status != ARES_SUCCESS) {
+ return status;
+ }
+
+ /* DATA -- binary, rest of buffer, required to be non-zero length */
+ data = ares_dns_rr_get_bin(rr, ARES_RR_TLSA_DATA, &len);
+ if (data == NULL || len == 0) {
+ return ARES_EFORMERR;
+ }
+
+ return ares__buf_append(buf, data, len);
+}
+
+static ares_status_t ares_dns_write_rr_svcb(ares__buf_t *buf,
+ const ares_dns_rr_t *rr,
+ ares__llist_t **namelist)
+{
+ ares_status_t status;
+ size_t i;
+
+ /* PRIORITY */
+ status = ares_dns_write_rr_be16(buf, rr, ARES_RR_SVCB_PRIORITY);
+ if (status != ARES_SUCCESS) {
+ return status;
+ }
+
+ /* TARGET */
+ status =
+ ares_dns_write_rr_name(buf, rr, namelist, ARES_FALSE, ARES_RR_SVCB_TARGET);
+ if (status != ARES_SUCCESS) {
+ return status;
+ }
+
+ /* Append Params */
+ for (i = 0; i < ares_dns_rr_get_opt_cnt(rr, ARES_RR_SVCB_PARAMS); i++) {
+ unsigned short opt;
+ size_t val_len;
+ const unsigned char *val;
+
+ opt = ares_dns_rr_get_opt(rr, ARES_RR_SVCB_PARAMS, i, &val, &val_len);
+
+ /* BE16 option */
+ status = ares__buf_append_be16(buf, opt);
+ if (status != ARES_SUCCESS) {
+ return status;
+ }
+
+ /* BE16 length */
+ status = ares__buf_append_be16(buf, (unsigned short)(val_len & 0xFFFF));
+ if (status != ARES_SUCCESS) {
+ return status;
+ }
+
+ /* Value */
+ if (val && val_len) {
+ status = ares__buf_append(buf, val, val_len);
+ if (status != ARES_SUCCESS) {
+ return status;
+ }
+ }
+ }
+ return ARES_SUCCESS;
+}
+
+static ares_status_t ares_dns_write_rr_https(ares__buf_t *buf,
+ const ares_dns_rr_t *rr,
+ ares__llist_t **namelist)
+{
+ ares_status_t status;
+ size_t i;
+
+ /* PRIORITY */
+ status = ares_dns_write_rr_be16(buf, rr, ARES_RR_HTTPS_PRIORITY);
+ if (status != ARES_SUCCESS) {
+ return status;
+ }
+
+ /* TARGET */
+ status =
+ ares_dns_write_rr_name(buf, rr, namelist, ARES_FALSE, ARES_RR_HTTPS_TARGET);
+ if (status != ARES_SUCCESS) {
+ return status;
+ }
+
+ /* Append Params */
+ for (i = 0; i < ares_dns_rr_get_opt_cnt(rr, ARES_RR_HTTPS_PARAMS); i++) {
+ unsigned short opt;
+ size_t val_len;
+ const unsigned char *val;
+
+ opt = ares_dns_rr_get_opt(rr, ARES_RR_HTTPS_PARAMS, i, &val, &val_len);
+
+ /* BE16 option */
+ status = ares__buf_append_be16(buf, opt);
+ if (status != ARES_SUCCESS) {
+ return status;
+ }
+
+ /* BE16 length */
+ status = ares__buf_append_be16(buf, (unsigned short)(val_len & 0xFFFF));
+ if (status != ARES_SUCCESS) {
+ return status;
+ }
+
+ /* Value */
+ if (val && val_len) {
+ status = ares__buf_append(buf, val, val_len);
+ if (status != ARES_SUCCESS) {
+ return status;
+ }
+ }
+ }
+ return ARES_SUCCESS;
+}
+
+static ares_status_t ares_dns_write_rr_uri(ares__buf_t *buf,
+ const ares_dns_rr_t *rr,
+ ares__llist_t **namelist)
+{
+ ares_status_t status;
+ const char *target;
+
+ (void)namelist;
+
+ /* PRIORITY */
+ status = ares_dns_write_rr_be16(buf, rr, ARES_RR_URI_PRIORITY);
+ if (status != ARES_SUCCESS) {
+ return status;
+ }
+
+ /* WEIGHT */
+ status = ares_dns_write_rr_be16(buf, rr, ARES_RR_URI_WEIGHT);
+ if (status != ARES_SUCCESS) {
+ return status;
+ }
+
+ /* TARGET -- not in DNS string format, rest of buffer, required to be
+ * non-zero length */
+ target = ares_dns_rr_get_str(rr, ARES_RR_URI_TARGET);
+ if (target == NULL || ares_strlen(target) == 0) {
+ return ARES_EFORMERR;
+ }
+
+ return ares__buf_append(buf, (const unsigned char *)target,
+ ares_strlen(target));
+}
+
+static ares_status_t ares_dns_write_rr_caa(ares__buf_t *buf,
+ const ares_dns_rr_t *rr,
+ ares__llist_t **namelist)
+{
+ const unsigned char *data = NULL;
+ size_t data_len = 0;
+ ares_status_t status;
+
+ (void)namelist;
+
+ /* CRITICAL */
+ status = ares_dns_write_rr_u8(buf, rr, ARES_RR_CAA_CRITICAL);
+ if (status != ARES_SUCCESS) {
+ return status;
+ }
+
+ /* Tag */
+ status = ares_dns_write_rr_str(buf, rr, ARES_RR_CAA_TAG);
+ if (status != ARES_SUCCESS) {
+ return status;
+ }
+
+ /* Value - binary! (remaining buffer */
+ data = ares_dns_rr_get_bin(rr, ARES_RR_CAA_VALUE, &data_len);
+ if (data == NULL || data_len == 0) {
+ return ARES_EFORMERR;
+ }
+
+ return ares__buf_append(buf, data, data_len);
+}
+
+static ares_status_t ares_dns_write_rr_raw_rr(ares__buf_t *buf,
+ const ares_dns_rr_t *rr,
+ ares__llist_t **namelist)
+{
+ size_t len = ares__buf_len(buf);
+ ares_status_t status;
+ const unsigned char *data = NULL;
+ size_t data_len = 0;
+
+ (void)namelist;
+
+ /* We need to go back and overwrite the type that was emitted by the parent
+ * function */
+ status = ares__buf_set_length(buf, len - 2 /* RDLENGTH */
+ - 4 /* TTL */
+ - 2 /* CLASS */
+ - 2 /* TYPE */);
+ if (status != ARES_SUCCESS) {
+ return status;
+ }
+
+ status = ares_dns_write_rr_be16(buf, rr, ARES_RR_RAW_RR_TYPE);
+ if (status != ARES_SUCCESS) {
+ return status;
+ }
+
+ /* Now go back to real end */
+ status = ares__buf_set_length(buf, len);
+ if (status != ARES_SUCCESS) {
+ return status;
+ }
+
+ /* Output raw data */
+ data = ares_dns_rr_get_bin(rr, ARES_RR_RAW_RR_DATA, &data_len);
+ if (data == NULL) {
+ return ARES_EFORMERR;
+ }
+
+ if (data_len == 0) {
+ return ARES_SUCCESS;
+ }
+
+ return ares__buf_append(buf, data, data_len);
+}
+
+static ares_status_t ares_dns_write_rr(ares_dns_record_t *dnsrec,
+ ares__llist_t **namelist,
+ ares_dns_section_t section,
+ ares__buf_t *buf)
+{
+ size_t i;
+
+ for (i = 0; i < ares_dns_record_rr_cnt(dnsrec, section); i++) {
+ const ares_dns_rr_t *rr;
+ ares_dns_rec_type_t type;
+ ares_bool_t allow_compress;
+ ares__llist_t **namelistptr = NULL;
+ size_t pos_len;
+ ares_status_t status;
+ size_t rdlength;
+ size_t end_length;
+ unsigned int ttl;
+
+ rr = ares_dns_record_rr_get(dnsrec, section, i);
+ if (rr == NULL) {
+ return ARES_EFORMERR;
+ }
+
+ type = ares_dns_rr_get_type(rr);
+ allow_compress = ares_dns_rec_type_allow_name_compression(type);
+ if (allow_compress) {
+ namelistptr = namelist;
+ }
+
+ /* Name */
+ status =
+ ares__dns_name_write(buf, namelist, ARES_TRUE, ares_dns_rr_get_name(rr));
+ if (status != ARES_SUCCESS) {
+ return status;
+ }
+
+ /* Type */
+ status = ares__buf_append_be16(buf, (unsigned short)type);
+ if (status != ARES_SUCCESS) {
+ return status;
+ }
+
+ /* Class */
+ status =
+ ares__buf_append_be16(buf, (unsigned short)ares_dns_rr_get_class(rr));
+ if (status != ARES_SUCCESS) {
+ return status;
+ }
+
+ /* TTL */
+ ttl = ares_dns_rr_get_ttl(rr);
+ if (rr->parent->ttl_decrement > ttl) {
+ ttl = 0;
+ } else {
+ ttl -= rr->parent->ttl_decrement;
+ }
+ status = ares__buf_append_be32(buf, ttl);
+ if (status != ARES_SUCCESS) {
+ return status;
+ }
+
+ /* Length */
+ pos_len = ares__buf_len(buf); /* Save to write real length later */
+ status = ares__buf_append_be16(buf, 0);
+ if (status != ARES_SUCCESS) {
+ return status;
+ }
+
+ /* Data */
+ switch (type) {
+ case ARES_REC_TYPE_A:
+ status = ares_dns_write_rr_a(buf, rr, namelistptr);
+ break;
+ case ARES_REC_TYPE_NS:
+ status = ares_dns_write_rr_ns(buf, rr, namelistptr);
+ break;
+ case ARES_REC_TYPE_CNAME:
+ status = ares_dns_write_rr_cname(buf, rr, namelistptr);
+ break;
+ case ARES_REC_TYPE_SOA:
+ status = ares_dns_write_rr_soa(buf, rr, namelistptr);
+ break;
+ case ARES_REC_TYPE_PTR:
+ status = ares_dns_write_rr_ptr(buf, rr, namelistptr);
+ break;
+ case ARES_REC_TYPE_HINFO:
+ status = ares_dns_write_rr_hinfo(buf, rr, namelistptr);
+ break;
+ case ARES_REC_TYPE_MX:
+ status = ares_dns_write_rr_mx(buf, rr, namelistptr);
+ break;
+ case ARES_REC_TYPE_TXT:
+ status = ares_dns_write_rr_txt(buf, rr, namelistptr);
+ break;
+ case ARES_REC_TYPE_AAAA:
+ status = ares_dns_write_rr_aaaa(buf, rr, namelistptr);
+ break;
+ case ARES_REC_TYPE_SRV:
+ status = ares_dns_write_rr_srv(buf, rr, namelistptr);
+ break;
+ case ARES_REC_TYPE_NAPTR:
+ status = ares_dns_write_rr_naptr(buf, rr, namelistptr);
+ break;
+ case ARES_REC_TYPE_ANY:
+ status = ARES_EFORMERR;
+ break;
+ case ARES_REC_TYPE_OPT:
+ status = ares_dns_write_rr_opt(buf, rr, namelistptr);
+ break;
+ case ARES_REC_TYPE_TLSA:
+ status = ares_dns_write_rr_tlsa(buf, rr, namelistptr);
+ break;
+ case ARES_REC_TYPE_SVCB:
+ status = ares_dns_write_rr_svcb(buf, rr, namelistptr);
+ break;
+ case ARES_REC_TYPE_HTTPS:
+ status = ares_dns_write_rr_https(buf, rr, namelistptr);
+ break;
+ case ARES_REC_TYPE_URI:
+ status = ares_dns_write_rr_uri(buf, rr, namelistptr);
+ break;
+ case ARES_REC_TYPE_CAA:
+ status = ares_dns_write_rr_caa(buf, rr, namelistptr);
+ break;
+ case ARES_REC_TYPE_RAW_RR:
+ status = ares_dns_write_rr_raw_rr(buf, rr, namelistptr);
+ break;
+ }
+
+ if (status != ARES_SUCCESS) {
+ return status;
+ }
+
+ /* Back off write pointer, write real length, then go back to proper
+ * position */
+ end_length = ares__buf_len(buf);
+ rdlength = end_length - pos_len - 2;
+
+ status = ares__buf_set_length(buf, pos_len);
+ if (status != ARES_SUCCESS) {
+ return status;
+ }
+
+ status = ares__buf_append_be16(buf, (unsigned short)(rdlength & 0xFFFF));
+ if (status != ARES_SUCCESS) {
+ return status;
+ }
+
+ status = ares__buf_set_length(buf, end_length);
+ if (status != ARES_SUCCESS) {
+ return status;
+ }
+ }
+
+ return ARES_SUCCESS;
+}
+
+ares_status_t ares_dns_write(ares_dns_record_t *dnsrec, unsigned char **buf,
+ size_t *buf_len)
+{
+ ares__buf_t *b = NULL;
+ ares_status_t status;
+ ares__llist_t *namelist = NULL;
+
+ if (buf == NULL || buf_len == NULL || dnsrec == NULL) {
+ return ARES_EFORMERR;
+ }
+
+ *buf = NULL;
+ *buf_len = 0;
+
+ b = ares__buf_create();
+ if (b == NULL) {
+ return ARES_ENOMEM;
+ }
+
+ status = ares_dns_write_header(dnsrec, b);
+ if (status != ARES_SUCCESS) {
+ goto done;
+ }
+
+ status = ares_dns_write_questions(dnsrec, &namelist, b);
+ if (status != ARES_SUCCESS) {
+ goto done;
+ }
+
+ status = ares_dns_write_rr(dnsrec, &namelist, ARES_SECTION_ANSWER, b);
+ if (status != ARES_SUCCESS) {
+ goto done;
+ }
+
+ status = ares_dns_write_rr(dnsrec, &namelist, ARES_SECTION_AUTHORITY, b);
+ if (status != ARES_SUCCESS) {
+ goto done;
+ }
+
+ status = ares_dns_write_rr(dnsrec, &namelist, ARES_SECTION_ADDITIONAL, b);
+ if (status != ARES_SUCCESS) {
+ goto done;
+ }
+
+done:
+ ares__llist_destroy(namelist);
+
+ if (status != ARES_SUCCESS) {
+ ares__buf_destroy(b);
+ return status;
+ }
+
+ *buf = ares__buf_finish_bin(b, buf_len);
+ return status;
+}
+
+void ares_dns_record_write_ttl_decrement(ares_dns_record_t *dnsrec,
+ unsigned int ttl_decrement)
+{
+ if (dnsrec == NULL) {
+ return;
+ }
+ dnsrec->ttl_decrement = ttl_decrement;
+}
diff --git a/subprojects/c-ares/src/lib/ares_expand_name.c b/subprojects/c-ares/src/lib/ares_expand_name.c
@@ -0,0 +1,118 @@
+/* MIT License
+ *
+ * Copyright (c) 1998, 2011 Massachusetts Institute of Technology
+ * Copyright (c) The c-ares project and its contributors
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice (including the next
+ * paragraph) shall be included in all copies or substantial portions of the
+ * Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ *
+ * SPDX-License-Identifier: MIT
+ */
+
+#include "ares_setup.h"
+
+#ifdef HAVE_NETINET_IN_H
+# include <netinet/in.h>
+#endif
+
+#include "ares_nameser.h"
+
+#include "ares.h"
+#include "ares_private.h" /* for the memdebug */
+
+ares_status_t ares__expand_name_validated(const unsigned char *encoded,
+ const unsigned char *abuf,
+ size_t alen, char **s, size_t *enclen,
+ ares_bool_t is_hostname)
+{
+ ares_status_t status;
+ ares__buf_t *buf = NULL;
+ size_t start_len;
+
+ if (encoded == NULL || abuf == NULL || alen == 0 || enclen == NULL) {
+ return ARES_EBADNAME; /* EFORMERR would be better */
+ }
+
+ if (encoded < abuf || encoded >= abuf + alen) {
+ return ARES_EBADNAME; /* EFORMERR would be better */
+ }
+
+ *enclen = 0;
+
+ /* NOTE: we allow 's' to be NULL to skip it */
+ if (s) {
+ *s = NULL;
+ }
+
+ buf = ares__buf_create_const(abuf, alen);
+
+ if (buf == NULL) {
+ return ARES_ENOMEM;
+ }
+
+ status = ares__buf_set_position(buf, (size_t)(encoded - abuf));
+ if (status != ARES_SUCCESS) {
+ goto done;
+ }
+
+ start_len = ares__buf_len(buf);
+ status = ares__dns_name_parse(buf, s, is_hostname);
+ if (status != ARES_SUCCESS) {
+ goto done;
+ }
+
+ *enclen = start_len - ares__buf_len(buf);
+
+done:
+ ares__buf_destroy(buf);
+ return status;
+}
+
+int ares_expand_name(const unsigned char *encoded, const unsigned char *abuf,
+ int alen, char **s, long *enclen)
+{
+ /* Keep public API compatible */
+ size_t enclen_temp = 0;
+ ares_status_t status;
+
+ if (alen < 0) {
+ return ARES_EBADRESP;
+ }
+
+ status = ares__expand_name_validated(encoded, abuf, (size_t)alen, s,
+ &enclen_temp, ARES_FALSE);
+ *enclen = (long)enclen_temp;
+ return (int)status;
+}
+
+/* Like ares_expand_name_validated but returns EBADRESP in case of invalid
+ * input. */
+ares_status_t ares__expand_name_for_response(const unsigned char *encoded,
+ const unsigned char *abuf,
+ size_t alen, char **s,
+ size_t *enclen,
+ ares_bool_t is_hostname)
+{
+ ares_status_t status =
+ ares__expand_name_validated(encoded, abuf, alen, s, enclen, is_hostname);
+ if (status == ARES_EBADNAME) {
+ status = ARES_EBADRESP;
+ }
+ return status;
+}
diff --git a/subprojects/c-ares/src/lib/ares_expand_string.c b/subprojects/c-ares/src/lib/ares_expand_string.c
@@ -0,0 +1,111 @@
+/* MIT License
+ *
+ * Copyright (c) 1998 Massachusetts Institute of Technology
+ * Copyright (c) The c-ares project and its contributors
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice (including the next
+ * paragraph) shall be included in all copies or substantial portions of the
+ * Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ *
+ * SPDX-License-Identifier: MIT
+ */
+
+#include "ares_setup.h"
+
+#ifdef HAVE_NETINET_IN_H
+# include <netinet/in.h>
+#endif
+
+#include "ares_nameser.h"
+
+#include "ares.h"
+#include "ares_private.h" /* for the memdebug */
+
+/* Simply decodes a length-encoded character string. The first byte of the
+ * input is the length of the string to be returned and the bytes thereafter
+ * are the characters of the string. The returned result will be NULL
+ * terminated.
+ */
+ares_status_t ares_expand_string_ex(const unsigned char *encoded,
+ const unsigned char *abuf, size_t alen,
+ unsigned char **s, size_t *enclen)
+{
+ ares_status_t status;
+ ares__buf_t *buf = NULL;
+ size_t start_len;
+ size_t len = 0;
+
+ if (encoded == NULL || abuf == NULL || alen == 0 || enclen == NULL) {
+ return ARES_EBADSTR; /* EFORMERR would be better */
+ }
+
+ if (encoded < abuf || encoded >= abuf + alen) {
+ return ARES_EBADSTR; /* EFORMERR would be better */
+ }
+
+ *enclen = 0;
+
+ /* NOTE: we allow 's' to be NULL to skip it */
+ if (s) {
+ *s = NULL;
+ }
+
+ buf = ares__buf_create_const(abuf, alen);
+
+ if (buf == NULL) {
+ return ARES_ENOMEM;
+ }
+
+ status = ares__buf_set_position(buf, (size_t)(encoded - abuf));
+ if (status != ARES_SUCCESS) {
+ goto done;
+ }
+
+ start_len = ares__buf_len(buf);
+ status =
+ ares__buf_parse_dns_binstr(buf, ares__buf_len(buf), s, &len, ARES_FALSE);
+ /* hrm, no way to pass back 'len' with the prototype */
+ if (status != ARES_SUCCESS) {
+ goto done;
+ }
+
+ *enclen = start_len - ares__buf_len(buf);
+
+done:
+ ares__buf_destroy(buf);
+ if (status == ARES_EBADNAME || status == ARES_EBADRESP) {
+ status = ARES_EBADSTR;
+ }
+ return status;
+}
+
+int ares_expand_string(const unsigned char *encoded, const unsigned char *abuf,
+ int alen, unsigned char **s, long *enclen)
+{
+ ares_status_t status;
+ size_t temp_enclen = 0;
+
+ if (alen < 0) {
+ return ARES_EBADRESP;
+ }
+
+ status = ares_expand_string_ex(encoded, abuf, (size_t)alen, s, &temp_enclen);
+
+ *enclen = (long)temp_enclen;
+ return (int)status;
+}
diff --git a/subprojects/c-ares/src/lib/ares_fds.c b/subprojects/c-ares/src/lib/ares_fds.c
@@ -0,0 +1,83 @@
+/* MIT License
+ *
+ * Copyright (c) 1998 Massachusetts Institute of Technology
+ * Copyright (c) The c-ares project and its contributors
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice (including the next
+ * paragraph) shall be included in all copies or substantial portions of the
+ * Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ *
+ * SPDX-License-Identifier: MIT
+ */
+
+#include "ares_setup.h"
+
+#include "ares.h"
+#include "ares_private.h"
+
+int ares_fds(ares_channel_t *channel, fd_set *read_fds, fd_set *write_fds)
+{
+ ares_socket_t nfds;
+ ares__slist_node_t *snode;
+ /* Are there any active queries? */
+ size_t active_queries;
+
+ if (channel == NULL || read_fds == NULL || write_fds == NULL) {
+ return 0;
+ }
+
+ ares__channel_lock(channel);
+
+ active_queries = ares__llist_len(channel->all_queries);
+
+ nfds = 0;
+ for (snode = ares__slist_node_first(channel->servers); snode != NULL;
+ snode = ares__slist_node_next(snode)) {
+ struct server_state *server = ares__slist_node_val(snode);
+ ares__llist_node_t *node;
+
+ for (node = ares__llist_node_first(server->connections); node != NULL;
+ node = ares__llist_node_next(node)) {
+ const struct server_connection *conn = ares__llist_node_val(node);
+
+ if (!active_queries && !conn->is_tcp) {
+ continue;
+ }
+
+ /* Silence coverity, shouldn't be possible */
+ if (conn->fd == ARES_SOCKET_BAD) {
+ continue;
+ }
+
+ /* Always wait on read */
+ FD_SET(conn->fd, read_fds);
+
+ if (conn->fd >= nfds) {
+ nfds = conn->fd + 1;
+ }
+
+ /* TCP only wait on write if we have buffered data */
+ if (conn->is_tcp && ares__buf_len(server->tcp_send)) {
+ FD_SET(conn->fd, write_fds);
+ }
+ }
+ }
+
+ ares__channel_unlock(channel);
+ return (int)nfds;
+}
diff --git a/subprojects/c-ares/src/lib/ares_free_hostent.c b/subprojects/c-ares/src/lib/ares_free_hostent.c
@@ -0,0 +1,57 @@
+/* MIT License
+ *
+ * Copyright (c) 1998 Massachusetts Institute of Technology
+ * Copyright (c) The c-ares project and its contributors
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice (including the next
+ * paragraph) shall be included in all copies or substantial portions of the
+ * Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ *
+ * SPDX-License-Identifier: MIT
+ */
+
+#include "ares_setup.h"
+
+#ifdef HAVE_NETDB_H
+# include <netdb.h>
+#endif
+
+#include "ares.h"
+#include "ares_private.h" /* for memdebug */
+
+void ares_free_hostent(struct hostent *host)
+{
+ char **p;
+
+ if (!host) {
+ return;
+ }
+
+ ares_free(host->h_name);
+ for (p = host->h_aliases; p && *p; p++) {
+ ares_free(*p);
+ }
+ ares_free(host->h_aliases);
+ if (host->h_addr_list) {
+ ares_free(
+ host->h_addr_list[0]); /* no matter if there is one or many entries,
+ there is only one malloc for all of them */
+ ares_free(host->h_addr_list);
+ }
+ ares_free(host);
+}
diff --git a/subprojects/c-ares/src/lib/ares_free_string.c b/subprojects/c-ares/src/lib/ares_free_string.c
@@ -0,0 +1,36 @@
+/* MIT License
+ *
+ * Copyright (c) 2000 Massachusetts Institute of Technology
+ * Copyright (c) The c-ares project and its contributors
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice (including the next
+ * paragraph) shall be included in all copies or substantial portions of the
+ * Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ *
+ * SPDX-License-Identifier: MIT
+ */
+
+#include "ares_setup.h"
+
+#include "ares.h"
+#include "ares_private.h"
+
+void ares_free_string(void *str)
+{
+ ares_free(str);
+}
diff --git a/subprojects/c-ares/src/lib/ares_freeaddrinfo.c b/subprojects/c-ares/src/lib/ares_freeaddrinfo.c
@@ -0,0 +1,70 @@
+/* MIT License
+ *
+ * Copyright (c) 1998 Massachusetts Institute of Technology
+ * Copyright (c) 2019 Andrew Selivanov
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice (including the next
+ * paragraph) shall be included in all copies or substantial portions of the
+ * Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ *
+ * SPDX-License-Identifier: MIT
+ */
+
+#include "ares_setup.h"
+
+#ifdef HAVE_NETDB_H
+# include <netdb.h>
+#endif
+
+#include "ares.h"
+#include "ares_private.h"
+
+void ares__freeaddrinfo_cnames(struct ares_addrinfo_cname *head)
+{
+ struct ares_addrinfo_cname *current;
+ while (head) {
+ current = head;
+ head = head->next;
+ ares_free(current->alias);
+ ares_free(current->name);
+ ares_free(current);
+ }
+}
+
+void ares__freeaddrinfo_nodes(struct ares_addrinfo_node *head)
+{
+ struct ares_addrinfo_node *current;
+ while (head) {
+ current = head;
+ head = head->ai_next;
+ ares_free(current->ai_addr);
+ ares_free(current);
+ }
+}
+
+void ares_freeaddrinfo(struct ares_addrinfo *ai)
+{
+ if (ai == NULL) {
+ return;
+ }
+ ares__freeaddrinfo_cnames(ai->cnames);
+ ares__freeaddrinfo_nodes(ai->nodes);
+
+ ares_free(ai->name);
+ ares_free(ai);
+}
diff --git a/subprojects/c-ares/src/lib/ares_getaddrinfo.c b/subprojects/c-ares/src/lib/ares_getaddrinfo.c
@@ -0,0 +1,776 @@
+/* MIT License
+ *
+ * Copyright (c) 1998, 2011, 2013 Massachusetts Institute of Technology
+ * Copyright (c) 2017 Christian Ammer
+ * Copyright (c) 2019 Andrew Selivanov
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice (including the next
+ * paragraph) shall be included in all copies or substantial portions of the
+ * Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ *
+ * SPDX-License-Identifier: MIT
+ */
+
+#include "ares_setup.h"
+
+#ifdef HAVE_GETSERVBYNAME_R
+# if !defined(GETSERVBYNAME_R_ARGS) || (GETSERVBYNAME_R_ARGS < 4) || \
+ (GETSERVBYNAME_R_ARGS > 6)
+# error "you MUST specify a valid number of arguments for getservbyname_r"
+# endif
+#endif
+
+#ifdef HAVE_NETINET_IN_H
+# include <netinet/in.h>
+#endif
+#ifdef HAVE_NETDB_H
+# include <netdb.h>
+#endif
+#ifdef HAVE_ARPA_INET_H
+# include <arpa/inet.h>
+#endif
+
+#include "ares_nameser.h"
+
+#ifdef HAVE_STRINGS_H
+# include <strings.h>
+#endif
+#include <assert.h>
+
+#ifdef HAVE_LIMITS_H
+# include <limits.h>
+#endif
+
+#include "ares.h"
+#include "ares_private.h"
+#include "ares_dns.h"
+
+#ifdef WATT32
+# undef WIN32
+#endif
+#ifdef WIN32
+# include "ares_platform.h"
+#endif
+
+struct host_query {
+ ares_channel_t *channel;
+ char *name;
+ unsigned short port; /* in host order */
+ ares_addrinfo_callback callback;
+ void *arg;
+ struct ares_addrinfo_hints hints;
+ int sent_family; /* this family is what was is being used */
+ size_t timeouts; /* number of timeouts we saw for this request */
+ char *lookups; /* Duplicate memory from channel because of ares_reinit() */
+ const char *remaining_lookups; /* types of lookup we need to perform ("fb" by
+ default, file and dns respectively) */
+ char **domains; /* duplicate from channel for ares_reinit() safety */
+ size_t ndomains;
+ struct ares_addrinfo *ai; /* store results between lookups */
+ unsigned short qid_a; /* qid for A request */
+ unsigned short qid_aaaa; /* qid for AAAA request */
+ size_t remaining; /* number of DNS answers waiting for */
+ ares_ssize_t next_domain; /* next search domain to try */
+ size_t
+ nodata_cnt; /* Track nodata responses to possibly override final result */
+};
+
+static const struct ares_addrinfo_hints default_hints = {
+ 0, /* ai_flags */
+ AF_UNSPEC, /* ai_family */
+ 0, /* ai_socktype */
+ 0, /* ai_protocol */
+};
+
+/* forward declarations */
+static void host_callback(void *arg, int status, int timeouts,
+ unsigned char *abuf, int alen);
+static ares_bool_t as_is_first(const struct host_query *hquery);
+static ares_bool_t as_is_only(const struct host_query *hquery);
+static ares_bool_t next_dns_lookup(struct host_query *hquery);
+
+struct ares_addrinfo_cname *
+ ares__append_addrinfo_cname(struct ares_addrinfo_cname **head)
+{
+ struct ares_addrinfo_cname *tail = ares_malloc_zero(sizeof(*tail));
+ struct ares_addrinfo_cname *last = *head;
+
+ if (tail == NULL) {
+ return NULL;
+ }
+
+ if (!last) {
+ *head = tail;
+ return tail;
+ }
+
+ while (last->next) {
+ last = last->next;
+ }
+
+ last->next = tail;
+ return tail;
+}
+
+void ares__addrinfo_cat_cnames(struct ares_addrinfo_cname **head,
+ struct ares_addrinfo_cname *tail)
+{
+ struct ares_addrinfo_cname *last = *head;
+ if (!last) {
+ *head = tail;
+ return;
+ }
+
+ while (last->next) {
+ last = last->next;
+ }
+
+ last->next = tail;
+}
+
+/* Allocate new addrinfo and append to the tail. */
+struct ares_addrinfo_node *
+ ares__append_addrinfo_node(struct ares_addrinfo_node **head)
+{
+ struct ares_addrinfo_node *tail = ares_malloc_zero(sizeof(*tail));
+ struct ares_addrinfo_node *last = *head;
+
+ if (tail == NULL) {
+ return NULL;
+ }
+
+ if (!last) {
+ *head = tail;
+ return tail;
+ }
+
+ while (last->ai_next) {
+ last = last->ai_next;
+ }
+
+ last->ai_next = tail;
+ return tail;
+}
+
+void ares__addrinfo_cat_nodes(struct ares_addrinfo_node **head,
+ struct ares_addrinfo_node *tail)
+{
+ struct ares_addrinfo_node *last = *head;
+ if (!last) {
+ *head = tail;
+ return;
+ }
+
+ while (last->ai_next) {
+ last = last->ai_next;
+ }
+
+ last->ai_next = tail;
+}
+
+/* Resolve service name into port number given in host byte order.
+ * If not resolved, return 0.
+ */
+static unsigned short lookup_service(const char *service, int flags)
+{
+ const char *proto;
+ struct servent *sep;
+#ifdef HAVE_GETSERVBYNAME_R
+ struct servent se;
+ char tmpbuf[4096];
+#endif
+
+ if (service) {
+ if (flags & ARES_NI_UDP) {
+ proto = "udp";
+ } else if (flags & ARES_NI_SCTP) {
+ proto = "sctp";
+ } else if (flags & ARES_NI_DCCP) {
+ proto = "dccp";
+ } else {
+ proto = "tcp";
+ }
+#ifdef HAVE_GETSERVBYNAME_R
+ memset(&se, 0, sizeof(se));
+ sep = &se;
+ memset(tmpbuf, 0, sizeof(tmpbuf));
+# if GETSERVBYNAME_R_ARGS == 6
+ if (getservbyname_r(service, proto, &se, (void *)tmpbuf, sizeof(tmpbuf),
+ &sep) != 0) {
+ sep = NULL; /* LCOV_EXCL_LINE: buffer large so this never fails */
+ }
+# elif GETSERVBYNAME_R_ARGS == 5
+ sep = getservbyname_r(service, proto, &se, (void *)tmpbuf, sizeof(tmpbuf));
+# elif GETSERVBYNAME_R_ARGS == 4
+ if (getservbyname_r(service, proto, &se, (void *)tmpbuf) != 0) {
+ sep = NULL;
+ }
+# else
+ /* Lets just hope the OS uses TLS! */
+ sep = getservbyname(service, proto);
+# endif
+#else
+ /* Lets just hope the OS uses TLS! */
+# if (defined(NETWARE) && !defined(__NOVELL_LIBC__))
+ sep = getservbyname(service, (char *)proto);
+# else
+ sep = getservbyname(service, proto);
+# endif
+#endif
+ return (sep ? ntohs((unsigned short)sep->s_port) : 0);
+ }
+ return 0;
+}
+
+/* If the name looks like an IP address or an error occurred,
+ * fake up a host entry, end the query immediately, and return true.
+ * Otherwise return false.
+ */
+static ares_bool_t fake_addrinfo(const char *name, unsigned short port,
+ const struct ares_addrinfo_hints *hints,
+ struct ares_addrinfo *ai,
+ ares_addrinfo_callback callback, void *arg)
+{
+ struct ares_addrinfo_cname *cname;
+ ares_status_t status = ARES_SUCCESS;
+ ares_bool_t result = ARES_FALSE;
+ int family = hints->ai_family;
+ if (family == AF_INET || family == AF_INET6 || family == AF_UNSPEC) {
+ /* It only looks like an IP address if it's all numbers and dots. */
+ size_t numdots = 0;
+ ares_bool_t valid = ARES_TRUE;
+ const char *p;
+ for (p = name; *p; p++) {
+ if (!ISDIGIT(*p) && *p != '.') {
+ valid = ARES_FALSE;
+ break;
+ } else if (*p == '.') {
+ numdots++;
+ }
+ }
+
+ /* if we don't have 3 dots, it is illegal
+ * (although inet_pton doesn't think so).
+ */
+ if (numdots != 3 || !valid) {
+ result = ARES_FALSE;
+ } else {
+ struct in_addr addr4;
+ result =
+ ares_inet_pton(AF_INET, name, &addr4) < 1 ? ARES_FALSE : ARES_TRUE;
+ if (result) {
+ status = ares_append_ai_node(AF_INET, port, 0, &addr4, &ai->nodes);
+ if (status != ARES_SUCCESS) {
+ callback(arg, (int)status, 0, NULL);
+ return ARES_TRUE;
+ }
+ }
+ }
+ }
+
+ if (!result && (family == AF_INET6 || family == AF_UNSPEC)) {
+ struct ares_in6_addr addr6;
+ result =
+ ares_inet_pton(AF_INET6, name, &addr6) < 1 ? ARES_FALSE : ARES_TRUE;
+ if (result) {
+ status = ares_append_ai_node(AF_INET6, port, 0, &addr6, &ai->nodes);
+ if (status != ARES_SUCCESS) {
+ callback(arg, (int)status, 0, NULL);
+ return ARES_TRUE;
+ }
+ }
+ }
+
+ if (!result) {
+ return ARES_FALSE;
+ }
+
+ if (hints->ai_flags & ARES_AI_CANONNAME) {
+ cname = ares__append_addrinfo_cname(&ai->cnames);
+ if (!cname) {
+ ares_freeaddrinfo(ai);
+ callback(arg, ARES_ENOMEM, 0, NULL);
+ return ARES_TRUE;
+ }
+
+ /* Duplicate the name, to avoid a constness violation. */
+ cname->name = ares_strdup(name);
+ if (!cname->name) {
+ ares_freeaddrinfo(ai);
+ callback(arg, ARES_ENOMEM, 0, NULL);
+ return ARES_TRUE;
+ }
+ }
+
+ ai->nodes->ai_socktype = hints->ai_socktype;
+ ai->nodes->ai_protocol = hints->ai_protocol;
+
+ callback(arg, ARES_SUCCESS, 0, ai);
+ return ARES_TRUE;
+}
+
+static void end_hquery(struct host_query *hquery, ares_status_t status)
+{
+ struct ares_addrinfo_node sentinel;
+ struct ares_addrinfo_node *next;
+
+ if (status == ARES_SUCCESS) {
+ if (!(hquery->hints.ai_flags & ARES_AI_NOSORT) && hquery->ai->nodes) {
+ sentinel.ai_next = hquery->ai->nodes;
+ ares__sortaddrinfo(hquery->channel, &sentinel);
+ hquery->ai->nodes = sentinel.ai_next;
+ }
+ next = hquery->ai->nodes;
+
+ while (next) {
+ next->ai_socktype = hquery->hints.ai_socktype;
+ next->ai_protocol = hquery->hints.ai_protocol;
+ next = next->ai_next;
+ }
+ } else {
+ /* Clean up what we have collected by so far. */
+ ares_freeaddrinfo(hquery->ai);
+ hquery->ai = NULL;
+ }
+
+ hquery->callback(hquery->arg, (int)status, (int)hquery->timeouts, hquery->ai);
+ ares__strsplit_free(hquery->domains, hquery->ndomains);
+ ares_free(hquery->lookups);
+ ares_free(hquery->name);
+ ares_free(hquery);
+}
+
+ares_bool_t ares__is_localhost(const char *name)
+{
+ /* RFC6761 6.3 says : The domain "localhost." and any names falling within
+ * ".localhost." */
+ size_t len;
+
+ if (name == NULL) {
+ return ARES_FALSE;
+ }
+
+ if (strcmp(name, "localhost") == 0) {
+ return ARES_TRUE;
+ }
+
+ len = ares_strlen(name);
+ if (len < 10 /* strlen(".localhost") */) {
+ return ARES_FALSE;
+ }
+
+ if (strcmp(name + (len - 10 /* strlen(".localhost") */), ".localhost") == 0) {
+ return ARES_TRUE;
+ }
+
+ return ARES_FALSE;
+}
+
+static ares_status_t file_lookup(struct host_query *hquery)
+{
+ const ares_hosts_entry_t *entry;
+ ares_status_t status;
+
+ /* Per RFC 7686, reject queries for ".onion" domain names with NXDOMAIN. */
+ if (ares__is_onion_domain(hquery->name)) {
+ return ARES_ENOTFOUND;
+ }
+
+ status = ares__hosts_search_host(
+ hquery->channel,
+ (hquery->hints.ai_flags & ARES_AI_ENVHOSTS) ? ARES_TRUE : ARES_FALSE,
+ hquery->name, &entry);
+
+ if (status != ARES_SUCCESS) {
+ goto done;
+ }
+
+ status = ares__hosts_entry_to_addrinfo(
+ entry, hquery->name, hquery->hints.ai_family, hquery->port,
+ (hquery->hints.ai_flags & ARES_AI_CANONNAME) ? ARES_TRUE : ARES_FALSE,
+ hquery->ai);
+
+ if (status != ARES_SUCCESS) {
+ goto done;
+ }
+
+
+done:
+ /* RFC6761 section 6.3 #3 states that "Name resolution APIs and libraries
+ * SHOULD recognize localhost names as special and SHOULD always return the
+ * IP loopback address for address queries".
+ * We will also ignore ALL errors when trying to resolve localhost, such
+ * as permissions errors reading /etc/hosts or a malformed /etc/hosts */
+ if (status != ARES_SUCCESS && status != ARES_ENOMEM &&
+ ares__is_localhost(hquery->name)) {
+ return ares__addrinfo_localhost(hquery->name, hquery->port, &hquery->hints,
+ hquery->ai);
+ }
+
+ return status;
+}
+
+static void next_lookup(struct host_query *hquery, ares_status_t status)
+{
+ switch (*hquery->remaining_lookups) {
+ case 'b':
+ /* RFC6761 section 6.3 #3 says "Name resolution APIs SHOULD NOT send
+ * queries for localhost names to their configured caching DNS
+ * server(s)."
+ * Otherwise, DNS lookup. */
+ if (!ares__is_localhost(hquery->name) && next_dns_lookup(hquery)) {
+ break;
+ }
+
+ hquery->remaining_lookups++;
+ next_lookup(hquery, status);
+ break;
+
+ case 'f':
+ /* Host file lookup */
+ if (file_lookup(hquery) == ARES_SUCCESS) {
+ end_hquery(hquery, ARES_SUCCESS);
+ break;
+ }
+ hquery->remaining_lookups++;
+ next_lookup(hquery, status);
+ break;
+ default:
+ /* No lookup left */
+ end_hquery(hquery, status);
+ break;
+ }
+}
+
+static void terminate_retries(const struct host_query *hquery,
+ unsigned short qid)
+{
+ unsigned short term_qid =
+ (qid == hquery->qid_a) ? hquery->qid_aaaa : hquery->qid_a;
+ const ares_channel_t *channel = hquery->channel;
+ struct query *query = NULL;
+
+ /* No other outstanding queries, nothing to do */
+ if (!hquery->remaining) {
+ return;
+ }
+
+ query = ares__htable_szvp_get_direct(channel->queries_by_qid, term_qid);
+ if (query == NULL) {
+ return;
+ }
+
+ query->no_retries = ARES_TRUE;
+}
+
+static void host_callback(void *arg, int status, int timeouts,
+ unsigned char *abuf, int alen)
+{
+ struct host_query *hquery = (struct host_query *)arg;
+ ares_status_t addinfostatus = ARES_SUCCESS;
+ unsigned short qid = 0;
+ hquery->timeouts += (size_t)timeouts;
+ hquery->remaining--;
+
+ if (status == ARES_SUCCESS) {
+ if (alen < 0) {
+ addinfostatus = ARES_EBADRESP;
+ } else {
+ addinfostatus = ares__parse_into_addrinfo(abuf, (size_t)alen, ARES_TRUE,
+ hquery->port, hquery->ai);
+ }
+ if (addinfostatus == ARES_SUCCESS && alen >= HFIXEDSZ) {
+ qid = DNS_HEADER_QID(abuf); /* Converts to host byte order */
+ terminate_retries(hquery, qid);
+ }
+ }
+
+ if (!hquery->remaining) {
+ if (status == ARES_EDESTRUCTION || status == ARES_ECANCELLED) {
+ /* must make sure we don't do next_lookup() on destroy or cancel,
+ * and return the appropriate status. We won't return a partial
+ * result in this case. */
+ end_hquery(hquery, (ares_status_t)status);
+ } else if (addinfostatus != ARES_SUCCESS && addinfostatus != ARES_ENODATA) {
+ /* error in parsing result e.g. no memory */
+ if (addinfostatus == ARES_EBADRESP && hquery->ai->nodes) {
+ /* We got a bad response from server, but at least one query
+ * ended with ARES_SUCCESS */
+ end_hquery(hquery, ARES_SUCCESS);
+ } else {
+ end_hquery(hquery, addinfostatus);
+ }
+ } else if (hquery->ai->nodes) {
+ /* at least one query ended with ARES_SUCCESS */
+ end_hquery(hquery, ARES_SUCCESS);
+ } else if (status == ARES_ENOTFOUND || status == ARES_ENODATA ||
+ addinfostatus == ARES_ENODATA) {
+ if (status == ARES_ENODATA || addinfostatus == ARES_ENODATA) {
+ hquery->nodata_cnt++;
+ }
+ next_lookup(hquery,
+ hquery->nodata_cnt ? ARES_ENODATA : (ares_status_t)status);
+ } else {
+ end_hquery(hquery, (ares_status_t)status);
+ }
+ }
+
+ /* at this point we keep on waiting for the next query to finish */
+}
+
+static void ares_getaddrinfo_int(ares_channel_t *channel, const char *name,
+ const char *service,
+ const struct ares_addrinfo_hints *hints,
+ ares_addrinfo_callback callback, void *arg)
+{
+ struct host_query *hquery;
+ unsigned short port = 0;
+ int family;
+ struct ares_addrinfo *ai;
+ char *alias_name = NULL;
+ ares_status_t status;
+
+ if (!hints) {
+ hints = &default_hints;
+ }
+
+ family = hints->ai_family;
+
+ /* Right now we only know how to look up Internet addresses
+ and unspec means try both basically. */
+ if (family != AF_INET && family != AF_INET6 && family != AF_UNSPEC) {
+ callback(arg, ARES_ENOTIMP, 0, NULL);
+ return;
+ }
+
+ if (ares__is_onion_domain(name)) {
+ callback(arg, ARES_ENOTFOUND, 0, NULL);
+ return;
+ }
+
+ /* perform HOSTALIAS resolution (technically this function does some other
+ * things we are going to ignore) */
+ status = ares__single_domain(channel, name, &alias_name);
+ if (status != ARES_SUCCESS) {
+ callback(arg, (int)status, 0, NULL);
+ return;
+ }
+
+ if (alias_name) {
+ name = alias_name;
+ }
+
+ if (service) {
+ if (hints->ai_flags & ARES_AI_NUMERICSERV) {
+ unsigned long val;
+ errno = 0;
+ val = strtoul(service, NULL, 0);
+ if ((val == 0 && errno != 0) || val > 65535) {
+ ares_free(alias_name);
+ callback(arg, ARES_ESERVICE, 0, NULL);
+ return;
+ }
+ port = (unsigned short)val;
+ } else {
+ port = lookup_service(service, 0);
+ if (!port) {
+ unsigned long val;
+ errno = 0;
+ val = strtoul(service, NULL, 0);
+ if ((val == 0 && errno != 0) || val > 65535) {
+ ares_free(alias_name);
+ callback(arg, ARES_ESERVICE, 0, NULL);
+ return;
+ }
+ port = (unsigned short)val;
+ }
+ }
+ }
+
+ ai = ares_malloc_zero(sizeof(*ai));
+ if (!ai) {
+ ares_free(alias_name);
+ callback(arg, ARES_ENOMEM, 0, NULL);
+ return;
+ }
+
+ if (fake_addrinfo(name, port, hints, ai, callback, arg)) {
+ ares_free(alias_name);
+ return;
+ }
+
+ /* Allocate and fill in the host query structure. */
+ hquery = ares_malloc_zero(sizeof(*hquery));
+ if (!hquery) {
+ ares_free(alias_name);
+ ares_freeaddrinfo(ai);
+ callback(arg, ARES_ENOMEM, 0, NULL);
+ return;
+ }
+ memset(hquery, 0, sizeof(*hquery));
+ hquery->name = ares_strdup(name);
+ ares_free(alias_name);
+ if (!hquery->name) {
+ ares_free(hquery);
+ ares_freeaddrinfo(ai);
+ callback(arg, ARES_ENOMEM, 0, NULL);
+ return;
+ }
+ hquery->lookups = ares_strdup(channel->lookups);
+ if (!hquery->lookups) {
+ ares_free(hquery->name);
+ ares_free(hquery);
+ ares_freeaddrinfo(ai);
+ callback(arg, ARES_ENOMEM, 0, NULL);
+ return;
+ }
+
+ if (channel->ndomains) {
+ /* Duplicate for ares_reinit() safety */
+ hquery->domains =
+ ares__strsplit_duplicate(channel->domains, channel->ndomains);
+ if (hquery->domains == NULL) {
+ ares_free(hquery->lookups);
+ ares_free(hquery->name);
+ ares_free(hquery);
+ ares_freeaddrinfo(ai);
+ callback(arg, ARES_ENOMEM, 0, NULL);
+ return;
+ }
+ hquery->ndomains = channel->ndomains;
+ }
+
+ hquery->port = port;
+ hquery->channel = channel;
+ hquery->hints = *hints;
+ hquery->sent_family = -1; /* nothing is sent yet */
+ hquery->callback = callback;
+ hquery->arg = arg;
+ hquery->remaining_lookups = hquery->lookups;
+ hquery->ai = ai;
+ hquery->next_domain = -1;
+
+ /* Start performing lookups according to channel->lookups. */
+ next_lookup(hquery, ARES_ECONNREFUSED /* initial error code */);
+}
+
+void ares_getaddrinfo(ares_channel_t *channel, const char *name,
+ const char *service,
+ const struct ares_addrinfo_hints *hints,
+ ares_addrinfo_callback callback, void *arg)
+{
+ if (channel == NULL) {
+ return;
+ }
+ ares__channel_lock(channel);
+ ares_getaddrinfo_int(channel, name, service, hints, callback, arg);
+ ares__channel_unlock(channel);
+}
+
+static ares_bool_t next_dns_lookup(struct host_query *hquery)
+{
+ char *s = NULL;
+ ares_bool_t is_s_allocated = ARES_FALSE;
+ ares_status_t status;
+
+ /* if next_domain == -1 and as_is_first is true, try hquery->name */
+ if (hquery->next_domain == -1) {
+ if (as_is_first(hquery)) {
+ s = hquery->name;
+ }
+ hquery->next_domain = 0;
+ }
+
+ /* if as_is_first is false, try hquery->name at last */
+ if (!s && (size_t)hquery->next_domain == hquery->ndomains) {
+ if (!as_is_first(hquery)) {
+ s = hquery->name;
+ }
+ hquery->next_domain++;
+ }
+
+ if (!s && (size_t)hquery->next_domain < hquery->ndomains &&
+ !as_is_only(hquery)) {
+ status = ares__cat_domain(hquery->name,
+ hquery->domains[hquery->next_domain++], &s);
+ if (status == ARES_SUCCESS) {
+ is_s_allocated = ARES_TRUE;
+ }
+ }
+
+ if (s) {
+ /* NOTE: hquery may be invalidated during the call to ares_query_qid(),
+ * so should not be referenced after this point */
+ switch (hquery->hints.ai_family) {
+ case AF_INET:
+ hquery->remaining += 1;
+ ares_query_qid(hquery->channel, s, C_IN, T_A, host_callback, hquery,
+ &hquery->qid_a);
+ break;
+ case AF_INET6:
+ hquery->remaining += 1;
+ ares_query_qid(hquery->channel, s, C_IN, T_AAAA, host_callback, hquery,
+ &hquery->qid_aaaa);
+ break;
+ case AF_UNSPEC:
+ hquery->remaining += 2;
+ ares_query_qid(hquery->channel, s, C_IN, T_A, host_callback, hquery,
+ &hquery->qid_a);
+ ares_query_qid(hquery->channel, s, C_IN, T_AAAA, host_callback, hquery,
+ &hquery->qid_aaaa);
+ break;
+ default:
+ break;
+ }
+ if (is_s_allocated) {
+ ares_free(s);
+ }
+ return ARES_TRUE;
+ } else {
+ assert(!hquery->ai->nodes);
+ return ARES_FALSE;
+ }
+}
+
+static ares_bool_t as_is_first(const struct host_query *hquery)
+{
+ const char *p;
+ size_t ndots = 0;
+ for (p = hquery->name; p && *p; p++) {
+ if (*p == '.') {
+ ndots++;
+ }
+ }
+ if (as_is_only(hquery)) {
+ /* prevent ARES_EBADNAME for valid FQDN, where ndots < channel->ndots */
+ return ARES_TRUE;
+ }
+ return ndots >= hquery->channel->ndots ? ARES_TRUE : ARES_FALSE;
+}
+
+static ares_bool_t as_is_only(const struct host_query *hquery)
+{
+ size_t nname = ares_strlen(hquery->name);
+ if (hquery->channel->flags & ARES_FLAG_NOSEARCH) {
+ return ARES_TRUE;
+ }
+ if (hquery->name != NULL && nname && hquery->name[nname - 1] == '.') {
+ return ARES_TRUE;
+ }
+ return ARES_FALSE;
+}
diff --git a/subprojects/c-ares/src/lib/ares_getenv.c b/subprojects/c-ares/src/lib/ares_getenv.c
@@ -0,0 +1,38 @@
+/* MIT License
+ *
+ * Copyright (c) 1998 Massachusetts Institute of Technology
+ * Copyright (c) The c-ares project and its contributors
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice (including the next
+ * paragraph) shall be included in all copies or substantial portions of the
+ * Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ *
+ * SPDX-License-Identifier: MIT
+ */
+
+#include "ares_setup.h"
+#include "ares_getenv.h"
+
+#ifndef HAVE_GETENV
+
+char *ares_getenv(const char *name)
+{
+ return NULL;
+}
+
+#endif
diff --git a/subprojects/c-ares/src/lib/ares_getenv.h b/subprojects/c-ares/src/lib/ares_getenv.h
@@ -0,0 +1,36 @@
+/* MIT License
+ *
+ * Copyright (c) 1998 Massachusetts Institute of Technology
+ * Copyright (c) The c-ares project and its contributors
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice (including the next
+ * paragraph) shall be included in all copies or substantial portions of the
+ * Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ *
+ * SPDX-License-Identifier: MIT
+ */
+#ifndef HEADER_CARES_GETENV_H
+#define HEADER_CARES_GETENV_H
+
+#include "ares_setup.h"
+
+#ifndef HAVE_GETENV
+extern char *ares_getenv(const char *name);
+#endif
+
+#endif /* HEADER_CARES_GETENV_H */
diff --git a/subprojects/c-ares/src/lib/ares_gethostbyaddr.c b/subprojects/c-ares/src/lib/ares_gethostbyaddr.c
@@ -0,0 +1,233 @@
+/* MIT License
+ *
+ * Copyright (c) 1998 Massachusetts Institute of Technology
+ * Copyright (c) The c-ares project and its contributors
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice (including the next
+ * paragraph) shall be included in all copies or substantial portions of the
+ * Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ *
+ * SPDX-License-Identifier: MIT
+ */
+
+#include "ares_setup.h"
+
+#ifdef HAVE_NETINET_IN_H
+# include <netinet/in.h>
+#endif
+#ifdef HAVE_NETDB_H
+# include <netdb.h>
+#endif
+#ifdef HAVE_ARPA_INET_H
+# include <arpa/inet.h>
+#endif
+
+#include "ares_nameser.h"
+
+#include "ares.h"
+#include "ares_inet_net_pton.h"
+#include "ares_platform.h"
+#include "ares_private.h"
+
+#ifdef WATT32
+# undef WIN32
+#endif
+
+struct addr_query {
+ /* Arguments passed to ares_gethostbyaddr() */
+ ares_channel_t *channel;
+ struct ares_addr addr;
+ ares_host_callback callback;
+ void *arg;
+ char *lookups; /* duplicate memory from channel for ares_reinit() */
+ const char *remaining_lookups;
+ size_t timeouts;
+};
+
+static void next_lookup(struct addr_query *aquery);
+static void addr_callback(void *arg, int status, int timeouts,
+ unsigned char *abuf, int alen);
+static void end_aquery(struct addr_query *aquery, ares_status_t status,
+ struct hostent *host);
+static ares_status_t file_lookup(ares_channel_t *channel,
+ const struct ares_addr *addr,
+ struct hostent **host);
+
+static void ares_gethostbyaddr_int(ares_channel_t *channel, const void *addr,
+ int addrlen, int family,
+ ares_host_callback callback, void *arg)
+{
+ struct addr_query *aquery;
+
+ if (family != AF_INET && family != AF_INET6) {
+ callback(arg, ARES_ENOTIMP, 0, NULL);
+ return;
+ }
+
+ if ((family == AF_INET && addrlen != sizeof(aquery->addr.addr.addr4)) ||
+ (family == AF_INET6 && addrlen != sizeof(aquery->addr.addr.addr6))) {
+ callback(arg, ARES_ENOTIMP, 0, NULL);
+ return;
+ }
+
+ aquery = ares_malloc(sizeof(struct addr_query));
+ if (!aquery) {
+ callback(arg, ARES_ENOMEM, 0, NULL);
+ return;
+ }
+ aquery->lookups = ares_strdup(channel->lookups);
+ if (aquery->lookups == NULL) {
+ ares_free(aquery);
+ callback(arg, ARES_ENOMEM, 0, NULL);
+ return;
+ }
+ aquery->channel = channel;
+ if (family == AF_INET) {
+ memcpy(&aquery->addr.addr.addr4, addr, sizeof(aquery->addr.addr.addr4));
+ } else {
+ memcpy(&aquery->addr.addr.addr6, addr, sizeof(aquery->addr.addr.addr6));
+ }
+ aquery->addr.family = family;
+ aquery->callback = callback;
+ aquery->arg = arg;
+ aquery->remaining_lookups = aquery->lookups;
+ aquery->timeouts = 0;
+
+ next_lookup(aquery);
+}
+
+void ares_gethostbyaddr(ares_channel_t *channel, const void *addr, int addrlen,
+ int family, ares_host_callback callback, void *arg)
+{
+ if (channel == NULL) {
+ return;
+ }
+ ares__channel_lock(channel);
+ ares_gethostbyaddr_int(channel, addr, addrlen, family, callback, arg);
+ ares__channel_unlock(channel);
+}
+
+static void next_lookup(struct addr_query *aquery)
+{
+ const char *p;
+ ares_status_t status;
+ struct hostent *host;
+ char *name;
+
+ for (p = aquery->remaining_lookups; *p; p++) {
+ switch (*p) {
+ case 'b':
+ name = ares_dns_addr_to_ptr(&aquery->addr);
+ if (name == NULL) {
+ end_aquery(aquery, ARES_ENOMEM, NULL);
+ return;
+ }
+ aquery->remaining_lookups = p + 1;
+ ares_query(aquery->channel, name, C_IN, T_PTR, addr_callback, aquery);
+ ares_free(name);
+ return;
+ case 'f':
+ status = file_lookup(aquery->channel, &aquery->addr, &host);
+
+ /* this status check below previously checked for !ARES_ENOTFOUND,
+ but we should not assume that this single error code is the one
+ that can occur, as that is in fact no longer the case */
+ if (status == ARES_SUCCESS) {
+ end_aquery(aquery, status, host);
+ return;
+ }
+ break;
+ default:
+ break;
+ }
+ }
+ end_aquery(aquery, ARES_ENOTFOUND, NULL);
+}
+
+static void addr_callback(void *arg, int status, int timeouts,
+ unsigned char *abuf, int alen)
+{
+ struct addr_query *aquery = (struct addr_query *)arg;
+ struct hostent *host;
+ size_t addrlen;
+
+ aquery->timeouts += (size_t)timeouts;
+ if (status == ARES_SUCCESS) {
+ if (aquery->addr.family == AF_INET) {
+ addrlen = sizeof(aquery->addr.addr.addr4);
+ status = ares_parse_ptr_reply(abuf, alen, &aquery->addr.addr.addr4,
+ (int)addrlen, AF_INET, &host);
+ } else {
+ addrlen = sizeof(aquery->addr.addr.addr6);
+ status = ares_parse_ptr_reply(abuf, alen, &aquery->addr.addr.addr6,
+ (int)addrlen, AF_INET6, &host);
+ }
+ end_aquery(aquery, (ares_status_t)status, host);
+ } else if (status == ARES_EDESTRUCTION || status == ARES_ECANCELLED) {
+ end_aquery(aquery, (ares_status_t)status, NULL);
+ } else {
+ next_lookup(aquery);
+ }
+}
+
+static void end_aquery(struct addr_query *aquery, ares_status_t status,
+ struct hostent *host)
+{
+ aquery->callback(aquery->arg, (int)status, (int)aquery->timeouts, host);
+ if (host) {
+ ares_free_hostent(host);
+ }
+ ares_free(aquery->lookups);
+ ares_free(aquery);
+}
+
+static ares_status_t file_lookup(ares_channel_t *channel,
+ const struct ares_addr *addr,
+ struct hostent **host)
+{
+ char ipaddr[INET6_ADDRSTRLEN];
+ const void *ptr = NULL;
+ const ares_hosts_entry_t *entry;
+ ares_status_t status;
+
+ if (addr->family == AF_INET) {
+ ptr = &addr->addr.addr4;
+ } else if (addr->family == AF_INET6) {
+ ptr = &addr->addr.addr6;
+ }
+
+ if (ptr == NULL) {
+ return ARES_ENOTFOUND;
+ }
+
+ if (!ares_inet_ntop(addr->family, ptr, ipaddr, sizeof(ipaddr))) {
+ return ARES_ENOTFOUND;
+ }
+
+ status = ares__hosts_search_ipaddr(channel, ARES_FALSE, ipaddr, &entry);
+ if (status != ARES_SUCCESS) {
+ return status;
+ }
+
+ status = ares__hosts_entry_to_hostent(entry, addr->family, host);
+ if (status != ARES_SUCCESS) {
+ return status;
+ }
+
+ return ARES_SUCCESS;
+}
diff --git a/subprojects/c-ares/src/lib/ares_gethostbyname.c b/subprojects/c-ares/src/lib/ares_gethostbyname.c
@@ -0,0 +1,330 @@
+/* MIT License
+ *
+ * Copyright (c) 1998, 2011, 2013 Massachusetts Institute of Technology
+ * Copyright (c) The c-ares project and its contributors
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice (including the next
+ * paragraph) shall be included in all copies or substantial portions of the
+ * Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ *
+ * SPDX-License-Identifier: MIT
+ */
+
+#include "ares_setup.h"
+
+#ifdef HAVE_NETINET_IN_H
+# include <netinet/in.h>
+#endif
+#ifdef HAVE_NETDB_H
+# include <netdb.h>
+#endif
+#ifdef HAVE_ARPA_INET_H
+# include <arpa/inet.h>
+#endif
+
+#include "ares_nameser.h"
+
+#ifdef HAVE_STRINGS_H
+# include <strings.h>
+#endif
+
+#include "ares.h"
+#include "ares_inet_net_pton.h"
+#include "ares_platform.h"
+#include "ares_private.h"
+
+static void sort_addresses(const struct hostent *host,
+ const struct apattern *sortlist, size_t nsort);
+static void sort6_addresses(const struct hostent *host,
+ const struct apattern *sortlist, size_t nsort);
+static size_t get_address_index(const struct in_addr *addr,
+ const struct apattern *sortlist, size_t nsort);
+static size_t get6_address_index(const struct ares_in6_addr *addr,
+ const struct apattern *sortlist, size_t nsort);
+
+struct host_query {
+ ares_host_callback callback;
+ void *arg;
+ ares_channel_t *channel;
+};
+
+static void ares_gethostbyname_callback(void *arg, int status, int timeouts,
+ struct ares_addrinfo *result)
+{
+ struct hostent *hostent = NULL;
+ struct host_query *ghbn_arg = arg;
+
+ if (status == ARES_SUCCESS) {
+ status = (int)ares__addrinfo2hostent(result, AF_UNSPEC, &hostent);
+ }
+
+ /* addrinfo2hostent will only return ENODATA if there are no addresses _and_
+ * no cname/aliases. However, gethostbyname will return ENODATA even if there
+ * is cname/alias data */
+ if (status == ARES_SUCCESS && hostent &&
+ (!hostent->h_addr_list || !hostent->h_addr_list[0])) {
+ status = ARES_ENODATA;
+ }
+
+ if (status == ARES_SUCCESS && ghbn_arg->channel->nsort && hostent) {
+ if (hostent->h_addrtype == AF_INET6) {
+ sort6_addresses(hostent, ghbn_arg->channel->sortlist,
+ ghbn_arg->channel->nsort);
+ }
+ if (hostent->h_addrtype == AF_INET) {
+ sort_addresses(hostent, ghbn_arg->channel->sortlist,
+ ghbn_arg->channel->nsort);
+ }
+ }
+
+ ghbn_arg->callback(ghbn_arg->arg, status, timeouts, hostent);
+
+ ares_freeaddrinfo(result);
+ ares_free(ghbn_arg);
+ ares_free_hostent(hostent);
+}
+
+void ares_gethostbyname(ares_channel_t *channel, const char *name, int family,
+ ares_host_callback callback, void *arg)
+{
+ const struct ares_addrinfo_hints hints = { ARES_AI_CANONNAME, family, 0, 0 };
+ struct host_query *ghbn_arg;
+
+ if (!callback) {
+ return;
+ }
+
+ ghbn_arg = ares_malloc(sizeof(*ghbn_arg));
+ if (!ghbn_arg) {
+ callback(arg, ARES_ENOMEM, 0, NULL);
+ return;
+ }
+
+ ghbn_arg->callback = callback;
+ ghbn_arg->arg = arg;
+ ghbn_arg->channel = channel;
+
+ /* NOTE: ares_getaddrinfo() locks the channel, we don't use the channel
+ * outside so no need to lock */
+ ares_getaddrinfo(channel, name, NULL, &hints, ares_gethostbyname_callback,
+ ghbn_arg);
+}
+
+static void sort_addresses(const struct hostent *host,
+ const struct apattern *sortlist, size_t nsort)
+{
+ struct in_addr a1;
+ struct in_addr a2;
+ int i1;
+ int i2;
+ size_t ind1;
+ size_t ind2;
+
+ /* This is a simple insertion sort, not optimized at all. i1 walks
+ * through the address list, with the loop invariant that everything
+ * to the left of i1 is sorted. In the loop body, the value at i1 is moved
+ * back through the list (via i2) until it is in sorted order.
+ */
+ for (i1 = 0; host->h_addr_list[i1]; i1++) {
+ memcpy(&a1, host->h_addr_list[i1], sizeof(struct in_addr));
+ ind1 = get_address_index(&a1, sortlist, nsort);
+ for (i2 = i1 - 1; i2 >= 0; i2--) {
+ memcpy(&a2, host->h_addr_list[i2], sizeof(struct in_addr));
+ ind2 = get_address_index(&a2, sortlist, nsort);
+ if (ind2 <= ind1) {
+ break;
+ }
+ memcpy(host->h_addr_list[i2 + 1], &a2, sizeof(struct in_addr));
+ }
+ memcpy(host->h_addr_list[i2 + 1], &a1, sizeof(struct in_addr));
+ }
+}
+
+/* Find the first entry in sortlist which matches addr. Return nsort
+ * if none of them match.
+ */
+static size_t get_address_index(const struct in_addr *addr,
+ const struct apattern *sortlist, size_t nsort)
+{
+ size_t i;
+ struct ares_addr aaddr;
+
+ memset(&aaddr, 0, sizeof(aaddr));
+ aaddr.family = AF_INET;
+ memcpy(&aaddr.addr.addr4, addr, 4);
+
+ for (i = 0; i < nsort; i++) {
+ if (sortlist[i].addr.family != AF_INET) {
+ continue;
+ }
+
+ if (ares__subnet_match(&aaddr, &sortlist[i].addr, sortlist[i].mask)) {
+ break;
+ }
+ }
+
+ return i;
+}
+
+static void sort6_addresses(const struct hostent *host,
+ const struct apattern *sortlist, size_t nsort)
+{
+ struct ares_in6_addr a1;
+ struct ares_in6_addr a2;
+ int i1;
+ int i2;
+ size_t ind1;
+ size_t ind2;
+
+ /* This is a simple insertion sort, not optimized at all. i1 walks
+ * through the address list, with the loop invariant that everything
+ * to the left of i1 is sorted. In the loop body, the value at i1 is moved
+ * back through the list (via i2) until it is in sorted order.
+ */
+ for (i1 = 0; host->h_addr_list[i1]; i1++) {
+ memcpy(&a1, host->h_addr_list[i1], sizeof(struct ares_in6_addr));
+ ind1 = get6_address_index(&a1, sortlist, nsort);
+ for (i2 = i1 - 1; i2 >= 0; i2--) {
+ memcpy(&a2, host->h_addr_list[i2], sizeof(struct ares_in6_addr));
+ ind2 = get6_address_index(&a2, sortlist, nsort);
+ if (ind2 <= ind1) {
+ break;
+ }
+ memcpy(host->h_addr_list[i2 + 1], &a2, sizeof(struct ares_in6_addr));
+ }
+ memcpy(host->h_addr_list[i2 + 1], &a1, sizeof(struct ares_in6_addr));
+ }
+}
+
+/* Find the first entry in sortlist which matches addr. Return nsort
+ * if none of them match.
+ */
+static size_t get6_address_index(const struct ares_in6_addr *addr,
+ const struct apattern *sortlist, size_t nsort)
+{
+ size_t i;
+ struct ares_addr aaddr;
+
+ memset(&aaddr, 0, sizeof(aaddr));
+ aaddr.family = AF_INET6;
+ memcpy(&aaddr.addr.addr6, addr, 16);
+
+ for (i = 0; i < nsort; i++) {
+ if (sortlist[i].addr.family != AF_INET6) {
+ continue;
+ }
+
+ if (ares__subnet_match(&aaddr, &sortlist[i].addr, sortlist[i].mask)) {
+ break;
+ }
+ }
+ return i;
+}
+
+static ares_status_t ares__hostent_localhost(const char *name, int family,
+ struct hostent **host_out)
+{
+ ares_status_t status;
+ struct ares_addrinfo *ai = NULL;
+ struct ares_addrinfo_hints hints;
+
+ memset(&hints, 0, sizeof(hints));
+ hints.ai_family = family;
+
+ ai = ares_malloc_zero(sizeof(*ai));
+ if (ai == NULL) {
+ status = ARES_ENOMEM;
+ goto done;
+ }
+
+ status = ares__addrinfo_localhost(name, 0, &hints, ai);
+ if (status != ARES_SUCCESS) {
+ goto done;
+ }
+
+ status = ares__addrinfo2hostent(ai, family, host_out);
+ if (status != ARES_SUCCESS) {
+ goto done;
+ }
+
+done:
+ ares_freeaddrinfo(ai);
+ return status;
+}
+
+/* I really have no idea why this is exposed as a public function, but since
+ * it is, we can't kill this legacy function. */
+static ares_status_t ares_gethostbyname_file_int(ares_channel_t *channel,
+ const char *name, int family,
+ struct hostent **host)
+{
+ const ares_hosts_entry_t *entry;
+ ares_status_t status;
+
+ /* We only take the channel to ensure that ares_init() been called. */
+ if (channel == NULL || name == NULL || host == NULL) {
+ /* Anything will do, really. This seems fine, and is consistent with
+ other error cases. */
+ if (host != NULL) {
+ *host = NULL;
+ }
+ return ARES_ENOTFOUND;
+ }
+
+ /* Per RFC 7686, reject queries for ".onion" domain names with NXDOMAIN. */
+ if (ares__is_onion_domain(name)) {
+ return ARES_ENOTFOUND;
+ }
+
+ status = ares__hosts_search_host(channel, ARES_FALSE, name, &entry);
+ if (status != ARES_SUCCESS) {
+ goto done;
+ }
+
+ status = ares__hosts_entry_to_hostent(entry, family, host);
+ if (status != ARES_SUCCESS) {
+ goto done;
+ }
+
+done:
+ /* RFC6761 section 6.3 #3 states that "Name resolution APIs and libraries
+ * SHOULD recognize localhost names as special and SHOULD always return the
+ * IP loopback address for address queries".
+ * We will also ignore ALL errors when trying to resolve localhost, such
+ * as permissions errors reading /etc/hosts or a malformed /etc/hosts */
+ if (status != ARES_SUCCESS && status != ARES_ENOMEM &&
+ ares__is_localhost(name)) {
+ return ares__hostent_localhost(name, family, host);
+ }
+
+ return status;
+}
+
+int ares_gethostbyname_file(ares_channel_t *channel, const char *name,
+ int family, struct hostent **host)
+{
+ ares_status_t status;
+ if (channel == NULL) {
+ return ARES_ENOTFOUND;
+ }
+
+ ares__channel_lock(channel);
+ status = ares_gethostbyname_file_int(channel, name, family, host);
+ ares__channel_unlock(channel);
+ return (int)status;
+}
diff --git a/subprojects/c-ares/src/lib/ares_getnameinfo.c b/subprojects/c-ares/src/lib/ares_getnameinfo.c
@@ -0,0 +1,438 @@
+/* MIT License
+ *
+ * Copyright (c) 2005, 2013 Dominick Meglio
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice (including the next
+ * paragraph) shall be included in all copies or substantial portions of the
+ * Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ *
+ * SPDX-License-Identifier: MIT
+ */
+#include "ares_setup.h"
+
+#ifdef HAVE_GETSERVBYPORT_R
+# if !defined(GETSERVBYPORT_R_ARGS) || (GETSERVBYPORT_R_ARGS < 4) || \
+ (GETSERVBYPORT_R_ARGS > 6)
+# error "you MUST specify a valid number of arguments for getservbyport_r"
+# endif
+#endif
+
+#ifdef HAVE_NETINET_IN_H
+# include <netinet/in.h>
+#endif
+#ifdef HAVE_NETDB_H
+# include <netdb.h>
+#endif
+#ifdef HAVE_ARPA_INET_H
+# include <arpa/inet.h>
+#endif
+
+#include "ares_nameser.h"
+
+#ifdef HAVE_NET_IF_H
+# include <net/if.h>
+#endif
+#if defined(USE_WINSOCK) && defined(HAVE_IPHLPAPI_H)
+# include <iphlpapi.h>
+#endif
+
+#include "ares.h"
+#include "ares_ipv6.h"
+#include "ares_private.h"
+
+struct nameinfo_query {
+ ares_nameinfo_callback callback;
+ void *arg;
+
+ union {
+ struct sockaddr_in addr4;
+ struct sockaddr_in6 addr6;
+ } addr;
+
+ int family;
+ unsigned int flags;
+ size_t timeouts;
+};
+
+#ifdef HAVE_STRUCT_SOCKADDR_IN6_SIN6_SCOPE_ID
+# define IPBUFSIZ \
+ (sizeof("ffff:ffff:ffff:ffff:ffff:ffff:255.255.255.255") + IF_NAMESIZE)
+#else
+# define IPBUFSIZ (sizeof("ffff:ffff:ffff:ffff:ffff:ffff:255.255.255.255"))
+#endif
+
+static void nameinfo_callback(void *arg, int status, int timeouts,
+ struct hostent *host);
+static char *lookup_service(unsigned short port, unsigned int flags, char *buf,
+ size_t buflen);
+#ifdef HAVE_STRUCT_SOCKADDR_IN6_SIN6_SCOPE_ID
+static void append_scopeid(const struct sockaddr_in6 *addr6,
+ unsigned int scopeid, char *buf, size_t buflen);
+#endif
+static char *ares_striendstr(const char *s1, const char *s2);
+
+static void ares_getnameinfo_int(ares_channel_t *channel,
+ const struct sockaddr *sa,
+ ares_socklen_t salen, int flags_int,
+ ares_nameinfo_callback callback, void *arg)
+{
+ const struct sockaddr_in *addr = NULL;
+ const struct sockaddr_in6 *addr6 = NULL;
+ struct nameinfo_query *niquery;
+ unsigned short port = 0;
+ unsigned int flags = (unsigned int)flags_int;
+
+ /* Validate socket address family and length */
+ if ((sa->sa_family == AF_INET) && (salen == sizeof(struct sockaddr_in))) {
+ addr = CARES_INADDR_CAST(struct sockaddr_in *, sa);
+ port = addr->sin_port;
+ } else if ((sa->sa_family == AF_INET6) &&
+ (salen == sizeof(struct sockaddr_in6))) {
+ addr6 = CARES_INADDR_CAST(struct sockaddr_in6 *, sa);
+ port = addr6->sin6_port;
+ } else {
+ callback(arg, ARES_ENOTIMP, 0, NULL, NULL);
+ return;
+ }
+
+ /* If neither, assume they want a host */
+ if (!(flags & ARES_NI_LOOKUPSERVICE) && !(flags & ARES_NI_LOOKUPHOST)) {
+ flags |= ARES_NI_LOOKUPHOST;
+ }
+
+ /* All they want is a service, no need for DNS */
+ if ((flags & ARES_NI_LOOKUPSERVICE) && !(flags & ARES_NI_LOOKUPHOST)) {
+ char buf[33];
+ char *service;
+
+ service =
+ lookup_service((unsigned short)(port & 0xffff), flags, buf, sizeof(buf));
+ callback(arg, ARES_SUCCESS, 0, NULL, service);
+ return;
+ }
+
+ /* They want a host lookup */
+ if (flags & ARES_NI_LOOKUPHOST) {
+ /* A numeric host can be handled without DNS */
+ if (flags & ARES_NI_NUMERICHOST) {
+ char ipbuf[IPBUFSIZ];
+ char srvbuf[33];
+ char *service = NULL;
+ ipbuf[0] = 0;
+
+ /* Specifying not to lookup a host, but then saying a host
+ * is required has to be illegal.
+ */
+ if (flags & ARES_NI_NAMEREQD) {
+ callback(arg, ARES_EBADFLAGS, 0, NULL, NULL);
+ return;
+ }
+ if (salen == sizeof(struct sockaddr_in6)) {
+ ares_inet_ntop(AF_INET6, &addr6->sin6_addr, ipbuf, IPBUFSIZ);
+ /* If the system supports scope IDs, use it */
+#ifdef HAVE_STRUCT_SOCKADDR_IN6_SIN6_SCOPE_ID
+ append_scopeid(addr6, flags, ipbuf, sizeof(ipbuf));
+#endif
+ } else {
+ ares_inet_ntop(AF_INET, &addr->sin_addr, ipbuf, IPBUFSIZ);
+ }
+ /* They also want a service */
+ if (flags & ARES_NI_LOOKUPSERVICE) {
+ service = lookup_service((unsigned short)(port & 0xffff), flags, srvbuf,
+ sizeof(srvbuf));
+ }
+ callback(arg, ARES_SUCCESS, 0, ipbuf, service);
+ return;
+ }
+ /* This is where a DNS lookup becomes necessary */
+ else {
+ niquery = ares_malloc(sizeof(struct nameinfo_query));
+ if (!niquery) {
+ callback(arg, ARES_ENOMEM, 0, NULL, NULL);
+ return;
+ }
+ niquery->callback = callback;
+ niquery->arg = arg;
+ niquery->flags = flags;
+ niquery->timeouts = 0;
+ if (sa->sa_family == AF_INET) {
+ niquery->family = AF_INET;
+ memcpy(&niquery->addr.addr4, addr, sizeof(niquery->addr.addr4));
+ ares_gethostbyaddr(channel, &addr->sin_addr, sizeof(struct in_addr),
+ AF_INET, nameinfo_callback, niquery);
+ } else {
+ niquery->family = AF_INET6;
+ memcpy(&niquery->addr.addr6, addr6, sizeof(niquery->addr.addr6));
+ ares_gethostbyaddr(channel, &addr6->sin6_addr,
+ sizeof(struct ares_in6_addr), AF_INET6,
+ nameinfo_callback, niquery);
+ }
+ }
+ }
+}
+
+void ares_getnameinfo(ares_channel_t *channel, const struct sockaddr *sa,
+ ares_socklen_t salen, int flags_int,
+ ares_nameinfo_callback callback, void *arg)
+{
+ if (channel == NULL) {
+ return;
+ }
+
+ ares__channel_lock(channel);
+ ares_getnameinfo_int(channel, sa, salen, flags_int, callback, arg);
+ ares__channel_unlock(channel);
+}
+
+static void nameinfo_callback(void *arg, int status, int timeouts,
+ struct hostent *host)
+{
+ struct nameinfo_query *niquery = (struct nameinfo_query *)arg;
+ char srvbuf[33];
+ char *service = NULL;
+
+ niquery->timeouts += (size_t)timeouts;
+ if (status == ARES_SUCCESS) {
+ /* They want a service too */
+ if (niquery->flags & ARES_NI_LOOKUPSERVICE) {
+ if (niquery->family == AF_INET) {
+ service = lookup_service(niquery->addr.addr4.sin_port, niquery->flags,
+ srvbuf, sizeof(srvbuf));
+ } else {
+ service = lookup_service(niquery->addr.addr6.sin6_port, niquery->flags,
+ srvbuf, sizeof(srvbuf));
+ }
+ }
+ /* NOFQDN means we have to strip off the domain name portion. We do
+ this by determining our own domain name, then searching the string
+ for this domain name and removing it.
+ */
+#ifdef HAVE_GETHOSTNAME
+ if (niquery->flags & ARES_NI_NOFQDN) {
+ char buf[255];
+ const char *domain;
+ gethostname(buf, 255);
+ if ((domain = strchr(buf, '.')) != NULL) {
+ char *end = ares_striendstr(host->h_name, domain);
+ if (end) {
+ *end = 0;
+ }
+ }
+ }
+#endif
+ niquery->callback(niquery->arg, ARES_SUCCESS, (int)niquery->timeouts,
+ host->h_name, service);
+ ares_free(niquery);
+ return;
+ }
+ /* We couldn't find the host, but it's OK, we can use the IP */
+ else if (status == ARES_ENOTFOUND && !(niquery->flags & ARES_NI_NAMEREQD)) {
+ char ipbuf[IPBUFSIZ];
+ if (niquery->family == AF_INET) {
+ ares_inet_ntop(AF_INET, &niquery->addr.addr4.sin_addr, ipbuf, IPBUFSIZ);
+ } else {
+ ares_inet_ntop(AF_INET6, &niquery->addr.addr6.sin6_addr, ipbuf, IPBUFSIZ);
+#ifdef HAVE_STRUCT_SOCKADDR_IN6_SIN6_SCOPE_ID
+ append_scopeid(&niquery->addr.addr6, niquery->flags, ipbuf,
+ sizeof(ipbuf));
+#endif
+ }
+ /* They want a service too */
+ if (niquery->flags & ARES_NI_LOOKUPSERVICE) {
+ if (niquery->family == AF_INET) {
+ service = lookup_service(niquery->addr.addr4.sin_port, niquery->flags,
+ srvbuf, sizeof(srvbuf));
+ } else {
+ service = lookup_service(niquery->addr.addr6.sin6_port, niquery->flags,
+ srvbuf, sizeof(srvbuf));
+ }
+ }
+ niquery->callback(niquery->arg, ARES_SUCCESS, (int)niquery->timeouts, ipbuf,
+ service);
+ ares_free(niquery);
+ return;
+ }
+ niquery->callback(niquery->arg, status, (int)niquery->timeouts, NULL, NULL);
+ ares_free(niquery);
+}
+
+static char *lookup_service(unsigned short port, unsigned int flags, char *buf,
+ size_t buflen)
+{
+ const char *proto;
+ struct servent *sep;
+#ifdef HAVE_GETSERVBYPORT_R
+ struct servent se;
+#endif
+ char tmpbuf[4096];
+ const char *name;
+ size_t name_len;
+
+ if (port) {
+ if (flags & ARES_NI_NUMERICSERV) {
+ sep = NULL;
+ } else {
+ if (flags & ARES_NI_UDP) {
+ proto = "udp";
+ } else if (flags & ARES_NI_SCTP) {
+ proto = "sctp";
+ } else if (flags & ARES_NI_DCCP) {
+ proto = "dccp";
+ } else {
+ proto = "tcp";
+ }
+#ifdef HAVE_GETSERVBYPORT_R
+ memset(&se, 0, sizeof(se));
+ sep = &se;
+ memset(tmpbuf, 0, sizeof(tmpbuf));
+# if GETSERVBYPORT_R_ARGS == 6
+ if (getservbyport_r(port, proto, &se, (void *)tmpbuf, sizeof(tmpbuf),
+ &sep) != 0) {
+ sep = NULL; /* LCOV_EXCL_LINE: buffer large so this never fails */
+ }
+# elif GETSERVBYPORT_R_ARGS == 5
+ sep = getservbyport_r(port, proto, &se, (void *)tmpbuf, sizeof(tmpbuf));
+# elif GETSERVBYPORT_R_ARGS == 4
+ if (getservbyport_r(port, proto, &se, (void *)tmpbuf) != 0) {
+ sep = NULL;
+ }
+# else
+ /* Lets just hope the OS uses TLS! */
+ sep = getservbyport(port, proto);
+# endif
+#else
+ /* Lets just hope the OS uses TLS! */
+# if (defined(NETWARE) && !defined(__NOVELL_LIBC__))
+ sep = getservbyport(port, (char *)proto);
+# else
+ sep = getservbyport(port, proto);
+# endif
+#endif
+ }
+ if (sep && sep->s_name) {
+ /* get service name */
+ name = sep->s_name;
+ } else {
+ /* get port as a string */
+ snprintf(tmpbuf, sizeof(tmpbuf), "%u", (unsigned int)ntohs(port));
+ name = tmpbuf;
+ }
+ name_len = ares_strlen(name);
+ if (name_len < buflen) {
+ /* return it if buffer big enough */
+ memcpy(buf, name, name_len + 1);
+ } else {
+ /* avoid reusing previous one */
+ buf[0] = '\0'; /* LCOV_EXCL_LINE: no real service names are too big */
+ }
+ return buf;
+ }
+ buf[0] = '\0';
+ return NULL;
+}
+
+#ifdef HAVE_STRUCT_SOCKADDR_IN6_SIN6_SCOPE_ID
+static void append_scopeid(const struct sockaddr_in6 *addr6, unsigned int flags,
+ char *buf, size_t buflen)
+{
+# ifdef HAVE_IF_INDEXTONAME
+ int is_ll;
+ int is_mcll;
+# endif
+ char tmpbuf[IF_NAMESIZE + 2];
+ size_t bufl;
+
+ tmpbuf[0] = '%';
+
+# ifdef HAVE_IF_INDEXTONAME
+ is_ll = IN6_IS_ADDR_LINKLOCAL(&addr6->sin6_addr);
+ is_mcll = IN6_IS_ADDR_MC_LINKLOCAL(&addr6->sin6_addr);
+ if ((flags & ARES_NI_NUMERICSCOPE) || (!is_ll && !is_mcll)) {
+ snprintf(&tmpbuf[1], sizeof(tmpbuf) - 1, "%lu",
+ (unsigned long)addr6->sin6_scope_id);
+ } else {
+ if (if_indextoname(addr6->sin6_scope_id, &tmpbuf[1]) == NULL) {
+ snprintf(&tmpbuf[1], sizeof(tmpbuf) - 1, "%lu",
+ (unsigned long)addr6->sin6_scope_id);
+ }
+ }
+# else
+ snprintf(&tmpbuf[1], sizeof(tmpbuf) - 1, "%lu",
+ (unsigned long)addr6->sin6_scope_id);
+ (void)flags;
+# endif
+ tmpbuf[IF_NAMESIZE + 1] = '\0';
+ bufl = ares_strlen(buf);
+
+ if (bufl + ares_strlen(tmpbuf) < buflen) {
+ /* only append the scopeid string if it fits in the target buffer */
+ ares_strcpy(&buf[bufl], tmpbuf, buflen - bufl);
+ }
+}
+#endif
+
+/* Determines if s1 ends with the string in s2 (case-insensitive) */
+static char *ares_striendstr(const char *s1, const char *s2)
+{
+ const char *c1;
+ const char *c2;
+ const char *c1_begin;
+ int lo1;
+ int lo2;
+ size_t s1_len = ares_strlen(s1);
+ size_t s2_len = ares_strlen(s2);
+
+ if (s1 == NULL || s2 == NULL) {
+ return NULL;
+ }
+
+ /* If the substr is longer than the full str, it can't match */
+ if (s2_len > s1_len) {
+ return NULL;
+ }
+
+ /* Jump to the end of s1 minus the length of s2 */
+ c1_begin = s1 + s1_len - s2_len;
+ c1 = c1_begin;
+ c2 = s2;
+ while (c2 < s2 + s2_len) {
+ lo1 = TOLOWER(*c1);
+ lo2 = TOLOWER(*c2);
+ if (lo1 != lo2) {
+ return NULL;
+ } else {
+ c1++;
+ c2++;
+ }
+ }
+ /* Cast off const */
+ return (char *)((size_t)c1_begin);
+}
+
+ares_bool_t ares__is_onion_domain(const char *name)
+{
+ if (ares_striendstr(name, ".onion")) {
+ return ARES_TRUE;
+ }
+
+ if (ares_striendstr(name, ".onion.")) {
+ return ARES_TRUE;
+ }
+
+ return ARES_FALSE;
+}
diff --git a/subprojects/c-ares/src/lib/ares_getsock.c b/subprojects/c-ares/src/lib/ares_getsock.c
@@ -0,0 +1,88 @@
+/* MIT License
+ *
+ * Copyright (c) 2005 Daniel Stenberg
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice (including the next
+ * paragraph) shall be included in all copies or substantial portions of the
+ * Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ *
+ * SPDX-License-Identifier: MIT
+ */
+
+#include "ares_setup.h"
+
+#include "ares.h"
+#include "ares_private.h"
+
+int ares_getsock(ares_channel_t *channel, ares_socket_t *socks,
+ int numsocks) /* size of the 'socks' array */
+{
+ ares__slist_node_t *snode;
+ size_t sockindex = 0;
+ unsigned int bitmap = 0;
+ unsigned int setbits = 0xffffffff;
+
+ /* Are there any active queries? */
+ size_t active_queries;
+
+ if (channel == NULL || numsocks <= 0) {
+ return 0;
+ }
+
+ ares__channel_lock(channel);
+
+ active_queries = ares__llist_len(channel->all_queries);
+
+ for (snode = ares__slist_node_first(channel->servers); snode != NULL;
+ snode = ares__slist_node_next(snode)) {
+ struct server_state *server = ares__slist_node_val(snode);
+ ares__llist_node_t *node;
+
+ for (node = ares__llist_node_first(server->connections); node != NULL;
+ node = ares__llist_node_next(node)) {
+ const struct server_connection *conn = ares__llist_node_val(node);
+
+ if (sockindex >= (size_t)numsocks || sockindex >= ARES_GETSOCK_MAXNUM) {
+ break;
+ }
+
+ /* We only need to register interest in UDP sockets if we have
+ * outstanding queries.
+ */
+ if (!active_queries && !conn->is_tcp) {
+ continue;
+ }
+
+ socks[sockindex] = conn->fd;
+
+ if (active_queries || conn->is_tcp) {
+ bitmap |= ARES_GETSOCK_READABLE(setbits, sockindex);
+ }
+
+ if (conn->is_tcp && ares__buf_len(server->tcp_send)) {
+ /* then the tcp socket is also writable! */
+ bitmap |= ARES_GETSOCK_WRITABLE(setbits, sockindex);
+ }
+
+ sockindex++;
+ }
+ }
+
+ ares__channel_unlock(channel);
+ return (int)bitmap;
+}
diff --git a/subprojects/c-ares/src/lib/ares_inet_net_pton.h b/subprojects/c-ares/src/lib/ares_inet_net_pton.h
@@ -0,0 +1,35 @@
+/* MIT License
+ *
+ * Copyright (c) 2005 Daniel Stenberg
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice (including the next
+ * paragraph) shall be included in all copies or substantial portions of the
+ * Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ *
+ * SPDX-License-Identifier: MIT
+ */
+#ifndef HEADER_CARES_INET_NET_PTON_H
+#define HEADER_CARES_INET_NET_PTON_H
+
+#ifdef HAVE_INET_NET_PTON
+# define ares_inet_net_pton(w, x, y, z) inet_net_pton(w, x, y, z)
+#else
+int ares_inet_net_pton(int af, const char *src, void *dst, size_t size);
+#endif
+
+#endif /* HEADER_CARES_INET_NET_PTON_H */
diff --git a/subprojects/c-ares/src/lib/ares_init.c b/subprojects/c-ares/src/lib/ares_init.c
@@ -0,0 +1,569 @@
+/* MIT License
+ *
+ * Copyright (c) 1998 Massachusetts Institute of Technology
+ * Copyright (c) 2007 Daniel Stenberg
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice (including the next
+ * paragraph) shall be included in all copies or substantial portions of the
+ * Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ *
+ * SPDX-License-Identifier: MIT
+ */
+
+#include "ares_setup.h"
+
+#ifdef HAVE_SYS_PARAM_H
+# include <sys/param.h>
+#endif
+
+#ifdef HAVE_NETINET_IN_H
+# include <netinet/in.h>
+#endif
+
+#ifdef HAVE_NETDB_H
+# include <netdb.h>
+#endif
+
+#ifdef HAVE_ARPA_INET_H
+# include <arpa/inet.h>
+#endif
+
+#include "ares_nameser.h"
+
+#if defined(ANDROID) || defined(__ANDROID__)
+# include <sys/system_properties.h>
+# include "ares_android.h"
+/* From the Bionic sources */
+# define DNS_PROP_NAME_PREFIX "net.dns"
+# define MAX_DNS_PROPERTIES 8
+#endif
+
+#if defined(CARES_USE_LIBRESOLV)
+# include <resolv.h>
+#endif
+
+#if defined(USE_WINSOCK) && defined(HAVE_IPHLPAPI_H)
+# include <iphlpapi.h>
+#endif
+
+#include "ares.h"
+#include "ares_inet_net_pton.h"
+#include "ares_platform.h"
+#include "ares_private.h"
+
+#ifdef WATT32
+# undef WIN32 /* Redefined in MingW/MSVC headers */
+#endif
+
+
+int ares_init(ares_channel_t **channelptr)
+{
+ return ares_init_options(channelptr, NULL, 0);
+}
+
+static int ares_query_timeout_cmp_cb(const void *arg1, const void *arg2)
+{
+ const struct query *q1 = arg1;
+ const struct query *q2 = arg2;
+
+ if (q1->timeout.tv_sec > q2->timeout.tv_sec) {
+ return 1;
+ }
+ if (q1->timeout.tv_sec < q2->timeout.tv_sec) {
+ return -1;
+ }
+
+ if (q1->timeout.tv_usec > q2->timeout.tv_usec) {
+ return 1;
+ }
+ if (q1->timeout.tv_usec < q2->timeout.tv_usec) {
+ return -1;
+ }
+
+ return 0;
+}
+
+static int server_sort_cb(const void *data1, const void *data2)
+{
+ const struct server_state *s1 = data1;
+ const struct server_state *s2 = data2;
+
+ if (s1->consec_failures < s2->consec_failures) {
+ return -1;
+ }
+ if (s1->consec_failures > s2->consec_failures) {
+ return 1;
+ }
+ if (s1->idx < s2->idx) {
+ return -1;
+ }
+ if (s1->idx > s2->idx) {
+ return 1;
+ }
+ return 0;
+}
+
+static void server_destroy_cb(void *data)
+{
+ if (data == NULL) {
+ return;
+ }
+ ares__destroy_server(data);
+}
+
+static ares_status_t init_by_defaults(ares_channel_t *channel)
+{
+ char *hostname = NULL;
+ ares_status_t rc = ARES_SUCCESS;
+#ifdef HAVE_GETHOSTNAME
+ const char *dot;
+#endif
+
+ /* Enable EDNS by default */
+ if (!(channel->optmask & ARES_OPT_FLAGS)) {
+ channel->flags = ARES_FLAG_EDNS;
+ }
+ if (channel->ednspsz == 0) {
+ channel->ednspsz = EDNSPACKETSZ;
+ }
+
+ if (channel->timeout == 0) {
+ channel->timeout = DEFAULT_TIMEOUT;
+ }
+
+ if (channel->tries == 0) {
+ channel->tries = DEFAULT_TRIES;
+ }
+
+ if (channel->ndots == 0) {
+ channel->ndots = 1;
+ }
+
+ if (ares__slist_len(channel->servers) == 0) {
+ struct ares_addr addr;
+ ares__llist_t *sconfig = NULL;
+
+ addr.family = AF_INET;
+ addr.addr.addr4.s_addr = htonl(INADDR_LOOPBACK);
+
+ rc = ares__sconfig_append(&sconfig, &addr, 0, 0, NULL);
+ if (rc != ARES_SUCCESS) {
+ return rc;
+ }
+
+ rc = ares__servers_update(channel, sconfig, ARES_FALSE);
+ ares__llist_destroy(sconfig);
+
+ if (rc != ARES_SUCCESS) {
+ return rc;
+ }
+ }
+
+#if defined(USE_WINSOCK)
+# define toolong(x) (x == -1) && (SOCKERRNO == WSAEFAULT)
+#elif defined(ENAMETOOLONG)
+# define toolong(x) \
+ (x == -1) && ((SOCKERRNO == ENAMETOOLONG) || (SOCKERRNO == EINVAL))
+#else
+# define toolong(x) (x == -1) && (SOCKERRNO == EINVAL)
+#endif
+
+ if (channel->ndomains == 0) {
+ /* Derive a default domain search list from the kernel hostname,
+ * or set it to empty if the hostname isn't helpful.
+ */
+#ifndef HAVE_GETHOSTNAME
+ channel->ndomains = 0; /* default to none */
+#else
+ GETHOSTNAME_TYPE_ARG2 lenv = 64;
+ size_t len = 64;
+ int res;
+ channel->ndomains = 0; /* default to none */
+
+ hostname = ares_malloc(len);
+ if (!hostname) {
+ rc = ARES_ENOMEM;
+ goto error;
+ }
+
+ do {
+ res = gethostname(hostname, lenv);
+
+ if (toolong(res)) {
+ char *p;
+ len *= 2;
+ lenv *= 2;
+ p = ares_realloc(hostname, len);
+ if (!p) {
+ rc = ARES_ENOMEM;
+ goto error;
+ }
+ hostname = p;
+ continue;
+ } else if (res) {
+ /* Lets not treat a gethostname failure as critical, since we
+ * are ok if gethostname doesn't even exist */
+ *hostname = '\0';
+ break;
+ }
+
+ } while (res != 0);
+
+ dot = strchr(hostname, '.');
+ if (dot) {
+ /* a dot was found */
+ channel->domains = ares_malloc(sizeof(char *));
+ if (!channel->domains) {
+ rc = ARES_ENOMEM;
+ goto error;
+ }
+ channel->domains[0] = ares_strdup(dot + 1);
+ if (!channel->domains[0]) {
+ rc = ARES_ENOMEM;
+ goto error;
+ }
+ channel->ndomains = 1;
+ }
+#endif
+ }
+
+ if (channel->nsort == 0) {
+ channel->sortlist = NULL;
+ }
+
+ if (!channel->lookups) {
+ channel->lookups = ares_strdup("fb");
+ if (!channel->lookups) {
+ rc = ARES_ENOMEM;
+ }
+ }
+
+error:
+ if (rc) {
+ if (channel->domains && channel->domains[0]) {
+ ares_free(channel->domains[0]);
+ }
+ if (channel->domains) {
+ ares_free(channel->domains);
+ channel->domains = NULL;
+ }
+
+ if (channel->lookups) {
+ ares_free(channel->lookups);
+ channel->lookups = NULL;
+ }
+
+ if (channel->resolvconf_path) {
+ ares_free(channel->resolvconf_path);
+ channel->resolvconf_path = NULL;
+ }
+
+ if (channel->hosts_path) {
+ ares_free(channel->hosts_path);
+ channel->hosts_path = NULL;
+ }
+ }
+
+ if (hostname) {
+ ares_free(hostname);
+ }
+
+ return rc;
+}
+
+int ares_init_options(ares_channel_t **channelptr,
+ const struct ares_options *options, int optmask)
+{
+ ares_channel_t *channel;
+ ares_status_t status = ARES_SUCCESS;
+
+ if (ares_library_initialized() != ARES_SUCCESS) {
+ return ARES_ENOTINITIALIZED; /* LCOV_EXCL_LINE: n/a on non-WinSock */
+ }
+
+ channel = ares_malloc_zero(sizeof(*channel));
+ if (!channel) {
+ *channelptr = NULL;
+ return ARES_ENOMEM;
+ }
+
+ status = ares__channel_threading_init(channel);
+ if (status != ARES_SUCCESS) {
+ goto done;
+ }
+
+ /* Generate random key */
+ channel->rand_state = ares__init_rand_state();
+ if (channel->rand_state == NULL) {
+ status = ARES_ENOMEM;
+ DEBUGF(fprintf(stderr, "Error: init_id_key failed: %s\n",
+ ares_strerror(status)));
+ goto done;
+ }
+
+ /* Initialize Server List */
+ channel->servers =
+ ares__slist_create(channel->rand_state, server_sort_cb, server_destroy_cb);
+ if (channel->servers == NULL) {
+ status = ARES_ENOMEM;
+ goto done;
+ }
+
+ /* Initialize our lists of queries */
+ channel->all_queries = ares__llist_create(NULL);
+ if (channel->all_queries == NULL) {
+ status = ARES_ENOMEM;
+ goto done;
+ }
+
+ channel->queries_by_qid = ares__htable_szvp_create(NULL);
+ if (channel->queries_by_qid == NULL) {
+ status = ARES_ENOMEM;
+ goto done;
+ }
+
+ channel->queries_by_timeout =
+ ares__slist_create(channel->rand_state, ares_query_timeout_cmp_cb, NULL);
+ if (channel->queries_by_timeout == NULL) {
+ status = ARES_ENOMEM;
+ goto done;
+ }
+
+ channel->connnode_by_socket = ares__htable_asvp_create(NULL);
+ if (channel->connnode_by_socket == NULL) {
+ status = ARES_ENOMEM;
+ goto done;
+ }
+
+ /* Initialize configuration by each of the four sources, from highest
+ * precedence to lowest.
+ */
+
+ status = ares__init_by_options(channel, options, optmask);
+ if (status != ARES_SUCCESS) {
+ DEBUGF(fprintf(stderr, "Error: init_by_options failed: %s\n",
+ ares_strerror(status)));
+ /* If we fail to apply user-specified options, fail the whole init process
+ */
+ goto done;
+ }
+
+ if (channel->qcache_max_ttl > 0) {
+ status = ares__qcache_create(channel->rand_state, channel->qcache_max_ttl,
+ &channel->qcache);
+ if (status != ARES_SUCCESS) {
+ goto done;
+ }
+ }
+
+ if (status == ARES_SUCCESS) {
+ status = ares__init_by_sysconfig(channel);
+ if (status != ARES_SUCCESS) {
+ DEBUGF(fprintf(stderr, "Error: init_by_sysconfig failed: %s\n",
+ ares_strerror(status)));
+ }
+ }
+
+ /*
+ * No matter what failed or succeeded, seed defaults to provide
+ * useful behavior for things that we missed.
+ */
+ status = init_by_defaults(channel);
+ if (status != ARES_SUCCESS) {
+ DEBUGF(fprintf(stderr, "Error: init_by_defaults failed: %s\n",
+ ares_strerror(status)));
+ }
+
+done:
+ if (status != ARES_SUCCESS) {
+ ares_destroy(channel);
+ return (int)status;
+ }
+
+ *channelptr = channel;
+ return ARES_SUCCESS;
+}
+
+ares_status_t ares_reinit(ares_channel_t *channel)
+{
+ ares_status_t status;
+
+ if (channel == NULL) {
+ return ARES_EFORMERR;
+ }
+
+ ares__channel_lock(channel);
+
+ status = ares__init_by_sysconfig(channel);
+ if (status != ARES_SUCCESS) {
+ DEBUGF(fprintf(stderr, "Error: init_by_sysconfig failed: %s\n",
+ ares_strerror(status)));
+ }
+
+ /* Flush cached queries on reinit */
+ if (channel->qcache) {
+ ares__qcache_flush(channel->qcache);
+ }
+
+ ares__channel_unlock(channel);
+
+ return status;
+}
+
+/* ares_dup() duplicates a channel handle with all its options and returns a
+ new channel handle */
+int ares_dup(ares_channel_t **dest, ares_channel_t *src)
+{
+ struct ares_options opts;
+ ares_status_t rc;
+ int optmask;
+
+ if (dest == NULL || src == NULL) {
+ return ARES_EFORMERR;
+ }
+
+ *dest = NULL; /* in case of failure return NULL explicitly */
+
+ ares__channel_lock(src);
+ /* First get the options supported by the old ares_save_options() function,
+ which is most of them */
+ rc = (ares_status_t)ares_save_options(src, &opts, &optmask);
+ if (rc != ARES_SUCCESS) {
+ ares_destroy_options(&opts);
+ goto done;
+ }
+
+ /* Then create the new channel with those options */
+ rc = (ares_status_t)ares_init_options(dest, &opts, optmask);
+
+ /* destroy the options copy to not leak any memory */
+ ares_destroy_options(&opts);
+
+ if (rc != ARES_SUCCESS) {
+ goto done;
+ }
+
+ /* Now clone the options that ares_save_options() doesn't support, but are
+ * user-provided */
+ (*dest)->sock_create_cb = src->sock_create_cb;
+ (*dest)->sock_create_cb_data = src->sock_create_cb_data;
+ (*dest)->sock_config_cb = src->sock_config_cb;
+ (*dest)->sock_config_cb_data = src->sock_config_cb_data;
+ (*dest)->sock_funcs = src->sock_funcs;
+ (*dest)->sock_func_cb_data = src->sock_func_cb_data;
+
+ ares_strcpy((*dest)->local_dev_name, src->local_dev_name,
+ sizeof((*dest)->local_dev_name));
+ (*dest)->local_ip4 = src->local_ip4;
+ memcpy((*dest)->local_ip6, src->local_ip6, sizeof(src->local_ip6));
+
+
+ /* Servers are a bit unique as ares_init_options() only allows ipv4 servers
+ * and not a port per server, but there are other user specified ways, that
+ * too will toggle the optmask ARES_OPT_SERVERS to let us know. If that's
+ * the case, pull them in.
+ *
+ * We don't want to clone system-configuration servers though.
+ *
+ * We must use the "csv" format to get things like link-local address support
+ */
+
+ if (optmask & ARES_OPT_SERVERS) {
+ char *csv = ares_get_servers_csv(src);
+ if (csv == NULL) {
+ ares_destroy(*dest);
+ *dest = NULL;
+ rc = ARES_ENOMEM;
+ goto done;
+ }
+
+ rc = (ares_status_t)ares_set_servers_ports_csv(*dest, csv);
+ ares_free_string(csv);
+ if (rc != ARES_SUCCESS) {
+ ares_destroy(*dest);
+ *dest = NULL;
+ goto done;
+ }
+ }
+
+ rc = ARES_SUCCESS;
+done:
+ ares__channel_unlock(src);
+ return (int)rc; /* everything went fine */
+}
+
+void ares_set_local_ip4(ares_channel_t *channel, unsigned int local_ip)
+{
+ if (channel == NULL) {
+ return;
+ }
+ ares__channel_lock(channel);
+ channel->local_ip4 = local_ip;
+ ares__channel_unlock(channel);
+}
+
+/* local_ip6 should be 16 bytes in length */
+void ares_set_local_ip6(ares_channel_t *channel, const unsigned char *local_ip6)
+{
+ if (channel == NULL) {
+ return;
+ }
+ ares__channel_lock(channel);
+ memcpy(&channel->local_ip6, local_ip6, sizeof(channel->local_ip6));
+ ares__channel_unlock(channel);
+}
+
+/* local_dev_name should be null terminated. */
+void ares_set_local_dev(ares_channel_t *channel, const char *local_dev_name)
+{
+ if (channel == NULL) {
+ return;
+ }
+
+ ares__channel_lock(channel);
+ ares_strcpy(channel->local_dev_name, local_dev_name,
+ sizeof(channel->local_dev_name));
+ channel->local_dev_name[sizeof(channel->local_dev_name) - 1] = 0;
+ ares__channel_unlock(channel);
+}
+
+int ares_set_sortlist(ares_channel_t *channel, const char *sortstr)
+{
+ size_t nsort = 0;
+ struct apattern *sortlist = NULL;
+ ares_status_t status;
+
+ if (!channel) {
+ return ARES_ENODATA;
+ }
+ ares__channel_lock(channel);
+
+ status = ares__parse_sortlist(&sortlist, &nsort, sortstr);
+ if (status == ARES_SUCCESS && sortlist) {
+ if (channel->sortlist) {
+ ares_free(channel->sortlist);
+ }
+ channel->sortlist = sortlist;
+ channel->nsort = nsort;
+
+ /* Save sortlist as if it was passed in as an option */
+ channel->optmask |= ARES_OPT_SORTLIST;
+ }
+ ares__channel_unlock(channel);
+ return (int)status;
+}
diff --git a/subprojects/c-ares/src/lib/ares_ipv6.h b/subprojects/c-ares/src/lib/ares_ipv6.h
@@ -0,0 +1,92 @@
+/* MIT License
+ *
+ * Copyright (c) 2005 Dominick Meglio
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice (including the next
+ * paragraph) shall be included in all copies or substantial portions of the
+ * Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ *
+ * SPDX-License-Identifier: MIT
+ */
+
+#ifndef ARES_IPV6_H
+#define ARES_IPV6_H
+
+#ifndef HAVE_PF_INET6
+# define PF_INET6 AF_INET6
+#endif
+
+#ifndef HAVE_STRUCT_SOCKADDR_IN6
+struct sockaddr_in6 {
+ unsigned short sin6_family;
+ unsigned short sin6_port;
+ unsigned long sin6_flowinfo;
+ struct ares_in6_addr sin6_addr;
+ unsigned int sin6_scope_id;
+};
+#endif
+
+typedef union {
+ struct sockaddr sa;
+ struct sockaddr_in sa4;
+ struct sockaddr_in6 sa6;
+} ares_sockaddr;
+
+#ifndef HAVE_STRUCT_ADDRINFO
+struct addrinfo {
+ int ai_flags;
+ int ai_family;
+ int ai_socktype;
+ int ai_protocol;
+ ares_socklen_t ai_addrlen; /* Follow rfc3493 struct addrinfo */
+ char *ai_canonname;
+ struct sockaddr *ai_addr;
+ struct addrinfo *ai_next;
+};
+#endif
+
+#ifndef NS_IN6ADDRSZ
+# ifndef HAVE_STRUCT_IN6_ADDR
+/* We cannot have it set to zero, so we pick a fixed value here */
+# define NS_IN6ADDRSZ 16
+# else
+# define NS_IN6ADDRSZ sizeof(struct in6_addr)
+# endif
+#endif
+
+#ifndef NS_INADDRSZ
+# define NS_INADDRSZ sizeof(struct in_addr)
+#endif
+
+#ifndef NS_INT16SZ
+# define NS_INT16SZ 2
+#endif
+
+#ifndef IF_NAMESIZE
+# ifdef IFNAMSIZ
+# define IF_NAMESIZE IFNAMSIZ
+# else
+# define IF_NAMESIZE 256
+# endif
+#endif
+
+/* Defined in inet_net_pton.c for no particular reason. */
+extern const struct ares_in6_addr ares_in6addr_any; /* :: */
+
+
+#endif /* ARES_IPV6_H */
diff --git a/subprojects/c-ares/src/lib/ares_library_init.c b/subprojects/c-ares/src/lib/ares_library_init.c
@@ -0,0 +1,162 @@
+/* MIT License
+ *
+ * Copyright (c) 1998 Massachusetts Institute of Technology
+ * Copyright (c) 2004 Daniel Stenberg
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice (including the next
+ * paragraph) shall be included in all copies or substantial portions of the
+ * Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ *
+ * SPDX-License-Identifier: MIT
+ */
+
+#include "ares_setup.h"
+
+#include "ares.h"
+#include "ares_private.h"
+
+/* library-private global and unique instance vars */
+
+#if defined(ANDROID) || defined(__ANDROID__)
+# include "ares_android.h"
+#endif
+
+/* library-private global vars with source visibility restricted to this file */
+
+static unsigned int ares_initialized;
+static int ares_init_flags;
+
+/* library-private global vars with visibility across the whole library */
+
+/* Some systems may return either NULL or a valid pointer on malloc(0). c-ares
+ * should never call malloc(0) so lets return NULL so we're more likely to find
+ * an issue if it were to occur. */
+
+static void *default_malloc(size_t size)
+{
+ if (size == 0) {
+ return NULL;
+ }
+ return malloc(size);
+}
+
+#if defined(WIN32)
+/* We need indirections to handle Windows DLL rules. */
+static void *default_realloc(void *p, size_t size)
+{
+ return realloc(p, size);
+}
+
+static void default_free(void *p)
+{
+ free(p);
+}
+#else
+# define default_realloc realloc
+# define default_free free
+#endif
+void *(*ares_malloc)(size_t size) = default_malloc;
+void *(*ares_realloc)(void *ptr, size_t size) = default_realloc;
+void (*ares_free)(void *ptr) = default_free;
+
+void *ares_malloc_zero(size_t size)
+{
+ void *ptr = ares_malloc(size);
+ if (ptr != NULL) {
+ memset(ptr, 0, size);
+ }
+
+ return ptr;
+}
+
+void *ares_realloc_zero(void *ptr, size_t orig_size, size_t new_size)
+{
+ void *p = ares_realloc(ptr, new_size);
+ if (p == NULL) {
+ return NULL;
+ }
+
+ if (new_size > orig_size) {
+ memset((unsigned char *)p + orig_size, 0, new_size - orig_size);
+ }
+
+ return p;
+}
+
+int ares_library_init(int flags)
+{
+ if (ares_initialized) {
+ ares_initialized++;
+ return ARES_SUCCESS;
+ }
+ ares_initialized++;
+
+ /* NOTE: ARES_LIB_INIT_WIN32 flag no longer used */
+
+ ares_init_flags = flags;
+
+ return ARES_SUCCESS;
+}
+
+int ares_library_init_mem(int flags, void *(*amalloc)(size_t size),
+ void (*afree)(void *ptr),
+ void *(*arealloc)(void *ptr, size_t size))
+{
+ if (amalloc) {
+ ares_malloc = amalloc;
+ }
+ if (arealloc) {
+ ares_realloc = arealloc;
+ }
+ if (afree) {
+ ares_free = afree;
+ }
+ return ares_library_init(flags);
+}
+
+void ares_library_cleanup(void)
+{
+ if (!ares_initialized) {
+ return;
+ }
+ ares_initialized--;
+ if (ares_initialized) {
+ return;
+ }
+
+ /* NOTE: ARES_LIB_INIT_WIN32 flag no longer used */
+
+#if defined(ANDROID) || defined(__ANDROID__)
+ ares_library_cleanup_android();
+#endif
+
+ ares_init_flags = ARES_LIB_INIT_NONE;
+ ares_malloc = malloc;
+ ares_realloc = realloc;
+ ares_free = free;
+}
+
+int ares_library_initialized(void)
+{
+#ifdef USE_WINSOCK
+ if (!ares_initialized) {
+ return ARES_ENOTINITIALIZED;
+ }
+#endif
+ return ARES_SUCCESS;
+}
diff --git a/subprojects/c-ares/src/lib/ares_math.c b/subprojects/c-ares/src/lib/ares_math.c
@@ -0,0 +1,145 @@
+/* MIT License
+ *
+ * Copyright (c) 2023 Brad House
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice (including the next
+ * paragraph) shall be included in all copies or substantial portions of the
+ * Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ *
+ * SPDX-License-Identifier: MIT
+ */
+#include "ares_setup.h"
+#include "ares.h"
+#include "ares_private.h"
+
+/* Uses public domain code snippets from
+ * http://graphics.stanford.edu/~seander/bithacks.html */
+
+static unsigned int ares__round_up_pow2_u32(unsigned int n)
+{
+ /* NOTE: if already a power of 2, will return itself, not the next */
+ n--;
+ n |= n >> 1;
+ n |= n >> 2;
+ n |= n >> 4;
+ n |= n >> 8;
+ n |= n >> 16;
+ n++;
+ return n;
+}
+
+static ares_int64_t ares__round_up_pow2_u64(ares_int64_t n)
+{
+ /* NOTE: if already a power of 2, will return itself, not the next */
+ n--;
+ n |= n >> 1;
+ n |= n >> 2;
+ n |= n >> 4;
+ n |= n >> 8;
+ n |= n >> 16;
+ n |= n >> 32;
+ n++;
+ return n;
+}
+
+size_t ares__round_up_pow2(size_t n)
+{
+ if (sizeof(size_t) > 4) {
+ return (size_t)ares__round_up_pow2_u64((ares_int64_t)n);
+ }
+
+ return (size_t)ares__round_up_pow2_u32((unsigned int)n);
+}
+
+size_t ares__log2(size_t n)
+{
+ static const unsigned char tab32[32] = { 0, 1, 28, 2, 29, 14, 24, 3,
+ 30, 22, 20, 15, 25, 17, 4, 8,
+ 31, 27, 13, 23, 21, 19, 16, 7,
+ 26, 12, 18, 6, 11, 5, 10, 9 };
+ static const unsigned char tab64[64] = {
+ 63, 0, 58, 1, 59, 47, 53, 2, 60, 39, 48, 27, 54, 33, 42, 3,
+ 61, 51, 37, 40, 49, 18, 28, 20, 55, 30, 34, 11, 43, 14, 22, 4,
+ 62, 57, 46, 52, 38, 26, 32, 41, 50, 36, 17, 19, 29, 10, 13, 21,
+ 56, 45, 25, 31, 35, 16, 9, 12, 44, 24, 15, 8, 23, 7, 6, 5
+ };
+
+ if (sizeof(size_t) == 4) {
+ return tab32[(n * 0x077CB531) >> 27];
+ }
+
+ return tab64[(n * 0x07EDD5E59A4E28C2) >> 58];
+}
+
+/* x^y */
+size_t ares__pow(size_t x, size_t y)
+{
+ size_t res = 1;
+
+ while (y > 0) {
+ /* If y is odd, multiply x with result */
+ if (y & 1) {
+ res = res * x;
+ }
+
+ /* y must be even now */
+ y = y >> 1; /* y /= 2; */
+ x = x * x; /* x^2 */
+ }
+
+ return res;
+}
+
+size_t ares__count_digits(size_t n)
+{
+ size_t digits;
+
+ for (digits = 0; n > 0; digits++) {
+ n /= 10;
+ }
+ if (digits == 0) {
+ digits = 1;
+ }
+
+ return digits;
+}
+
+size_t ares__count_hexdigits(size_t n)
+{
+ size_t digits;
+
+ for (digits = 0; n > 0; digits++) {
+ n /= 16;
+ }
+ if (digits == 0) {
+ digits = 1;
+ }
+
+ return digits;
+}
+
+unsigned char ares__count_bits_u8(unsigned char x)
+{
+ /* Implementation obtained from:
+ * http://graphics.stanford.edu/~seander/bithacks.html#CountBitsSetTable */
+#define B2(n) n, n + 1, n + 1, n + 2
+#define B4(n) B2(n), B2(n + 1), B2(n + 1), B2(n + 2)
+#define B6(n) B4(n), B4(n + 1), B4(n + 1), B4(n + 2)
+ static const unsigned char lookup[256] = { B6(0), B6(1), B6(1), B6(2) };
+ return lookup[x];
+}
diff --git a/subprojects/c-ares/src/lib/ares_mkquery.c b/subprojects/c-ares/src/lib/ares_mkquery.c
@@ -0,0 +1,35 @@
+/* MIT License
+ *
+ * Copyright (c) 1998 Massachusetts Institute of Technology
+ * Copyright (c) The c-ares project and its contributors
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice (including the next
+ * paragraph) shall be included in all copies or substantial portions of the
+ * Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ *
+ * SPDX-License-Identifier: MIT
+ */
+
+#include "ares_setup.h"
+#include "ares.h"
+
+int ares_mkquery(const char *name, int dnsclass, int type, unsigned short id,
+ int rd, unsigned char **buf, int *buflen)
+{
+ return ares_create_query(name, dnsclass, type, id, rd, buf, buflen, 0);
+}
diff --git a/subprojects/c-ares/src/lib/ares_options.c b/subprojects/c-ares/src/lib/ares_options.c
@@ -0,0 +1,463 @@
+/* MIT License
+ *
+ * Copyright (c) 1998 Massachusetts Institute of Technology
+ * Copyright (c) 2008 Daniel Stenberg
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice (including the next
+ * paragraph) shall be included in all copies or substantial portions of the
+ * Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ *
+ * SPDX-License-Identifier: MIT
+ */
+
+#include "ares_setup.h"
+
+#ifdef HAVE_ARPA_INET_H
+# include <arpa/inet.h>
+#endif
+
+#include "ares.h"
+#include "ares_data.h"
+#include "ares_inet_net_pton.h"
+#include "ares_private.h"
+
+void ares_destroy_options(struct ares_options *options)
+{
+ int i;
+
+ ares_free(options->servers);
+
+ for (i = 0; options->domains && i < options->ndomains; i++) {
+ ares_free(options->domains[i]);
+ }
+
+ ares_free(options->domains);
+ ares_free(options->sortlist);
+ ares_free(options->lookups);
+ ares_free(options->resolvconf_path);
+ ares_free(options->hosts_path);
+}
+
+static struct in_addr *ares_save_opt_servers(ares_channel_t *channel,
+ int *nservers)
+{
+ ares__slist_node_t *snode;
+ struct in_addr *out =
+ ares_malloc_zero(ares__slist_len(channel->servers) * sizeof(*out));
+
+ *nservers = 0;
+
+ if (out == NULL) {
+ return NULL;
+ }
+
+ for (snode = ares__slist_node_first(channel->servers); snode != NULL;
+ snode = ares__slist_node_next(snode)) {
+ const struct server_state *server = ares__slist_node_val(snode);
+
+ if (server->addr.family != AF_INET) {
+ continue;
+ }
+
+ memcpy(&out[*nservers], &server->addr.addr.addr4, sizeof(*out));
+ (*nservers)++;
+ }
+
+ return out;
+}
+
+/* Save options from initialized channel */
+int ares_save_options(ares_channel_t *channel, struct ares_options *options,
+ int *optmask)
+{
+ size_t i;
+
+ /* NOTE: We can't zero the whole thing out, this is because the size of the
+ * struct ares_options changes over time, so if someone compiled
+ * with an older version, their struct size might be smaller and
+ * we might overwrite their memory! So using the optmask is critical
+ * here, as they could have only set options they knew about.
+ *
+ * Unfortunately ares_destroy_options() doesn't take an optmask, so
+ * there are a few pointers we *must* zero out otherwise we won't
+ * know if they were allocated or not
+ */
+ options->servers = NULL;
+ options->domains = NULL;
+ options->sortlist = NULL;
+ options->lookups = NULL;
+ options->resolvconf_path = NULL;
+ options->hosts_path = NULL;
+
+ if (!ARES_CONFIG_CHECK(channel)) {
+ return ARES_ENODATA;
+ }
+
+ if (channel->optmask & ARES_OPT_FLAGS) {
+ options->flags = (int)channel->flags;
+ }
+
+ /* We convert ARES_OPT_TIMEOUT to ARES_OPT_TIMEOUTMS in
+ * ares__init_by_options() */
+ if (channel->optmask & ARES_OPT_TIMEOUTMS) {
+ options->timeout = (int)channel->timeout;
+ }
+
+ if (channel->optmask & ARES_OPT_TRIES) {
+ options->tries = (int)channel->tries;
+ }
+
+ if (channel->optmask & ARES_OPT_NDOTS) {
+ options->ndots = (int)channel->ndots;
+ }
+
+ if (channel->optmask & ARES_OPT_MAXTIMEOUTMS) {
+ options->maxtimeout = (int)channel->maxtimeout;
+ }
+
+ if (channel->optmask & ARES_OPT_UDP_PORT) {
+ options->udp_port = channel->udp_port;
+ }
+ if (channel->optmask & ARES_OPT_TCP_PORT) {
+ options->tcp_port = channel->tcp_port;
+ }
+
+ if (channel->optmask & ARES_OPT_SOCK_STATE_CB) {
+ options->sock_state_cb = channel->sock_state_cb;
+ options->sock_state_cb_data = channel->sock_state_cb_data;
+ }
+
+ if (channel->optmask & ARES_OPT_SERVERS) {
+ options->servers = ares_save_opt_servers(channel, &options->nservers);
+ if (options->servers == NULL) {
+ return ARES_ENOMEM;
+ }
+ }
+
+ if (channel->optmask & ARES_OPT_DOMAINS) {
+ options->domains = NULL;
+ if (channel->ndomains) {
+ options->domains = ares_malloc(channel->ndomains * sizeof(char *));
+ if (!options->domains) {
+ return ARES_ENOMEM;
+ }
+
+ for (i = 0; i < channel->ndomains; i++) {
+ options->domains[i] = ares_strdup(channel->domains[i]);
+ if (!options->domains[i]) {
+ options->ndomains = (int)i;
+ return ARES_ENOMEM;
+ }
+ }
+ }
+ options->ndomains = (int)channel->ndomains;
+ }
+
+ if (channel->optmask & ARES_OPT_LOOKUPS) {
+ options->lookups = ares_strdup(channel->lookups);
+ if (!options->lookups && channel->lookups) {
+ return ARES_ENOMEM;
+ }
+ }
+
+ if (channel->optmask & ARES_OPT_SORTLIST) {
+ options->sortlist = NULL;
+ if (channel->nsort) {
+ options->sortlist = ares_malloc(channel->nsort * sizeof(struct apattern));
+ if (!options->sortlist) {
+ return ARES_ENOMEM;
+ }
+ for (i = 0; i < channel->nsort; i++) {
+ options->sortlist[i] = channel->sortlist[i];
+ }
+ }
+ options->nsort = (int)channel->nsort;
+ }
+
+ if (channel->optmask & ARES_OPT_RESOLVCONF) {
+ options->resolvconf_path = ares_strdup(channel->resolvconf_path);
+ if (!options->resolvconf_path) {
+ return ARES_ENOMEM;
+ }
+ }
+
+ if (channel->optmask & ARES_OPT_HOSTS_FILE) {
+ options->hosts_path = ares_strdup(channel->hosts_path);
+ if (!options->hosts_path) {
+ return ARES_ENOMEM;
+ }
+ }
+
+ if (channel->optmask & ARES_OPT_SOCK_SNDBUF &&
+ channel->socket_send_buffer_size > 0) {
+ options->socket_send_buffer_size = channel->socket_send_buffer_size;
+ }
+
+ if (channel->optmask & ARES_OPT_SOCK_RCVBUF &&
+ channel->socket_receive_buffer_size > 0) {
+ options->socket_receive_buffer_size = channel->socket_receive_buffer_size;
+ }
+
+ if (channel->optmask & ARES_OPT_EDNSPSZ) {
+ options->ednspsz = (int)channel->ednspsz;
+ }
+
+ if (channel->optmask & ARES_OPT_UDP_MAX_QUERIES) {
+ options->udp_max_queries = (int)channel->udp_max_queries;
+ }
+
+ if (channel->optmask & ARES_OPT_QUERY_CACHE) {
+ options->qcache_max_ttl = channel->qcache_max_ttl;
+ }
+
+ *optmask = (int)channel->optmask;
+
+ return ARES_SUCCESS;
+}
+
+static ares_status_t ares__init_options_servers(ares_channel_t *channel,
+ const struct in_addr *servers,
+ size_t nservers)
+{
+ ares__llist_t *slist = NULL;
+ ares_status_t status;
+
+ status = ares_in_addr_to_server_config_llist(servers, nservers, &slist);
+ if (status != ARES_SUCCESS) {
+ return status;
+ }
+
+ status = ares__servers_update(channel, slist, ARES_TRUE);
+
+ ares__llist_destroy(slist);
+
+ return status;
+}
+
+ares_status_t ares__init_by_options(ares_channel_t *channel,
+ const struct ares_options *options,
+ int optmask)
+{
+ size_t i;
+
+ if (channel == NULL) {
+ return ARES_ENODATA;
+ }
+
+ if (options == NULL) {
+ if (optmask != 0) {
+ return ARES_ENODATA;
+ }
+ return ARES_SUCCESS;
+ }
+
+ /* Easy stuff. */
+ if (optmask & ARES_OPT_FLAGS) {
+ channel->flags = (unsigned int)options->flags;
+ }
+
+ if (optmask & ARES_OPT_TIMEOUTMS) {
+ /* Apparently some integrations were passing -1 to tell c-ares to use
+ * the default instead of just omitting the optmask */
+ if (options->timeout <= 0) {
+ optmask &= ~(ARES_OPT_TIMEOUTMS);
+ } else {
+ channel->timeout = (unsigned int)options->timeout;
+ }
+ } else if (optmask & ARES_OPT_TIMEOUT) {
+ optmask &= ~(ARES_OPT_TIMEOUT);
+ /* Apparently some integrations were passing -1 to tell c-ares to use
+ * the default instead of just omitting the optmask */
+ if (options->timeout > 0) {
+ /* Convert to milliseconds */
+ optmask |= ARES_OPT_TIMEOUTMS;
+ channel->timeout = (unsigned int)options->timeout * 1000;
+ }
+ }
+
+ if (optmask & ARES_OPT_TRIES) {
+ if (options->tries <= 0) {
+ optmask &= ~(ARES_OPT_TRIES);
+ } else {
+ channel->tries = (size_t)options->tries;
+ }
+ }
+
+ if (optmask & ARES_OPT_NDOTS) {
+ if (options->ndots <= 0) {
+ optmask &= ~(ARES_OPT_NDOTS);
+ } else {
+ channel->ndots = (size_t)options->ndots;
+ }
+ }
+
+ if (optmask & ARES_OPT_MAXTIMEOUTMS) {
+ if (options->maxtimeout <= 0) {
+ optmask &= ~(ARES_OPT_MAXTIMEOUTMS);
+ } else {
+ channel->maxtimeout = (size_t)options->maxtimeout;
+ }
+ }
+
+ if (optmask & ARES_OPT_ROTATE) {
+ channel->rotate = ARES_TRUE;
+ }
+
+ if (optmask & ARES_OPT_NOROTATE) {
+ channel->rotate = ARES_FALSE;
+ }
+
+ if (optmask & ARES_OPT_UDP_PORT) {
+ channel->udp_port = options->udp_port;
+ }
+
+ if (optmask & ARES_OPT_TCP_PORT) {
+ channel->tcp_port = options->tcp_port;
+ }
+
+ if (optmask & ARES_OPT_SOCK_STATE_CB) {
+ channel->sock_state_cb = options->sock_state_cb;
+ channel->sock_state_cb_data = options->sock_state_cb_data;
+ }
+
+ if (optmask & ARES_OPT_SOCK_SNDBUF) {
+ if (options->socket_send_buffer_size <= 0) {
+ optmask &= ~(ARES_OPT_SOCK_SNDBUF);
+ } else {
+ channel->socket_send_buffer_size = options->socket_send_buffer_size;
+ }
+ }
+
+ if (optmask & ARES_OPT_SOCK_RCVBUF) {
+ if (options->socket_receive_buffer_size <= 0) {
+ optmask &= ~(ARES_OPT_SOCK_RCVBUF);
+ } else {
+ channel->socket_receive_buffer_size = options->socket_receive_buffer_size;
+ }
+ }
+
+ if (optmask & ARES_OPT_EDNSPSZ) {
+ if (options->ednspsz <= 0) {
+ optmask &= ~(ARES_OPT_EDNSPSZ);
+ } else {
+ channel->ednspsz = (size_t)options->ednspsz;
+ }
+ }
+
+ /* Copy the domains, if given. Keep channel->ndomains consistent so
+ * we can clean up in case of error.
+ */
+ if (optmask & ARES_OPT_DOMAINS && options->ndomains > 0) {
+ channel->domains =
+ ares_malloc_zero((size_t)options->ndomains * sizeof(char *));
+ if (!channel->domains) {
+ return ARES_ENOMEM;
+ }
+ channel->ndomains = (size_t)options->ndomains;
+ for (i = 0; i < (size_t)options->ndomains; i++) {
+ channel->domains[i] = ares_strdup(options->domains[i]);
+ if (!channel->domains[i]) {
+ return ARES_ENOMEM;
+ }
+ }
+ }
+
+ /* Set lookups, if given. */
+ if (optmask & ARES_OPT_LOOKUPS) {
+ if (options->lookups == NULL) {
+ optmask &= ~(ARES_OPT_LOOKUPS);
+ } else {
+ channel->lookups = ares_strdup(options->lookups);
+ if (!channel->lookups) {
+ return ARES_ENOMEM;
+ }
+ }
+ }
+
+ /* copy sortlist */
+ if (optmask & ARES_OPT_SORTLIST && options->nsort > 0) {
+ channel->nsort = (size_t)options->nsort;
+ channel->sortlist =
+ ares_malloc((size_t)options->nsort * sizeof(struct apattern));
+ if (!channel->sortlist) {
+ return ARES_ENOMEM;
+ }
+ for (i = 0; i < (size_t)options->nsort; i++) {
+ channel->sortlist[i] = options->sortlist[i];
+ }
+ }
+
+ /* Set path for resolv.conf file, if given. */
+ if (optmask & ARES_OPT_RESOLVCONF) {
+ if (options->resolvconf_path == NULL) {
+ optmask &= ~(ARES_OPT_RESOLVCONF);
+ } else {
+ channel->resolvconf_path = ares_strdup(options->resolvconf_path);
+ if (channel->resolvconf_path == NULL) {
+ return ARES_ENOMEM;
+ }
+ }
+ }
+
+ /* Set path for hosts file, if given. */
+ if (optmask & ARES_OPT_HOSTS_FILE) {
+ if (options->hosts_path == NULL) {
+ optmask &= ~(ARES_OPT_HOSTS_FILE);
+ } else {
+ channel->hosts_path = ares_strdup(options->hosts_path);
+ if (channel->hosts_path == NULL) {
+ return ARES_ENOMEM;
+ }
+ }
+ }
+
+ if (optmask & ARES_OPT_UDP_MAX_QUERIES) {
+ if (options->udp_max_queries <= 0) {
+ optmask &= ~(ARES_OPT_UDP_MAX_QUERIES);
+ } else {
+ channel->udp_max_queries = (size_t)options->udp_max_queries;
+ }
+ }
+
+ if (optmask & ARES_OPT_QUERY_CACHE) {
+ /* qcache_max_ttl is unsigned unlike the others */
+ if (options->qcache_max_ttl == 0) {
+ optmask &= ~(ARES_OPT_QUERY_CACHE);
+ } else {
+ channel->qcache_max_ttl = options->qcache_max_ttl;
+ }
+ }
+
+ /* Initialize the ipv4 servers if provided */
+ if (optmask & ARES_OPT_SERVERS) {
+ if (options->nservers <= 0) {
+ optmask &= ~(ARES_OPT_SERVERS);
+ } else {
+ ares_status_t status;
+ status = ares__init_options_servers(channel, options->servers,
+ (size_t)options->nservers);
+ if (status != ARES_SUCCESS) {
+ return status;
+ }
+ }
+ }
+
+ channel->optmask = (unsigned int)optmask;
+
+ return ARES_SUCCESS;
+}
diff --git a/subprojects/c-ares/src/lib/ares_parse_a_reply.c b/subprojects/c-ares/src/lib/ares_parse_a_reply.c
@@ -0,0 +1,101 @@
+/* MIT License
+ *
+ * Copyright (c) 1998 Massachusetts Institute of Technology
+ * Copyright (c) 2019 Andrew Selivanov
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice (including the next
+ * paragraph) shall be included in all copies or substantial portions of the
+ * Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ *
+ * SPDX-License-Identifier: MIT
+ */
+
+#include "ares_setup.h"
+
+#ifdef HAVE_NETINET_IN_H
+# include <netinet/in.h>
+#endif
+#ifdef HAVE_NETDB_H
+# include <netdb.h>
+#endif
+#ifdef HAVE_ARPA_INET_H
+# include <arpa/inet.h>
+#endif
+
+#include "ares_nameser.h"
+
+#ifdef HAVE_STRINGS_H
+# include <strings.h>
+#endif
+
+#ifdef HAVE_LIMITS_H
+# include <limits.h>
+#endif
+
+#include "ares.h"
+#include "ares_dns.h"
+#include "ares_private.h"
+
+int ares_parse_a_reply(const unsigned char *abuf, int alen,
+ struct hostent **host, struct ares_addrttl *addrttls,
+ int *naddrttls)
+{
+ struct ares_addrinfo ai;
+ char *question_hostname = NULL;
+ ares_status_t status;
+ size_t req_naddrttls = 0;
+
+ if (alen < 0) {
+ return ARES_EBADRESP;
+ }
+
+ if (naddrttls) {
+ req_naddrttls = (size_t)*naddrttls;
+ *naddrttls = 0;
+ }
+
+ memset(&ai, 0, sizeof(ai));
+
+ status = ares__parse_into_addrinfo(abuf, (size_t)alen, 0, 0, &ai);
+ if (status != ARES_SUCCESS && status != ARES_ENODATA) {
+ goto fail;
+ }
+
+ if (host != NULL) {
+ status = ares__addrinfo2hostent(&ai, AF_INET, host);
+ if (status != ARES_SUCCESS && status != ARES_ENODATA) {
+ goto fail;
+ }
+ }
+
+ if (addrttls != NULL && req_naddrttls) {
+ size_t temp_naddrttls = 0;
+ ares__addrinfo2addrttl(&ai, AF_INET, req_naddrttls, addrttls, NULL,
+ &temp_naddrttls);
+ *naddrttls = (int)temp_naddrttls;
+ }
+
+
+fail:
+ ares__freeaddrinfo_cnames(ai.cnames);
+ ares__freeaddrinfo_nodes(ai.nodes);
+ ares_free(ai.name);
+ ares_free(question_hostname);
+
+ return (int)status;
+}
diff --git a/subprojects/c-ares/src/lib/ares_parse_aaaa_reply.c b/subprojects/c-ares/src/lib/ares_parse_aaaa_reply.c
@@ -0,0 +1,102 @@
+/* MIT License
+ *
+ * Copyright (c) 1998 Massachusetts Institute of Technology
+ * Copyright (c) 2005 Dominick Meglio
+ * Copyright (c) 2019 Andrew Selivanov
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice (including the next
+ * paragraph) shall be included in all copies or substantial portions of the
+ * Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ *
+ * SPDX-License-Identifier: MIT
+ */
+
+#include "ares_setup.h"
+
+#ifdef HAVE_NETINET_IN_H
+# include <netinet/in.h>
+#endif
+#ifdef HAVE_NETDB_H
+# include <netdb.h>
+#endif
+#ifdef HAVE_ARPA_INET_H
+# include <arpa/inet.h>
+#endif
+
+#include "ares_nameser.h"
+
+#ifdef HAVE_STRINGS_H
+# include <strings.h>
+#endif
+
+#ifdef HAVE_LIMITS_H
+# include <limits.h>
+#endif
+
+#include "ares.h"
+#include "ares_dns.h"
+#include "ares_inet_net_pton.h"
+#include "ares_private.h"
+
+int ares_parse_aaaa_reply(const unsigned char *abuf, int alen,
+ struct hostent **host, struct ares_addr6ttl *addrttls,
+ int *naddrttls)
+{
+ struct ares_addrinfo ai;
+ char *question_hostname = NULL;
+ ares_status_t status;
+ size_t req_naddrttls = 0;
+
+ if (alen < 0) {
+ return ARES_EBADRESP;
+ }
+
+ if (naddrttls) {
+ req_naddrttls = (size_t)*naddrttls;
+ *naddrttls = 0;
+ }
+
+ memset(&ai, 0, sizeof(ai));
+
+ status = ares__parse_into_addrinfo(abuf, (size_t)alen, 0, 0, &ai);
+ if (status != ARES_SUCCESS && status != ARES_ENODATA) {
+ goto fail;
+ }
+
+ if (host != NULL) {
+ status = ares__addrinfo2hostent(&ai, AF_INET6, host);
+ if (status != ARES_SUCCESS && status != ARES_ENODATA) {
+ goto fail;
+ }
+ }
+
+ if (addrttls != NULL && req_naddrttls) {
+ size_t temp_naddrttls = 0;
+ ares__addrinfo2addrttl(&ai, AF_INET6, req_naddrttls, NULL, addrttls,
+ &temp_naddrttls);
+ *naddrttls = (int)temp_naddrttls;
+ }
+
+fail:
+ ares__freeaddrinfo_cnames(ai.cnames);
+ ares__freeaddrinfo_nodes(ai.nodes);
+ ares_free(question_hostname);
+ ares_free(ai.name);
+
+ return (int)status;
+}
diff --git a/subprojects/c-ares/src/lib/ares_parse_caa_reply.c b/subprojects/c-ares/src/lib/ares_parse_caa_reply.c
@@ -0,0 +1,139 @@
+/* MIT License
+ *
+ * Copyright (c) 2023 Brad House
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice (including the next
+ * paragraph) shall be included in all copies or substantial portions of the
+ * Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ *
+ * SPDX-License-Identifier: MIT
+ */
+
+#include "ares_setup.h"
+#include "ares.h"
+#include "ares_data.h"
+#include "ares_private.h"
+
+int ares_parse_caa_reply(const unsigned char *abuf, int alen_int,
+ struct ares_caa_reply **caa_out)
+{
+ ares_status_t status;
+ size_t alen;
+ struct ares_caa_reply *caa_head = NULL;
+ struct ares_caa_reply *caa_last = NULL;
+ struct ares_caa_reply *caa_curr;
+ ares_dns_record_t *dnsrec = NULL;
+ size_t i;
+
+ *caa_out = NULL;
+
+ if (alen_int < 0) {
+ return ARES_EBADRESP;
+ }
+
+ alen = (size_t)alen_int;
+
+ status = ares_dns_parse(abuf, alen, 0, &dnsrec);
+ if (status != ARES_SUCCESS) {
+ goto done;
+ }
+
+ if (ares_dns_record_rr_cnt(dnsrec, ARES_SECTION_ANSWER) == 0) {
+ status = ARES_ENODATA;
+ goto done;
+ }
+
+ for (i = 0; i < ares_dns_record_rr_cnt(dnsrec, ARES_SECTION_ANSWER); i++) {
+ const unsigned char *ptr;
+ size_t ptr_len;
+ const ares_dns_rr_t *rr =
+ ares_dns_record_rr_get(dnsrec, ARES_SECTION_ANSWER, i);
+
+ if (rr == NULL) {
+ /* Shouldn't be possible */
+ status = ARES_EBADRESP;
+ goto done;
+ }
+
+ /* XXX: Why do we allow Chaos class? */
+ if (ares_dns_rr_get_class(rr) != ARES_CLASS_IN &&
+ ares_dns_rr_get_class(rr) != ARES_CLASS_CHAOS) {
+ continue;
+ }
+
+ /* Only looking for CAA records */
+ if (ares_dns_rr_get_type(rr) != ARES_REC_TYPE_CAA) {
+ continue;
+ }
+
+ /* Allocate storage for this CAA answer appending it to the list */
+ caa_curr = ares_malloc_data(ARES_DATATYPE_CAA_REPLY);
+ if (caa_curr == NULL) {
+ status = ARES_ENOMEM;
+ goto done;
+ }
+
+ /* Link in the record */
+ if (caa_last) {
+ caa_last->next = caa_curr;
+ } else {
+ caa_head = caa_curr;
+ }
+ caa_last = caa_curr;
+
+ caa_curr->critical = ares_dns_rr_get_u8(rr, ARES_RR_CAA_CRITICAL);
+ caa_curr->property =
+ (unsigned char *)ares_strdup(ares_dns_rr_get_str(rr, ARES_RR_CAA_TAG));
+ if (caa_curr->property == NULL) {
+ status = ARES_ENOMEM;
+ break;
+ }
+ /* RFC6844 says this can only be ascii, so not sure why we're recording a
+ * length */
+ caa_curr->plength = ares_strlen((const char *)caa_curr->property);
+
+ ptr = ares_dns_rr_get_bin(rr, ARES_RR_CAA_VALUE, &ptr_len);
+ if (ptr == NULL) {
+ status = ARES_EBADRESP;
+ goto done;
+ }
+
+ /* Wants NULL termination for some reason */
+ caa_curr->value = ares_malloc(ptr_len + 1);
+ if (caa_curr->value == NULL) {
+ status = ARES_ENOMEM;
+ goto done;
+ }
+ memcpy(caa_curr->value, ptr, ptr_len);
+ caa_curr->value[ptr_len] = 0;
+ caa_curr->length = ptr_len;
+ }
+
+done:
+ /* clean up on error */
+ if (status != ARES_SUCCESS) {
+ if (caa_head) {
+ ares_free_data(caa_head);
+ }
+ } else {
+ /* everything looks fine, return the data */
+ *caa_out = caa_head;
+ }
+ ares_dns_record_destroy(dnsrec);
+ return (int)status;
+}
diff --git a/subprojects/c-ares/src/lib/ares_parse_mx_reply.c b/subprojects/c-ares/src/lib/ares_parse_mx_reply.c
@@ -0,0 +1,112 @@
+/* MIT License
+ *
+ * Copyright (c) 2023 Brad House
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice (including the next
+ * paragraph) shall be included in all copies or substantial portions of the
+ * Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ *
+ * SPDX-License-Identifier: MIT
+ */
+
+#include "ares_setup.h"
+#include "ares.h"
+#include "ares_data.h"
+#include "ares_private.h"
+
+int ares_parse_mx_reply(const unsigned char *abuf, int alen_int,
+ struct ares_mx_reply **mx_out)
+{
+ ares_status_t status;
+ size_t alen;
+ struct ares_mx_reply *mx_head = NULL;
+ struct ares_mx_reply *mx_last = NULL;
+ struct ares_mx_reply *mx_curr;
+ ares_dns_record_t *dnsrec = NULL;
+ size_t i;
+
+ *mx_out = NULL;
+
+ if (alen_int < 0) {
+ return ARES_EBADRESP;
+ }
+
+ alen = (size_t)alen_int;
+
+ status = ares_dns_parse(abuf, alen, 0, &dnsrec);
+ if (status != ARES_SUCCESS) {
+ goto done;
+ }
+
+ if (ares_dns_record_rr_cnt(dnsrec, ARES_SECTION_ANSWER) == 0) {
+ status = ARES_ENODATA;
+ goto done;
+ }
+
+ for (i = 0; i < ares_dns_record_rr_cnt(dnsrec, ARES_SECTION_ANSWER); i++) {
+ const ares_dns_rr_t *rr =
+ ares_dns_record_rr_get(dnsrec, ARES_SECTION_ANSWER, i);
+
+ if (rr == NULL) {
+ /* Shouldn't be possible */
+ status = ARES_EBADRESP;
+ goto done;
+ }
+
+ if (ares_dns_rr_get_class(rr) != ARES_CLASS_IN ||
+ ares_dns_rr_get_type(rr) != ARES_REC_TYPE_MX) {
+ continue;
+ }
+
+ /* Allocate storage for this MX answer appending it to the list */
+ mx_curr = ares_malloc_data(ARES_DATATYPE_MX_REPLY);
+ if (mx_curr == NULL) {
+ status = ARES_ENOMEM;
+ goto done;
+ }
+
+ /* Link in the record */
+ if (mx_last) {
+ mx_last->next = mx_curr;
+ } else {
+ mx_head = mx_curr;
+ }
+ mx_last = mx_curr;
+
+ mx_curr->priority = ares_dns_rr_get_u16(rr, ARES_RR_MX_PREFERENCE);
+ mx_curr->host = ares_strdup(ares_dns_rr_get_str(rr, ARES_RR_MX_EXCHANGE));
+
+ if (mx_curr->host == NULL) {
+ status = ARES_ENOMEM;
+ goto done;
+ }
+ }
+
+done:
+ /* clean up on error */
+ if (status != ARES_SUCCESS) {
+ if (mx_head) {
+ ares_free_data(mx_head);
+ }
+ } else {
+ /* everything looks fine, return the data */
+ *mx_out = mx_head;
+ }
+ ares_dns_record_destroy(dnsrec);
+ return (int)status;
+}
diff --git a/subprojects/c-ares/src/lib/ares_parse_naptr_reply.c b/subprojects/c-ares/src/lib/ares_parse_naptr_reply.c
@@ -0,0 +1,134 @@
+/* MIT License
+ *
+ * Copyright (c) 2023 Brad House
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice (including the next
+ * paragraph) shall be included in all copies or substantial portions of the
+ * Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ *
+ * SPDX-License-Identifier: MIT
+ */
+#include "ares_setup.h"
+#include "ares.h"
+#include "ares_data.h"
+#include "ares_private.h"
+
+int ares_parse_naptr_reply(const unsigned char *abuf, int alen_int,
+ struct ares_naptr_reply **naptr_out)
+{
+ ares_status_t status;
+ size_t alen;
+ struct ares_naptr_reply *naptr_head = NULL;
+ struct ares_naptr_reply *naptr_last = NULL;
+ struct ares_naptr_reply *naptr_curr;
+ ares_dns_record_t *dnsrec = NULL;
+ size_t i;
+
+ *naptr_out = NULL;
+
+ if (alen_int < 0) {
+ return ARES_EBADRESP;
+ }
+
+ alen = (size_t)alen_int;
+
+ status = ares_dns_parse(abuf, alen, 0, &dnsrec);
+ if (status != ARES_SUCCESS) {
+ goto done;
+ }
+
+ if (ares_dns_record_rr_cnt(dnsrec, ARES_SECTION_ANSWER) == 0) {
+ status = ARES_ENODATA;
+ goto done;
+ }
+
+ for (i = 0; i < ares_dns_record_rr_cnt(dnsrec, ARES_SECTION_ANSWER); i++) {
+ const ares_dns_rr_t *rr =
+ ares_dns_record_rr_get(dnsrec, ARES_SECTION_ANSWER, i);
+
+ if (rr == NULL) {
+ /* Shouldn't be possible */
+ status = ARES_EBADRESP;
+ goto done;
+ }
+
+ if (ares_dns_rr_get_class(rr) != ARES_CLASS_IN ||
+ ares_dns_rr_get_type(rr) != ARES_REC_TYPE_NAPTR) {
+ continue;
+ }
+
+ /* Allocate storage for this NAPTR answer appending it to the list */
+ naptr_curr = ares_malloc_data(ARES_DATATYPE_NAPTR_REPLY);
+ if (naptr_curr == NULL) {
+ status = ARES_ENOMEM;
+ goto done;
+ }
+
+ /* Link in the record */
+ if (naptr_last) {
+ naptr_last->next = naptr_curr;
+ } else {
+ naptr_head = naptr_curr;
+ }
+ naptr_last = naptr_curr;
+
+ naptr_curr->order = ares_dns_rr_get_u16(rr, ARES_RR_NAPTR_ORDER);
+ naptr_curr->preference = ares_dns_rr_get_u16(rr, ARES_RR_NAPTR_PREFERENCE);
+
+ /* XXX: Why is this unsigned char * ? */
+ naptr_curr->flags = (unsigned char *)ares_strdup(
+ ares_dns_rr_get_str(rr, ARES_RR_NAPTR_FLAGS));
+ if (naptr_curr->flags == NULL) {
+ status = ARES_ENOMEM;
+ goto done;
+ }
+ /* XXX: Why is this unsigned char * ? */
+ naptr_curr->service = (unsigned char *)ares_strdup(
+ ares_dns_rr_get_str(rr, ARES_RR_NAPTR_SERVICES));
+ if (naptr_curr->service == NULL) {
+ status = ARES_ENOMEM;
+ goto done;
+ }
+ /* XXX: Why is this unsigned char * ? */
+ naptr_curr->regexp = (unsigned char *)ares_strdup(
+ ares_dns_rr_get_str(rr, ARES_RR_NAPTR_REGEXP));
+ if (naptr_curr->regexp == NULL) {
+ status = ARES_ENOMEM;
+ goto done;
+ }
+ naptr_curr->replacement =
+ ares_strdup(ares_dns_rr_get_str(rr, ARES_RR_NAPTR_REPLACEMENT));
+ if (naptr_curr->replacement == NULL) {
+ status = ARES_ENOMEM;
+ goto done;
+ }
+ }
+
+done:
+ /* clean up on error */
+ if (status != ARES_SUCCESS) {
+ if (naptr_head) {
+ ares_free_data(naptr_head);
+ }
+ } else {
+ /* everything looks fine, return the data */
+ *naptr_out = naptr_head;
+ }
+ ares_dns_record_destroy(dnsrec);
+ return (int)status;
+}
diff --git a/subprojects/c-ares/src/lib/ares_parse_ns_reply.c b/subprojects/c-ares/src/lib/ares_parse_ns_reply.c
@@ -0,0 +1,157 @@
+/* MIT License
+ *
+ * Copyright (c) 2023 Brad House
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice (including the next
+ * paragraph) shall be included in all copies or substantial portions of the
+ * Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ *
+ * SPDX-License-Identifier: MIT
+ */
+
+#include "ares_setup.h"
+
+#ifdef HAVE_NETINET_IN_H
+# include <netinet/in.h>
+#endif
+#ifdef HAVE_NETDB_H
+# include <netdb.h>
+#endif
+#ifdef HAVE_ARPA_INET_H
+# include <arpa/inet.h>
+#endif
+
+#include "ares.h"
+#include "ares_private.h"
+
+int ares_parse_ns_reply(const unsigned char *abuf, int alen_int,
+ struct hostent **host)
+{
+ ares_status_t status;
+ size_t alen;
+ size_t nscount = 0;
+ struct hostent *hostent = NULL;
+ const char *hostname = NULL;
+ ares_dns_record_t *dnsrec = NULL;
+ size_t i;
+ size_t ancount;
+
+ *host = NULL;
+
+ if (alen_int < 0) {
+ return ARES_EBADRESP;
+ }
+
+ alen = (size_t)alen_int;
+
+ status = ares_dns_parse(abuf, alen, 0, &dnsrec);
+ if (status != ARES_SUCCESS) {
+ goto done;
+ }
+
+ ancount = ares_dns_record_rr_cnt(dnsrec, ARES_SECTION_ANSWER);
+ if (ancount == 0) {
+ status = ARES_ENODATA;
+ goto done;
+ }
+
+ /* Response structure */
+ hostent = ares_malloc(sizeof(*hostent));
+ if (hostent == NULL) {
+ status = ARES_ENOMEM;
+ goto done;
+ }
+
+ memset(hostent, 0, sizeof(*hostent));
+
+ hostent->h_addr_list = ares_malloc(sizeof(*hostent->h_addr_list));
+ if (hostent->h_addr_list == NULL) {
+ status = ARES_ENOMEM;
+ goto done;
+ }
+ hostent->h_addr_list[0] = NULL;
+ hostent->h_addrtype = AF_INET;
+ hostent->h_length = sizeof(struct in_addr);
+
+ /* Fill in hostname */
+ status = ares_dns_record_query_get(dnsrec, 0, &hostname, NULL, NULL);
+ if (status != ARES_SUCCESS) {
+ goto done;
+ }
+ hostent->h_name = ares_strdup(hostname);
+ if (hostent->h_name == NULL) {
+ status = ARES_ENOMEM;
+ goto done;
+ }
+
+ /* Preallocate the maximum number + 1 */
+ hostent->h_aliases = ares_malloc((ancount + 1) * sizeof(*hostent->h_aliases));
+ if (hostent->h_aliases == NULL) {
+ status = ARES_ENOMEM;
+ goto done;
+ }
+ memset(hostent->h_aliases, 0, (ancount + 1) * sizeof(*hostent->h_aliases));
+
+ for (i = 0; i < ancount; i++) {
+ const ares_dns_rr_t *rr =
+ ares_dns_record_rr_get(dnsrec, ARES_SECTION_ANSWER, i);
+
+ if (rr == NULL) {
+ /* Shouldn't be possible */
+ status = ARES_EBADRESP;
+ goto done;
+ }
+
+ if (ares_dns_rr_get_class(rr) != ARES_CLASS_IN ||
+ ares_dns_rr_get_type(rr) != ARES_REC_TYPE_NS) {
+ continue;
+ }
+
+ hostname = ares_dns_rr_get_str(rr, ARES_RR_NS_NSDNAME);
+ if (hostname == NULL) {
+ status = ARES_EBADRESP;
+ goto done;
+ }
+
+ hostent->h_aliases[nscount] = ares_strdup(hostname);
+ if (hostent->h_aliases[nscount] == NULL) {
+ status = ARES_ENOMEM;
+ goto done;
+ }
+ nscount++;
+ }
+
+ if (nscount == 0) {
+ status = ARES_ENODATA;
+ } else {
+ status = ARES_SUCCESS;
+ }
+
+done:
+ if (status != ARES_SUCCESS) {
+ ares_free_hostent(hostent);
+ /* Compatibility */
+ if (status == ARES_EBADNAME) {
+ status = ARES_EBADRESP;
+ }
+ } else {
+ *host = hostent;
+ }
+ ares_dns_record_destroy(dnsrec);
+ return (int)status;
+}
diff --git a/subprojects/c-ares/src/lib/ares_parse_ptr_reply.c b/subprojects/c-ares/src/lib/ares_parse_ptr_reply.c
@@ -0,0 +1,198 @@
+/* MIT License
+ *
+ * Copyright (c) 2023 Brad House
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice (including the next
+ * paragraph) shall be included in all copies or substantial portions of the
+ * Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ *
+ * SPDX-License-Identifier: MIT
+ */
+
+#include "ares_setup.h"
+
+#ifdef HAVE_NETINET_IN_H
+# include <netinet/in.h>
+#endif
+#ifdef HAVE_NETDB_H
+# include <netdb.h>
+#endif
+
+#include "ares.h"
+#include "ares_private.h"
+
+int ares_parse_ptr_reply(const unsigned char *abuf, int alen_int,
+ const void *addr, int addrlen, int family,
+ struct hostent **host)
+{
+ ares_status_t status;
+ size_t alen;
+ size_t ptrcount = 0;
+ struct hostent *hostent = NULL;
+ const char *hostname = NULL;
+ const char *ptrname = NULL;
+ ares_dns_record_t *dnsrec = NULL;
+ size_t i;
+ size_t ancount;
+
+ *host = NULL;
+
+ if (alen_int < 0) {
+ return ARES_EBADRESP;
+ }
+
+ alen = (size_t)alen_int;
+
+ status = ares_dns_parse(abuf, alen, 0, &dnsrec);
+ if (status != ARES_SUCCESS) {
+ goto done;
+ }
+
+ /* Fetch name from query as we will use it to compare later on. Old code
+ * did this check, so we'll retain it. */
+ status = ares_dns_record_query_get(dnsrec, 0, &ptrname, NULL, NULL);
+ if (status != ARES_SUCCESS) {
+ goto done;
+ }
+
+ ancount = ares_dns_record_rr_cnt(dnsrec, ARES_SECTION_ANSWER);
+ if (ancount == 0) {
+ status = ARES_ENODATA;
+ goto done;
+ }
+
+ /* Response structure */
+ hostent = ares_malloc(sizeof(*hostent));
+ if (hostent == NULL) {
+ status = ARES_ENOMEM;
+ goto done;
+ }
+
+ memset(hostent, 0, sizeof(*hostent));
+
+ hostent->h_addr_list = ares_malloc(2 * sizeof(*hostent->h_addr_list));
+ if (hostent->h_addr_list == NULL) {
+ status = ARES_ENOMEM;
+ goto done;
+ }
+ memset(hostent->h_addr_list, 0, 2 * sizeof(*hostent->h_addr_list));
+ if (addr != NULL && addrlen > 0) {
+ hostent->h_addr_list[0] = ares_malloc((size_t)addrlen);
+ if (hostent->h_addr_list[0] == NULL) {
+ status = ARES_ENOMEM;
+ goto done;
+ }
+ memcpy(hostent->h_addr_list[0], addr, (size_t)addrlen);
+ }
+ hostent->h_addrtype = (HOSTENT_ADDRTYPE_TYPE)family;
+ hostent->h_length = (HOSTENT_LENGTH_TYPE)addrlen;
+
+ /* Preallocate the maximum number + 1 */
+ hostent->h_aliases = ares_malloc((ancount + 1) * sizeof(*hostent->h_aliases));
+ if (hostent->h_aliases == NULL) {
+ status = ARES_ENOMEM;
+ goto done;
+ }
+ memset(hostent->h_aliases, 0, (ancount + 1) * sizeof(*hostent->h_aliases));
+
+
+ /* Cycle through answers */
+ for (i = 0; i < ancount; i++) {
+ const char *rname = NULL;
+ const ares_dns_rr_t *rr =
+ ares_dns_record_rr_get(dnsrec, ARES_SECTION_ANSWER, i);
+
+ if (rr == NULL) {
+ /* Shouldn't be possible */
+ status = ARES_EBADRESP;
+ goto done;
+ }
+
+ if (ares_dns_rr_get_class(rr) != ARES_CLASS_IN) {
+ continue;
+ }
+
+ /* Any time we see a CNAME, replace our ptrname with its value */
+ if (ares_dns_rr_get_type(rr) == ARES_REC_TYPE_CNAME) {
+ ptrname = ares_dns_rr_get_str(rr, ARES_RR_CNAME_CNAME);
+ if (ptrname == NULL) {
+ status = ARES_EBADRESP;
+ goto done;
+ }
+ }
+
+ /* Handling for PTR records below this, otherwise skip */
+ if (ares_dns_rr_get_type(rr) != ARES_REC_TYPE_PTR) {
+ continue;
+ }
+
+ /* Old code compared the name in the rr to the ptrname, so we'll do that
+ * check here, but I'm not sure its necessary */
+ rname = ares_dns_rr_get_name(rr);
+ if (rname == NULL) {
+ /* Shouldn't be possible */
+ status = ARES_EBADRESP;
+ goto done;
+ }
+ if (strcasecmp(ptrname, rname) != 0) {
+ continue;
+ }
+
+ /* Save most recent PTR record as the hostname */
+ hostname = ares_dns_rr_get_str(rr, ARES_RR_PTR_DNAME);
+ if (hostname == NULL) {
+ status = ARES_EBADRESP;
+ goto done;
+ }
+
+ /* Append as an alias */
+ hostent->h_aliases[ptrcount] = ares_strdup(hostname);
+ if (hostent->h_aliases[ptrcount] == NULL) {
+ status = ARES_ENOMEM;
+ goto done;
+ }
+ ptrcount++;
+ }
+
+ if (ptrcount == 0) {
+ status = ARES_ENODATA;
+ goto done;
+ } else {
+ status = ARES_SUCCESS;
+ }
+
+ /* Fill in hostname */
+ hostent->h_name = ares_strdup(hostname);
+ if (hostent->h_name == NULL) {
+ status = ARES_ENOMEM;
+ goto done;
+ }
+
+done:
+ if (status != ARES_SUCCESS) {
+ ares_free_hostent(hostent);
+ /* Compatibility */
+ if (status == ARES_EBADNAME) {
+ status = ARES_EBADRESP;
+ }
+ } else {
+ *host = hostent;
+ }
+ ares_dns_record_destroy(dnsrec);
+ return (int)status;
+}
diff --git a/subprojects/c-ares/src/lib/ares_parse_soa_reply.c b/subprojects/c-ares/src/lib/ares_parse_soa_reply.c
@@ -0,0 +1,117 @@
+/* MIT License
+ *
+ * Copyright (c) 2023 Brad House
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice (including the next
+ * paragraph) shall be included in all copies or substantial portions of the
+ * Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ *
+ * SPDX-License-Identifier: MIT
+ */
+
+#include "ares_setup.h"
+#include "ares.h"
+#include "ares_data.h"
+#include "ares_private.h"
+
+int ares_parse_soa_reply(const unsigned char *abuf, int alen_int,
+ struct ares_soa_reply **soa_out)
+{
+ ares_status_t status;
+ size_t alen;
+ struct ares_soa_reply *soa = NULL;
+ ares_dns_record_t *dnsrec = NULL;
+ size_t i;
+
+ *soa_out = NULL;
+
+ if (alen_int < 0) {
+ return ARES_EBADRESP;
+ }
+
+ alen = (size_t)alen_int;
+
+ status = ares_dns_parse(abuf, alen, 0, &dnsrec);
+ if (status != ARES_SUCCESS) {
+ goto done;
+ }
+
+ if (ares_dns_record_rr_cnt(dnsrec, ARES_SECTION_ANSWER) == 0) {
+ status = ARES_EBADRESP; /* ENODATA might make more sense */
+ goto done;
+ }
+
+ for (i = 0; i < ares_dns_record_rr_cnt(dnsrec, ARES_SECTION_ANSWER); i++) {
+ const ares_dns_rr_t *rr =
+ ares_dns_record_rr_get(dnsrec, ARES_SECTION_ANSWER, i);
+
+ if (rr == NULL) {
+ /* Shouldn't be possible */
+ status = ARES_EBADRESP;
+ goto done;
+ }
+
+ if (ares_dns_rr_get_class(rr) != ARES_CLASS_IN ||
+ ares_dns_rr_get_type(rr) != ARES_REC_TYPE_SOA) {
+ continue;
+ }
+
+ /* allocate result struct */
+ soa = ares_malloc_data(ARES_DATATYPE_SOA_REPLY);
+ if (soa == NULL) {
+ status = ARES_ENOMEM;
+ goto done;
+ }
+
+ soa->serial = ares_dns_rr_get_u32(rr, ARES_RR_SOA_SERIAL);
+ soa->refresh = ares_dns_rr_get_u32(rr, ARES_RR_SOA_REFRESH);
+ soa->retry = ares_dns_rr_get_u32(rr, ARES_RR_SOA_RETRY);
+ soa->expire = ares_dns_rr_get_u32(rr, ARES_RR_SOA_EXPIRE);
+ soa->minttl = ares_dns_rr_get_u32(rr, ARES_RR_SOA_MINIMUM);
+ soa->nsname = ares_strdup(ares_dns_rr_get_str(rr, ARES_RR_SOA_MNAME));
+ if (soa->nsname == NULL) {
+ status = ARES_ENOMEM;
+ goto done;
+ }
+ soa->hostmaster = ares_strdup(ares_dns_rr_get_str(rr, ARES_RR_SOA_RNAME));
+ if (soa->hostmaster == NULL) {
+ status = ARES_ENOMEM;
+ goto done;
+ }
+ break;
+ }
+
+ if (soa == NULL) {
+ status = ARES_EBADRESP;
+ }
+
+done:
+ /* clean up on error */
+ if (status != ARES_SUCCESS) {
+ ares_free_data(soa);
+ /* Compatibility */
+ if (status == ARES_EBADNAME) {
+ status = ARES_EBADRESP;
+ }
+ } else {
+ /* everything looks fine, return the data */
+ *soa_out = soa;
+ }
+ ares_dns_record_destroy(dnsrec);
+ return (int)status;
+}
diff --git a/subprojects/c-ares/src/lib/ares_parse_srv_reply.c b/subprojects/c-ares/src/lib/ares_parse_srv_reply.c
@@ -0,0 +1,116 @@
+/* MIT License
+ *
+ * Copyright (c) 2023 Brad House
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice (including the next
+ * paragraph) shall be included in all copies or substantial portions of the
+ * Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ *
+ * SPDX-License-Identifier: MIT
+ */
+
+#include "ares_setup.h"
+#include "ares.h"
+#include "ares_data.h"
+#include "ares_private.h"
+
+int ares_parse_srv_reply(const unsigned char *abuf, int alen_int,
+ struct ares_srv_reply **srv_out)
+{
+ ares_status_t status;
+ size_t alen;
+ struct ares_srv_reply *srv_head = NULL;
+ struct ares_srv_reply *srv_last = NULL;
+ struct ares_srv_reply *srv_curr;
+ ares_dns_record_t *dnsrec = NULL;
+ size_t i;
+
+ *srv_out = NULL;
+
+ if (alen_int < 0) {
+ return ARES_EBADRESP;
+ }
+
+ alen = (size_t)alen_int;
+
+ status = ares_dns_parse(abuf, alen, 0, &dnsrec);
+ if (status != ARES_SUCCESS) {
+ goto done;
+ }
+
+ if (ares_dns_record_rr_cnt(dnsrec, ARES_SECTION_ANSWER) == 0) {
+ status = ARES_ENODATA;
+ goto done;
+ }
+
+ for (i = 0; i < ares_dns_record_rr_cnt(dnsrec, ARES_SECTION_ANSWER); i++) {
+ const ares_dns_rr_t *rr =
+ ares_dns_record_rr_get(dnsrec, ARES_SECTION_ANSWER, i);
+
+ if (rr == NULL) {
+ /* Shouldn't be possible */
+ status = ARES_EBADRESP;
+ goto done;
+ }
+
+ if (ares_dns_rr_get_class(rr) != ARES_CLASS_IN ||
+ ares_dns_rr_get_type(rr) != ARES_REC_TYPE_SRV) {
+ continue;
+ }
+
+ /* Allocate storage for this SRV answer appending it to the list */
+ srv_curr = ares_malloc_data(ARES_DATATYPE_SRV_REPLY);
+ if (srv_curr == NULL) {
+ status = ARES_ENOMEM;
+ goto done;
+ }
+
+ /* Link in the record */
+ if (srv_last) {
+ srv_last->next = srv_curr;
+ } else {
+ srv_head = srv_curr;
+ }
+ srv_last = srv_curr;
+
+
+ srv_curr->priority = ares_dns_rr_get_u16(rr, ARES_RR_SRV_PRIORITY);
+ srv_curr->weight = ares_dns_rr_get_u16(rr, ARES_RR_SRV_WEIGHT);
+ srv_curr->port = ares_dns_rr_get_u16(rr, ARES_RR_SRV_PORT);
+
+ srv_curr->host = ares_strdup(ares_dns_rr_get_str(rr, ARES_RR_SRV_TARGET));
+
+ if (srv_curr->host == NULL) {
+ status = ARES_ENOMEM;
+ goto done;
+ }
+ }
+
+done:
+ /* clean up on error */
+ if (status != ARES_SUCCESS) {
+ if (srv_head) {
+ ares_free_data(srv_head);
+ }
+ } else {
+ /* everything looks fine, return the data */
+ *srv_out = srv_head;
+ }
+ ares_dns_record_destroy(dnsrec);
+ return (int)status;
+}
diff --git a/subprojects/c-ares/src/lib/ares_parse_txt_reply.c b/subprojects/c-ares/src/lib/ares_parse_txt_reply.c
@@ -0,0 +1,137 @@
+/* MIT License
+ *
+ * Copyright (c) 2023 Brad House
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice (including the next
+ * paragraph) shall be included in all copies or substantial portions of the
+ * Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ *
+ * SPDX-License-Identifier: MIT
+ */
+
+#include "ares_setup.h"
+#include "ares.h"
+#include "ares_data.h"
+#include "ares_private.h"
+
+static int ares__parse_txt_reply(const unsigned char *abuf, size_t alen,
+ ares_bool_t ex, void **txt_out)
+{
+ ares_status_t status;
+ struct ares_txt_ext *txt_head = NULL;
+ struct ares_txt_ext *txt_last = NULL;
+ struct ares_txt_ext *txt_curr;
+ ares_dns_record_t *dnsrec = NULL;
+ size_t i;
+
+ *txt_out = NULL;
+
+ status = ares_dns_parse(abuf, alen, 0, &dnsrec);
+ if (status != ARES_SUCCESS) {
+ goto done;
+ }
+
+ if (ares_dns_record_rr_cnt(dnsrec, ARES_SECTION_ANSWER) == 0) {
+ status = ARES_ENODATA;
+ goto done;
+ }
+
+ for (i = 0; i < ares_dns_record_rr_cnt(dnsrec, ARES_SECTION_ANSWER); i++) {
+ const ares_dns_rr_t *rr =
+ ares_dns_record_rr_get(dnsrec, ARES_SECTION_ANSWER, i);
+ const unsigned char *ptr;
+ size_t ptr_len;
+
+ if (rr == NULL) {
+ /* Shouldn't be possible */
+ status = ARES_EBADRESP;
+ goto done;
+ }
+
+ /* XXX: Why Chaos? */
+ if ((ares_dns_rr_get_class(rr) != ARES_CLASS_IN &&
+ ares_dns_rr_get_class(rr) != ARES_CLASS_CHAOS) ||
+ ares_dns_rr_get_type(rr) != ARES_REC_TYPE_TXT) {
+ continue;
+ }
+
+ /* Allocate storage for this TXT answer appending it to the list */
+ txt_curr =
+ ares_malloc_data(ex ? ARES_DATATYPE_TXT_EXT : ARES_DATATYPE_TXT_REPLY);
+ if (txt_curr == NULL) {
+ status = ARES_ENOMEM;
+ goto done;
+ }
+
+ /* Link in the record */
+ if (txt_last) {
+ txt_last->next = txt_curr;
+ } else {
+ txt_head = txt_curr;
+ }
+ txt_last = txt_curr;
+
+ /* These days, records are joined, always tag as start */
+ if (ex) {
+ txt_curr->record_start = 1;
+ }
+
+ ptr = ares_dns_rr_get_bin(rr, ARES_RR_TXT_DATA, &ptr_len);
+
+ txt_curr->txt = ares_malloc(ptr_len + 1);
+ if (txt_curr->txt == NULL) {
+ status = ARES_ENOMEM;
+ goto done;
+ }
+ memcpy(txt_curr->txt, ptr, ptr_len);
+ txt_curr->txt[ptr_len] = 0;
+ txt_curr->length = ptr_len;
+ }
+
+done:
+ /* clean up on error */
+ if (status != ARES_SUCCESS) {
+ if (txt_head) {
+ ares_free_data(txt_head);
+ }
+ } else {
+ /* everything looks fine, return the data */
+ *txt_out = txt_head;
+ }
+ ares_dns_record_destroy(dnsrec);
+ return (int)status;
+}
+
+int ares_parse_txt_reply(const unsigned char *abuf, int alen,
+ struct ares_txt_reply **txt_out)
+{
+ if (alen < 0) {
+ return ARES_EBADRESP;
+ }
+ return ares__parse_txt_reply(abuf, (size_t)alen, ARES_FALSE,
+ (void **)txt_out);
+}
+
+int ares_parse_txt_reply_ext(const unsigned char *abuf, int alen,
+ struct ares_txt_ext **txt_out)
+{
+ if (alen < 0) {
+ return ARES_EBADRESP;
+ }
+ return ares__parse_txt_reply(abuf, (size_t)alen, ARES_TRUE, (void **)txt_out);
+}
diff --git a/subprojects/c-ares/src/lib/ares_parse_uri_reply.c b/subprojects/c-ares/src/lib/ares_parse_uri_reply.c
@@ -0,0 +1,115 @@
+/* MIT License
+ *
+ * Copyright (c) 2023 Brad House
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice (including the next
+ * paragraph) shall be included in all copies or substantial portions of the
+ * Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ *
+ * SPDX-License-Identifier: MIT
+ */
+
+#include "ares_setup.h"
+#include "ares.h"
+#include "ares_data.h"
+#include "ares_private.h"
+
+int ares_parse_uri_reply(const unsigned char *abuf, int alen_int,
+ struct ares_uri_reply **uri_out)
+{
+ ares_status_t status;
+ size_t alen;
+ struct ares_uri_reply *uri_head = NULL;
+ struct ares_uri_reply *uri_last = NULL;
+ struct ares_uri_reply *uri_curr;
+ ares_dns_record_t *dnsrec = NULL;
+ size_t i;
+
+ *uri_out = NULL;
+
+ if (alen_int < 0) {
+ return ARES_EBADRESP;
+ }
+
+ alen = (size_t)alen_int;
+
+ status = ares_dns_parse(abuf, alen, 0, &dnsrec);
+ if (status != ARES_SUCCESS) {
+ goto done;
+ }
+
+ if (ares_dns_record_rr_cnt(dnsrec, ARES_SECTION_ANSWER) == 0) {
+ status = ARES_ENODATA;
+ goto done;
+ }
+
+ for (i = 0; i < ares_dns_record_rr_cnt(dnsrec, ARES_SECTION_ANSWER); i++) {
+ const ares_dns_rr_t *rr =
+ ares_dns_record_rr_get(dnsrec, ARES_SECTION_ANSWER, i);
+
+ if (rr == NULL) {
+ /* Shouldn't be possible */
+ status = ARES_EBADRESP;
+ goto done;
+ }
+
+ if (ares_dns_rr_get_class(rr) != ARES_CLASS_IN ||
+ ares_dns_rr_get_type(rr) != ARES_REC_TYPE_URI) {
+ continue;
+ }
+
+ /* Allocate storage for this URI answer appending it to the list */
+ uri_curr = ares_malloc_data(ARES_DATATYPE_URI_REPLY);
+ if (uri_curr == NULL) {
+ status = ARES_ENOMEM;
+ goto done;
+ }
+
+ /* Link in the record */
+ if (uri_last) {
+ uri_last->next = uri_curr;
+ } else {
+ uri_head = uri_curr;
+ }
+ uri_last = uri_curr;
+
+
+ uri_curr->priority = ares_dns_rr_get_u16(rr, ARES_RR_URI_PRIORITY);
+ uri_curr->weight = ares_dns_rr_get_u16(rr, ARES_RR_URI_WEIGHT);
+ uri_curr->uri = ares_strdup(ares_dns_rr_get_str(rr, ARES_RR_URI_TARGET));
+ uri_curr->ttl = (int)ares_dns_rr_get_ttl(rr);
+
+ if (uri_curr->uri == NULL) {
+ status = ARES_ENOMEM;
+ goto done;
+ }
+ }
+
+done:
+ /* clean up on error */
+ if (status != ARES_SUCCESS) {
+ if (uri_head) {
+ ares_free_data(uri_head);
+ }
+ } else {
+ /* everything looks fine, return the data */
+ *uri_out = uri_head;
+ }
+ ares_dns_record_destroy(dnsrec);
+ return (int)status;
+}
diff --git a/subprojects/c-ares/src/lib/ares_platform.c b/subprojects/c-ares/src/lib/ares_platform.c
@@ -0,0 +1,11050 @@
+/* MIT License
+ *
+ * Copyright (c) 1998 Massachusetts Institute of Technology
+ * Copyright (c) 2004 Daniel Stenberg
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice (including the next
+ * paragraph) shall be included in all copies or substantial portions of the
+ * Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ *
+ * SPDX-License-Identifier: MIT
+ */
+
+#include "ares_setup.h"
+
+#include "ares.h"
+#include "ares_platform.h"
+#include "ares_private.h"
+
+#if defined(WIN32) && !defined(MSDOS)
+
+# define V_PLATFORM_WIN32s 0
+# define V_PLATFORM_WIN32_WINDOWS 1
+# define V_PLATFORM_WIN32_NT 2
+# define V_PLATFORM_WIN32_CE 3
+
+win_platform ares__getplatform(void)
+{
+ OSVERSIONINFOEX OsvEx;
+
+ memset(&OsvEx, 0, sizeof(OsvEx));
+ OsvEx.dwOSVersionInfoSize = sizeof(OSVERSIONINFOEX);
+# ifdef _MSC_VER
+# pragma warning(push)
+# pragma warning(disable : 4996) /* warning C4996: 'GetVersionExW': was \
+ declared deprecated */
+# endif
+ if (!GetVersionEx((void *)&OsvEx)) {
+ memset(&OsvEx, 0, sizeof(OsvEx));
+ OsvEx.dwOSVersionInfoSize = sizeof(OSVERSIONINFO);
+ if (!GetVersionEx((void *)&OsvEx)) {
+ return WIN_UNKNOWN;
+ }
+ }
+# ifdef _MSC_VER
+# pragma warning(pop)
+# endif
+
+ switch (OsvEx.dwPlatformId) {
+ case V_PLATFORM_WIN32s:
+ return WIN_3X;
+
+ case V_PLATFORM_WIN32_WINDOWS:
+ return WIN_9X;
+
+ case V_PLATFORM_WIN32_NT:
+ return WIN_NT;
+
+ case V_PLATFORM_WIN32_CE:
+ return WIN_CE;
+
+ default:
+ return WIN_UNKNOWN;
+ }
+}
+
+#endif /* WIN32 && ! MSDOS */
+
+#if defined(_WIN32_WCE)
+
+/* IANA Well Known Ports are in range 0-1023 */
+# define USE_IANA_WELL_KNOWN_PORTS 1
+
+/* IANA Registered Ports are in range 1024-49151 */
+# define USE_IANA_REGISTERED_PORTS 1
+
+struct pvt_servent {
+ char *s_name;
+ char **s_aliases;
+ unsigned short s_port;
+ char *s_proto;
+};
+
+/*
+ * Ref: http://www.iana.org/assignments/port-numbers
+ */
+
+static struct pvt_servent IANAports[] = {
+# ifdef USE_IANA_WELL_KNOWN_PORTS
+ {"tcpmux", { NULL }, 1, "tcp" },
+ { "tcpmux", { NULL }, 1, "udp" },
+ { "compressnet", { NULL }, 2, "tcp" },
+ { "compressnet", { NULL }, 2, "udp" },
+ { "compressnet", { NULL }, 3, "tcp" },
+ { "compressnet", { NULL }, 3, "udp" },
+ { "rje", { NULL }, 5, "tcp" },
+ { "rje", { NULL }, 5, "udp" },
+ { "echo", { NULL }, 7, "tcp" },
+ { "echo", { NULL }, 7, "udp" },
+ { "discard", { NULL }, 9, "tcp" },
+ { "discard", { NULL }, 9, "udp" },
+ { "discard", { NULL }, 9, "sctp"},
+ { "discard", { NULL }, 9, "dccp"},
+ { "systat", { NULL }, 11, "tcp" },
+ { "systat", { NULL }, 11, "udp" },
+ { "daytime", { NULL }, 13, "tcp" },
+ { "daytime", { NULL }, 13, "udp" },
+ { "qotd", { NULL }, 17, "tcp" },
+ { "qotd", { NULL }, 17, "udp" },
+ { "msp", { NULL }, 18, "tcp" },
+ { "msp", { NULL }, 18, "udp" },
+ { "chargen", { NULL }, 19, "tcp" },
+ { "chargen", { NULL }, 19, "udp" },
+ { "ftp-data", { NULL }, 20, "tcp" },
+ { "ftp-data", { NULL }, 20, "udp" },
+ { "ftp-data", { NULL }, 20, "sctp"},
+ { "ftp", { NULL }, 21, "tcp" },
+ { "ftp", { NULL }, 21, "udp" },
+ { "ftp", { NULL }, 21, "sctp"},
+ { "ssh", { NULL }, 22, "tcp" },
+ { "ssh", { NULL }, 22, "udp" },
+ { "ssh", { NULL }, 22, "sctp"},
+ { "telnet", { NULL }, 23, "tcp" },
+ { "telnet", { NULL }, 23, "udp" },
+ { "smtp", { NULL }, 25, "tcp" },
+ { "smtp", { NULL }, 25, "udp" },
+ { "nsw-fe", { NULL }, 27, "tcp" },
+ { "nsw-fe", { NULL }, 27, "udp" },
+ { "msg-icp", { NULL }, 29, "tcp" },
+ { "msg-icp", { NULL }, 29, "udp" },
+ { "msg-auth", { NULL }, 31, "tcp" },
+ { "msg-auth", { NULL }, 31, "udp" },
+ { "dsp", { NULL }, 33, "tcp" },
+ { "dsp", { NULL }, 33, "udp" },
+ { "time", { NULL }, 37, "tcp" },
+ { "time", { NULL }, 37, "udp" },
+ { "rap", { NULL }, 38, "tcp" },
+ { "rap", { NULL }, 38, "udp" },
+ { "rlp", { NULL }, 39, "tcp" },
+ { "rlp", { NULL }, 39, "udp" },
+ { "graphics", { NULL }, 41, "tcp" },
+ { "graphics", { NULL }, 41, "udp" },
+ { "name", { NULL }, 42, "tcp" },
+ { "name", { NULL }, 42, "udp" },
+ { "nameserver", { NULL }, 42, "tcp" },
+ { "nameserver", { NULL }, 42, "udp" },
+ { "nicname", { NULL }, 43, "tcp" },
+ { "nicname", { NULL }, 43, "udp" },
+ { "mpm-flags", { NULL }, 44, "tcp" },
+ { "mpm-flags", { NULL }, 44, "udp" },
+ { "mpm", { NULL }, 45, "tcp" },
+ { "mpm", { NULL }, 45, "udp" },
+ { "mpm-snd", { NULL }, 46, "tcp" },
+ { "mpm-snd", { NULL }, 46, "udp" },
+ { "ni-ftp", { NULL }, 47, "tcp" },
+ { "ni-ftp", { NULL }, 47, "udp" },
+ { "auditd", { NULL }, 48, "tcp" },
+ { "auditd", { NULL }, 48, "udp" },
+ { "tacacs", { NULL }, 49, "tcp" },
+ { "tacacs", { NULL }, 49, "udp" },
+ { "re-mail-ck", { NULL }, 50, "tcp" },
+ { "re-mail-ck", { NULL }, 50, "udp" },
+ { "la-maint", { NULL }, 51, "tcp" },
+ { "la-maint", { NULL }, 51, "udp" },
+ { "xns-time", { NULL }, 52, "tcp" },
+ { "xns-time", { NULL }, 52, "udp" },
+ { "domain", { NULL }, 53, "tcp" },
+ { "domain", { NULL }, 53, "udp" },
+ { "xns-ch", { NULL }, 54, "tcp" },
+ { "xns-ch", { NULL }, 54, "udp" },
+ { "isi-gl", { NULL }, 55, "tcp" },
+ { "isi-gl", { NULL }, 55, "udp" },
+ { "xns-auth", { NULL }, 56, "tcp" },
+ { "xns-auth", { NULL }, 56, "udp" },
+ { "xns-mail", { NULL }, 58, "tcp" },
+ { "xns-mail", { NULL }, 58, "udp" },
+ { "ni-mail", { NULL }, 61, "tcp" },
+ { "ni-mail", { NULL }, 61, "udp" },
+ { "acas", { NULL }, 62, "tcp" },
+ { "acas", { NULL }, 62, "udp" },
+ { "whois++", { NULL }, 63, "tcp" },
+ { "whois++", { NULL }, 63, "udp" },
+ { "covia", { NULL }, 64, "tcp" },
+ { "covia", { NULL }, 64, "udp" },
+ { "tacacs-ds", { NULL }, 65, "tcp" },
+ { "tacacs-ds", { NULL }, 65, "udp" },
+ { "sql*net", { NULL }, 66, "tcp" },
+ { "sql*net", { NULL }, 66, "udp" },
+ { "bootps", { NULL }, 67, "tcp" },
+ { "bootps", { NULL }, 67, "udp" },
+ { "bootpc", { NULL }, 68, "tcp" },
+ { "bootpc", { NULL }, 68, "udp" },
+ { "tftp", { NULL }, 69, "tcp" },
+ { "tftp", { NULL }, 69, "udp" },
+ { "gopher", { NULL }, 70, "tcp" },
+ { "gopher", { NULL }, 70, "udp" },
+ { "netrjs-1", { NULL }, 71, "tcp" },
+ { "netrjs-1", { NULL }, 71, "udp" },
+ { "netrjs-2", { NULL }, 72, "tcp" },
+ { "netrjs-2", { NULL }, 72, "udp" },
+ { "netrjs-3", { NULL }, 73, "tcp" },
+ { "netrjs-3", { NULL }, 73, "udp" },
+ { "netrjs-4", { NULL }, 74, "tcp" },
+ { "netrjs-4", { NULL }, 74, "udp" },
+ { "deos", { NULL }, 76, "tcp" },
+ { "deos", { NULL }, 76, "udp" },
+ { "vettcp", { NULL }, 78, "tcp" },
+ { "vettcp", { NULL }, 78, "udp" },
+ { "finger", { NULL }, 79, "tcp" },
+ { "finger", { NULL }, 79, "udp" },
+ { "http", { NULL }, 80, "tcp" },
+ { "http", { NULL }, 80, "udp" },
+ { "www", { NULL }, 80, "tcp" },
+ { "www", { NULL }, 80, "udp" },
+ { "www-http", { NULL }, 80, "tcp" },
+ { "www-http", { NULL }, 80, "udp" },
+ { "http", { NULL }, 80, "sctp"},
+ { "xfer", { NULL }, 82, "tcp" },
+ { "xfer", { NULL }, 82, "udp" },
+ { "mit-ml-dev", { NULL }, 83, "tcp" },
+ { "mit-ml-dev", { NULL }, 83, "udp" },
+ { "ctf", { NULL }, 84, "tcp" },
+ { "ctf", { NULL }, 84, "udp" },
+ { "mit-ml-dev", { NULL }, 85, "tcp" },
+ { "mit-ml-dev", { NULL }, 85, "udp" },
+ { "mfcobol", { NULL }, 86, "tcp" },
+ { "mfcobol", { NULL }, 86, "udp" },
+ { "kerberos", { NULL }, 88, "tcp" },
+ { "kerberos", { NULL }, 88, "udp" },
+ { "su-mit-tg", { NULL }, 89, "tcp" },
+ { "su-mit-tg", { NULL }, 89, "udp" },
+ { "dnsix", { NULL }, 90, "tcp" },
+ { "dnsix", { NULL }, 90, "udp" },
+ { "mit-dov", { NULL }, 91, "tcp" },
+ { "mit-dov", { NULL }, 91, "udp" },
+ { "npp", { NULL }, 92, "tcp" },
+ { "npp", { NULL }, 92, "udp" },
+ { "dcp", { NULL }, 93, "tcp" },
+ { "dcp", { NULL }, 93, "udp" },
+ { "objcall", { NULL }, 94, "tcp" },
+ { "objcall", { NULL }, 94, "udp" },
+ { "supdup", { NULL }, 95, "tcp" },
+ { "supdup", { NULL }, 95, "udp" },
+ { "dixie", { NULL }, 96, "tcp" },
+ { "dixie", { NULL }, 96, "udp" },
+ { "swift-rvf", { NULL }, 97, "tcp" },
+ { "swift-rvf", { NULL }, 97, "udp" },
+ { "tacnews", { NULL }, 98, "tcp" },
+ { "tacnews", { NULL }, 98, "udp" },
+ { "metagram", { NULL }, 99, "tcp" },
+ { "metagram", { NULL }, 99, "udp" },
+ { "newacct", { NULL }, 100, "tcp" },
+ { "hostname", { NULL }, 101, "tcp" },
+ { "hostname", { NULL }, 101, "udp" },
+ { "iso-tsap", { NULL }, 102, "tcp" },
+ { "iso-tsap", { NULL }, 102, "udp" },
+ { "gppitnp", { NULL }, 103, "tcp" },
+ { "gppitnp", { NULL }, 103, "udp" },
+ { "acr-nema", { NULL }, 104, "tcp" },
+ { "acr-nema", { NULL }, 104, "udp" },
+ { "cso", { NULL }, 105, "tcp" },
+ { "cso", { NULL }, 105, "udp" },
+ { "csnet-ns", { NULL }, 105, "tcp" },
+ { "csnet-ns", { NULL }, 105, "udp" },
+ { "3com-tsmux", { NULL }, 106, "tcp" },
+ { "3com-tsmux", { NULL }, 106, "udp" },
+ { "rtelnet", { NULL }, 107, "tcp" },
+ { "rtelnet", { NULL }, 107, "udp" },
+ { "snagas", { NULL }, 108, "tcp" },
+ { "snagas", { NULL }, 108, "udp" },
+ { "pop2", { NULL }, 109, "tcp" },
+ { "pop2", { NULL }, 109, "udp" },
+ { "pop3", { NULL }, 110, "tcp" },
+ { "pop3", { NULL }, 110, "udp" },
+ { "sunrpc", { NULL }, 111, "tcp" },
+ { "sunrpc", { NULL }, 111, "udp" },
+ { "mcidas", { NULL }, 112, "tcp" },
+ { "mcidas", { NULL }, 112, "udp" },
+ { "ident", { NULL }, 113, "tcp" },
+ { "auth", { NULL }, 113, "tcp" },
+ { "auth", { NULL }, 113, "udp" },
+ { "sftp", { NULL }, 115, "tcp" },
+ { "sftp", { NULL }, 115, "udp" },
+ { "ansanotify", { NULL }, 116, "tcp" },
+ { "ansanotify", { NULL }, 116, "udp" },
+ { "uucp-path", { NULL }, 117, "tcp" },
+ { "uucp-path", { NULL }, 117, "udp" },
+ { "sqlserv", { NULL }, 118, "tcp" },
+ { "sqlserv", { NULL }, 118, "udp" },
+ { "nntp", { NULL }, 119, "tcp" },
+ { "nntp", { NULL }, 119, "udp" },
+ { "cfdptkt", { NULL }, 120, "tcp" },
+ { "cfdptkt", { NULL }, 120, "udp" },
+ { "erpc", { NULL }, 121, "tcp" },
+ { "erpc", { NULL }, 121, "udp" },
+ { "smakynet", { NULL }, 122, "tcp" },
+ { "smakynet", { NULL }, 122, "udp" },
+ { "ntp", { NULL }, 123, "tcp" },
+ { "ntp", { NULL }, 123, "udp" },
+ { "ansatrader", { NULL }, 124, "tcp" },
+ { "ansatrader", { NULL }, 124, "udp" },
+ { "locus-map", { NULL }, 125, "tcp" },
+ { "locus-map", { NULL }, 125, "udp" },
+ { "nxedit", { NULL }, 126, "tcp" },
+ { "nxedit", { NULL }, 126, "udp" },
+ { "locus-con", { NULL }, 127, "tcp" },
+ { "locus-con", { NULL }, 127, "udp" },
+ { "gss-xlicen", { NULL }, 128, "tcp" },
+ { "gss-xlicen", { NULL }, 128, "udp" },
+ { "pwdgen", { NULL }, 129, "tcp" },
+ { "pwdgen", { NULL }, 129, "udp" },
+ { "cisco-fna", { NULL }, 130, "tcp" },
+ { "cisco-fna", { NULL }, 130, "udp" },
+ { "cisco-tna", { NULL }, 131, "tcp" },
+ { "cisco-tna", { NULL }, 131, "udp" },
+ { "cisco-sys", { NULL }, 132, "tcp" },
+ { "cisco-sys", { NULL }, 132, "udp" },
+ { "statsrv", { NULL }, 133, "tcp" },
+ { "statsrv", { NULL }, 133, "udp" },
+ { "ingres-net", { NULL }, 134, "tcp" },
+ { "ingres-net", { NULL }, 134, "udp" },
+ { "epmap", { NULL }, 135, "tcp" },
+ { "epmap", { NULL }, 135, "udp" },
+ { "profile", { NULL }, 136, "tcp" },
+ { "profile", { NULL }, 136, "udp" },
+ { "netbios-ns", { NULL }, 137, "tcp" },
+ { "netbios-ns", { NULL }, 137, "udp" },
+ { "netbios-dgm", { NULL }, 138, "tcp" },
+ { "netbios-dgm", { NULL }, 138, "udp" },
+ { "netbios-ssn", { NULL }, 139, "tcp" },
+ { "netbios-ssn", { NULL }, 139, "udp" },
+ { "emfis-data", { NULL }, 140, "tcp" },
+ { "emfis-data", { NULL }, 140, "udp" },
+ { "emfis-cntl", { NULL }, 141, "tcp" },
+ { "emfis-cntl", { NULL }, 141, "udp" },
+ { "bl-idm", { NULL }, 142, "tcp" },
+ { "bl-idm", { NULL }, 142, "udp" },
+ { "imap", { NULL }, 143, "tcp" },
+ { "imap", { NULL }, 143, "udp" },
+ { "uma", { NULL }, 144, "tcp" },
+ { "uma", { NULL }, 144, "udp" },
+ { "uaac", { NULL }, 145, "tcp" },
+ { "uaac", { NULL }, 145, "udp" },
+ { "iso-tp0", { NULL }, 146, "tcp" },
+ { "iso-tp0", { NULL }, 146, "udp" },
+ { "iso-ip", { NULL }, 147, "tcp" },
+ { "iso-ip", { NULL }, 147, "udp" },
+ { "jargon", { NULL }, 148, "tcp" },
+ { "jargon", { NULL }, 148, "udp" },
+ { "aed-512", { NULL }, 149, "tcp" },
+ { "aed-512", { NULL }, 149, "udp" },
+ { "sql-net", { NULL }, 150, "tcp" },
+ { "sql-net", { NULL }, 150, "udp" },
+ { "hems", { NULL }, 151, "tcp" },
+ { "hems", { NULL }, 151, "udp" },
+ { "bftp", { NULL }, 152, "tcp" },
+ { "bftp", { NULL }, 152, "udp" },
+ { "sgmp", { NULL }, 153, "tcp" },
+ { "sgmp", { NULL }, 153, "udp" },
+ { "netsc-prod", { NULL }, 154, "tcp" },
+ { "netsc-prod", { NULL }, 154, "udp" },
+ { "netsc-dev", { NULL }, 155, "tcp" },
+ { "netsc-dev", { NULL }, 155, "udp" },
+ { "sqlsrv", { NULL }, 156, "tcp" },
+ { "sqlsrv", { NULL }, 156, "udp" },
+ { "knet-cmp", { NULL }, 157, "tcp" },
+ { "knet-cmp", { NULL }, 157, "udp" },
+ { "pcmail-srv", { NULL }, 158, "tcp" },
+ { "pcmail-srv", { NULL }, 158, "udp" },
+ { "nss-routing", { NULL }, 159, "tcp" },
+ { "nss-routing", { NULL }, 159, "udp" },
+ { "sgmp-traps", { NULL }, 160, "tcp" },
+ { "sgmp-traps", { NULL }, 160, "udp" },
+ { "snmp", { NULL }, 161, "tcp" },
+ { "snmp", { NULL }, 161, "udp" },
+ { "snmptrap", { NULL }, 162, "tcp" },
+ { "snmptrap", { NULL }, 162, "udp" },
+ { "cmip-man", { NULL }, 163, "tcp" },
+ { "cmip-man", { NULL }, 163, "udp" },
+ { "cmip-agent", { NULL }, 164, "tcp" },
+ { "cmip-agent", { NULL }, 164, "udp" },
+ { "xns-courier", { NULL }, 165, "tcp" },
+ { "xns-courier", { NULL }, 165, "udp" },
+ { "s-net", { NULL }, 166, "tcp" },
+ { "s-net", { NULL }, 166, "udp" },
+ { "namp", { NULL }, 167, "tcp" },
+ { "namp", { NULL }, 167, "udp" },
+ { "rsvd", { NULL }, 168, "tcp" },
+ { "rsvd", { NULL }, 168, "udp" },
+ { "send", { NULL }, 169, "tcp" },
+ { "send", { NULL }, 169, "udp" },
+ { "print-srv", { NULL }, 170, "tcp" },
+ { "print-srv", { NULL }, 170, "udp" },
+ { "multiplex", { NULL }, 171, "tcp" },
+ { "multiplex", { NULL }, 171, "udp" },
+ { "cl/1", { NULL }, 172, "tcp" },
+ { "cl/1", { NULL }, 172, "udp" },
+ { "xyplex-mux", { NULL }, 173, "tcp" },
+ { "xyplex-mux", { NULL }, 173, "udp" },
+ { "mailq", { NULL }, 174, "tcp" },
+ { "mailq", { NULL }, 174, "udp" },
+ { "vmnet", { NULL }, 175, "tcp" },
+ { "vmnet", { NULL }, 175, "udp" },
+ { "genrad-mux", { NULL }, 176, "tcp" },
+ { "genrad-mux", { NULL }, 176, "udp" },
+ { "xdmcp", { NULL }, 177, "tcp" },
+ { "xdmcp", { NULL }, 177, "udp" },
+ { "nextstep", { NULL }, 178, "tcp" },
+ { "nextstep", { NULL }, 178, "udp" },
+ { "bgp", { NULL }, 179, "tcp" },
+ { "bgp", { NULL }, 179, "udp" },
+ { "bgp", { NULL }, 179, "sctp"},
+ { "ris", { NULL }, 180, "tcp" },
+ { "ris", { NULL }, 180, "udp" },
+ { "unify", { NULL }, 181, "tcp" },
+ { "unify", { NULL }, 181, "udp" },
+ { "audit", { NULL }, 182, "tcp" },
+ { "audit", { NULL }, 182, "udp" },
+ { "ocbinder", { NULL }, 183, "tcp" },
+ { "ocbinder", { NULL }, 183, "udp" },
+ { "ocserver", { NULL }, 184, "tcp" },
+ { "ocserver", { NULL }, 184, "udp" },
+ { "remote-kis", { NULL }, 185, "tcp" },
+ { "remote-kis", { NULL }, 185, "udp" },
+ { "kis", { NULL }, 186, "tcp" },
+ { "kis", { NULL }, 186, "udp" },
+ { "aci", { NULL }, 187, "tcp" },
+ { "aci", { NULL }, 187, "udp" },
+ { "mumps", { NULL }, 188, "tcp" },
+ { "mumps", { NULL }, 188, "udp" },
+ { "qft", { NULL }, 189, "tcp" },
+ { "qft", { NULL }, 189, "udp" },
+ { "gacp", { NULL }, 190, "tcp" },
+ { "gacp", { NULL }, 190, "udp" },
+ { "prospero", { NULL }, 191, "tcp" },
+ { "prospero", { NULL }, 191, "udp" },
+ { "osu-nms", { NULL }, 192, "tcp" },
+ { "osu-nms", { NULL }, 192, "udp" },
+ { "srmp", { NULL }, 193, "tcp" },
+ { "srmp", { NULL }, 193, "udp" },
+ { "irc", { NULL }, 194, "tcp" },
+ { "irc", { NULL }, 194, "udp" },
+ { "dn6-nlm-aud", { NULL }, 195, "tcp" },
+ { "dn6-nlm-aud", { NULL }, 195, "udp" },
+ { "dn6-smm-red", { NULL }, 196, "tcp" },
+ { "dn6-smm-red", { NULL }, 196, "udp" },
+ { "dls", { NULL }, 197, "tcp" },
+ { "dls", { NULL }, 197, "udp" },
+ { "dls-mon", { NULL }, 198, "tcp" },
+ { "dls-mon", { NULL }, 198, "udp" },
+ { "smux", { NULL }, 199, "tcp" },
+ { "smux", { NULL }, 199, "udp" },
+ { "src", { NULL }, 200, "tcp" },
+ { "src", { NULL }, 200, "udp" },
+ { "at-rtmp", { NULL }, 201, "tcp" },
+ { "at-rtmp", { NULL }, 201, "udp" },
+ { "at-nbp", { NULL }, 202, "tcp" },
+ { "at-nbp", { NULL }, 202, "udp" },
+ { "at-3", { NULL }, 203, "tcp" },
+ { "at-3", { NULL }, 203, "udp" },
+ { "at-echo", { NULL }, 204, "tcp" },
+ { "at-echo", { NULL }, 204, "udp" },
+ { "at-5", { NULL }, 205, "tcp" },
+ { "at-5", { NULL }, 205, "udp" },
+ { "at-zis", { NULL }, 206, "tcp" },
+ { "at-zis", { NULL }, 206, "udp" },
+ { "at-7", { NULL }, 207, "tcp" },
+ { "at-7", { NULL }, 207, "udp" },
+ { "at-8", { NULL }, 208, "tcp" },
+ { "at-8", { NULL }, 208, "udp" },
+ { "qmtp", { NULL }, 209, "tcp" },
+ { "qmtp", { NULL }, 209, "udp" },
+ { "z39.50", { NULL }, 210, "tcp" },
+ { "z39.50", { NULL }, 210, "udp" },
+ { "914c/g", { NULL }, 211, "tcp" },
+ { "914c/g", { NULL }, 211, "udp" },
+ { "anet", { NULL }, 212, "tcp" },
+ { "anet", { NULL }, 212, "udp" },
+ { "ipx", { NULL }, 213, "tcp" },
+ { "ipx", { NULL }, 213, "udp" },
+ { "vmpwscs", { NULL }, 214, "tcp" },
+ { "vmpwscs", { NULL }, 214, "udp" },
+ { "softpc", { NULL }, 215, "tcp" },
+ { "softpc", { NULL }, 215, "udp" },
+ { "CAIlic", { NULL }, 216, "tcp" },
+ { "CAIlic", { NULL }, 216, "udp" },
+ { "dbase", { NULL }, 217, "tcp" },
+ { "dbase", { NULL }, 217, "udp" },
+ { "mpp", { NULL }, 218, "tcp" },
+ { "mpp", { NULL }, 218, "udp" },
+ { "uarps", { NULL }, 219, "tcp" },
+ { "uarps", { NULL }, 219, "udp" },
+ { "imap3", { NULL }, 220, "tcp" },
+ { "imap3", { NULL }, 220, "udp" },
+ { "fln-spx", { NULL }, 221, "tcp" },
+ { "fln-spx", { NULL }, 221, "udp" },
+ { "rsh-spx", { NULL }, 222, "tcp" },
+ { "rsh-spx", { NULL }, 222, "udp" },
+ { "cdc", { NULL }, 223, "tcp" },
+ { "cdc", { NULL }, 223, "udp" },
+ { "masqdialer", { NULL }, 224, "tcp" },
+ { "masqdialer", { NULL }, 224, "udp" },
+ { "direct", { NULL }, 242, "tcp" },
+ { "direct", { NULL }, 242, "udp" },
+ { "sur-meas", { NULL }, 243, "tcp" },
+ { "sur-meas", { NULL }, 243, "udp" },
+ { "inbusiness", { NULL }, 244, "tcp" },
+ { "inbusiness", { NULL }, 244, "udp" },
+ { "link", { NULL }, 245, "tcp" },
+ { "link", { NULL }, 245, "udp" },
+ { "dsp3270", { NULL }, 246, "tcp" },
+ { "dsp3270", { NULL }, 246, "udp" },
+ { "subntbcst_tftp", { NULL }, 247, "tcp" },
+ { "subntbcst_tftp", { NULL }, 247, "udp" },
+ { "bhfhs", { NULL }, 248, "tcp" },
+ { "bhfhs", { NULL }, 248, "udp" },
+ { "rap", { NULL }, 256, "tcp" },
+ { "rap", { NULL }, 256, "udp" },
+ { "set", { NULL }, 257, "tcp" },
+ { "set", { NULL }, 257, "udp" },
+ { "esro-gen", { NULL }, 259, "tcp" },
+ { "esro-gen", { NULL }, 259, "udp" },
+ { "openport", { NULL }, 260, "tcp" },
+ { "openport", { NULL }, 260, "udp" },
+ { "nsiiops", { NULL }, 261, "tcp" },
+ { "nsiiops", { NULL }, 261, "udp" },
+ { "arcisdms", { NULL }, 262, "tcp" },
+ { "arcisdms", { NULL }, 262, "udp" },
+ { "hdap", { NULL }, 263, "tcp" },
+ { "hdap", { NULL }, 263, "udp" },
+ { "bgmp", { NULL }, 264, "tcp" },
+ { "bgmp", { NULL }, 264, "udp" },
+ { "x-bone-ctl", { NULL }, 265, "tcp" },
+ { "x-bone-ctl", { NULL }, 265, "udp" },
+ { "sst", { NULL }, 266, "tcp" },
+ { "sst", { NULL }, 266, "udp" },
+ { "td-service", { NULL }, 267, "tcp" },
+ { "td-service", { NULL }, 267, "udp" },
+ { "td-replica", { NULL }, 268, "tcp" },
+ { "td-replica", { NULL }, 268, "udp" },
+ { "manet", { NULL }, 269, "tcp" },
+ { "manet", { NULL }, 269, "udp" },
+ { "gist", { NULL }, 270, "udp" },
+ { "http-mgmt", { NULL }, 280, "tcp" },
+ { "http-mgmt", { NULL }, 280, "udp" },
+ { "personal-link", { NULL }, 281, "tcp" },
+ { "personal-link", { NULL }, 281, "udp" },
+ { "cableport-ax", { NULL }, 282, "tcp" },
+ { "cableport-ax", { NULL }, 282, "udp" },
+ { "rescap", { NULL }, 283, "tcp" },
+ { "rescap", { NULL }, 283, "udp" },
+ { "corerjd", { NULL }, 284, "tcp" },
+ { "corerjd", { NULL }, 284, "udp" },
+ { "fxp", { NULL }, 286, "tcp" },
+ { "fxp", { NULL }, 286, "udp" },
+ { "k-block", { NULL }, 287, "tcp" },
+ { "k-block", { NULL }, 287, "udp" },
+ { "novastorbakcup", { NULL }, 308, "tcp" },
+ { "novastorbakcup", { NULL }, 308, "udp" },
+ { "entrusttime", { NULL }, 309, "tcp" },
+ { "entrusttime", { NULL }, 309, "udp" },
+ { "bhmds", { NULL }, 310, "tcp" },
+ { "bhmds", { NULL }, 310, "udp" },
+ { "asip-webadmin", { NULL }, 311, "tcp" },
+ { "asip-webadmin", { NULL }, 311, "udp" },
+ { "vslmp", { NULL }, 312, "tcp" },
+ { "vslmp", { NULL }, 312, "udp" },
+ { "magenta-logic", { NULL }, 313, "tcp" },
+ { "magenta-logic", { NULL }, 313, "udp" },
+ { "opalis-robot", { NULL }, 314, "tcp" },
+ { "opalis-robot", { NULL }, 314, "udp" },
+ { "dpsi", { NULL }, 315, "tcp" },
+ { "dpsi", { NULL }, 315, "udp" },
+ { "decauth", { NULL }, 316, "tcp" },
+ { "decauth", { NULL }, 316, "udp" },
+ { "zannet", { NULL }, 317, "tcp" },
+ { "zannet", { NULL }, 317, "udp" },
+ { "pkix-timestamp", { NULL }, 318, "tcp" },
+ { "pkix-timestamp", { NULL }, 318, "udp" },
+ { "ptp-event", { NULL }, 319, "tcp" },
+ { "ptp-event", { NULL }, 319, "udp" },
+ { "ptp-general", { NULL }, 320, "tcp" },
+ { "ptp-general", { NULL }, 320, "udp" },
+ { "pip", { NULL }, 321, "tcp" },
+ { "pip", { NULL }, 321, "udp" },
+ { "rtsps", { NULL }, 322, "tcp" },
+ { "rtsps", { NULL }, 322, "udp" },
+ { "texar", { NULL }, 333, "tcp" },
+ { "texar", { NULL }, 333, "udp" },
+ { "pdap", { NULL }, 344, "tcp" },
+ { "pdap", { NULL }, 344, "udp" },
+ { "pawserv", { NULL }, 345, "tcp" },
+ { "pawserv", { NULL }, 345, "udp" },
+ { "zserv", { NULL }, 346, "tcp" },
+ { "zserv", { NULL }, 346, "udp" },
+ { "fatserv", { NULL }, 347, "tcp" },
+ { "fatserv", { NULL }, 347, "udp" },
+ { "csi-sgwp", { NULL }, 348, "tcp" },
+ { "csi-sgwp", { NULL }, 348, "udp" },
+ { "mftp", { NULL }, 349, "tcp" },
+ { "mftp", { NULL }, 349, "udp" },
+ { "matip-type-a", { NULL }, 350, "tcp" },
+ { "matip-type-a", { NULL }, 350, "udp" },
+ { "matip-type-b", { NULL }, 351, "tcp" },
+ { "matip-type-b", { NULL }, 351, "udp" },
+ { "bhoetty", { NULL }, 351, "tcp" },
+ { "bhoetty", { NULL }, 351, "udp" },
+ { "dtag-ste-sb", { NULL }, 352, "tcp" },
+ { "dtag-ste-sb", { NULL }, 352, "udp" },
+ { "bhoedap4", { NULL }, 352, "tcp" },
+ { "bhoedap4", { NULL }, 352, "udp" },
+ { "ndsauth", { NULL }, 353, "tcp" },
+ { "ndsauth", { NULL }, 353, "udp" },
+ { "bh611", { NULL }, 354, "tcp" },
+ { "bh611", { NULL }, 354, "udp" },
+ { "datex-asn", { NULL }, 355, "tcp" },
+ { "datex-asn", { NULL }, 355, "udp" },
+ { "cloanto-net-1", { NULL }, 356, "tcp" },
+ { "cloanto-net-1", { NULL }, 356, "udp" },
+ { "bhevent", { NULL }, 357, "tcp" },
+ { "bhevent", { NULL }, 357, "udp" },
+ { "shrinkwrap", { NULL }, 358, "tcp" },
+ { "shrinkwrap", { NULL }, 358, "udp" },
+ { "nsrmp", { NULL }, 359, "tcp" },
+ { "nsrmp", { NULL }, 359, "udp" },
+ { "scoi2odialog", { NULL }, 360, "tcp" },
+ { "scoi2odialog", { NULL }, 360, "udp" },
+ { "semantix", { NULL }, 361, "tcp" },
+ { "semantix", { NULL }, 361, "udp" },
+ { "srssend", { NULL }, 362, "tcp" },
+ { "srssend", { NULL }, 362, "udp" },
+ { "rsvp_tunnel", { NULL }, 363, "tcp" },
+ { "rsvp_tunnel", { NULL }, 363, "udp" },
+ { "aurora-cmgr", { NULL }, 364, "tcp" },
+ { "aurora-cmgr", { NULL }, 364, "udp" },
+ { "dtk", { NULL }, 365, "tcp" },
+ { "dtk", { NULL }, 365, "udp" },
+ { "odmr", { NULL }, 366, "tcp" },
+ { "odmr", { NULL }, 366, "udp" },
+ { "mortgageware", { NULL }, 367, "tcp" },
+ { "mortgageware", { NULL }, 367, "udp" },
+ { "qbikgdp", { NULL }, 368, "tcp" },
+ { "qbikgdp", { NULL }, 368, "udp" },
+ { "rpc2portmap", { NULL }, 369, "tcp" },
+ { "rpc2portmap", { NULL }, 369, "udp" },
+ { "codaauth2", { NULL }, 370, "tcp" },
+ { "codaauth2", { NULL }, 370, "udp" },
+ { "clearcase", { NULL }, 371, "tcp" },
+ { "clearcase", { NULL }, 371, "udp" },
+ { "ulistproc", { NULL }, 372, "tcp" },
+ { "ulistproc", { NULL }, 372, "udp" },
+ { "legent-1", { NULL }, 373, "tcp" },
+ { "legent-1", { NULL }, 373, "udp" },
+ { "legent-2", { NULL }, 374, "tcp" },
+ { "legent-2", { NULL }, 374, "udp" },
+ { "hassle", { NULL }, 375, "tcp" },
+ { "hassle", { NULL }, 375, "udp" },
+ { "nip", { NULL }, 376, "tcp" },
+ { "nip", { NULL }, 376, "udp" },
+ { "tnETOS", { NULL }, 377, "tcp" },
+ { "tnETOS", { NULL }, 377, "udp" },
+ { "dsETOS", { NULL }, 378, "tcp" },
+ { "dsETOS", { NULL }, 378, "udp" },
+ { "is99c", { NULL }, 379, "tcp" },
+ { "is99c", { NULL }, 379, "udp" },
+ { "is99s", { NULL }, 380, "tcp" },
+ { "is99s", { NULL }, 380, "udp" },
+ { "hp-collector", { NULL }, 381, "tcp" },
+ { "hp-collector", { NULL }, 381, "udp" },
+ { "hp-managed-node", { NULL }, 382, "tcp" },
+ { "hp-managed-node", { NULL }, 382, "udp" },
+ { "hp-alarm-mgr", { NULL }, 383, "tcp" },
+ { "hp-alarm-mgr", { NULL }, 383, "udp" },
+ { "arns", { NULL }, 384, "tcp" },
+ { "arns", { NULL }, 384, "udp" },
+ { "ibm-app", { NULL }, 385, "tcp" },
+ { "ibm-app", { NULL }, 385, "udp" },
+ { "asa", { NULL }, 386, "tcp" },
+ { "asa", { NULL }, 386, "udp" },
+ { "aurp", { NULL }, 387, "tcp" },
+ { "aurp", { NULL }, 387, "udp" },
+ { "unidata-ldm", { NULL }, 388, "tcp" },
+ { "unidata-ldm", { NULL }, 388, "udp" },
+ { "ldap", { NULL }, 389, "tcp" },
+ { "ldap", { NULL }, 389, "udp" },
+ { "uis", { NULL }, 390, "tcp" },
+ { "uis", { NULL }, 390, "udp" },
+ { "synotics-relay", { NULL }, 391, "tcp" },
+ { "synotics-relay", { NULL }, 391, "udp" },
+ { "synotics-broker", { NULL }, 392, "tcp" },
+ { "synotics-broker", { NULL }, 392, "udp" },
+ { "meta5", { NULL }, 393, "tcp" },
+ { "meta5", { NULL }, 393, "udp" },
+ { "embl-ndt", { NULL }, 394, "tcp" },
+ { "embl-ndt", { NULL }, 394, "udp" },
+ { "netcp", { NULL }, 395, "tcp" },
+ { "netcp", { NULL }, 395, "udp" },
+ { "netware-ip", { NULL }, 396, "tcp" },
+ { "netware-ip", { NULL }, 396, "udp" },
+ { "mptn", { NULL }, 397, "tcp" },
+ { "mptn", { NULL }, 397, "udp" },
+ { "kryptolan", { NULL }, 398, "tcp" },
+ { "kryptolan", { NULL }, 398, "udp" },
+ { "iso-tsap-c2", { NULL }, 399, "tcp" },
+ { "iso-tsap-c2", { NULL }, 399, "udp" },
+ { "osb-sd", { NULL }, 400, "tcp" },
+ { "osb-sd", { NULL }, 400, "udp" },
+ { "ups", { NULL }, 401, "tcp" },
+ { "ups", { NULL }, 401, "udp" },
+ { "genie", { NULL }, 402, "tcp" },
+ { "genie", { NULL }, 402, "udp" },
+ { "decap", { NULL }, 403, "tcp" },
+ { "decap", { NULL }, 403, "udp" },
+ { "nced", { NULL }, 404, "tcp" },
+ { "nced", { NULL }, 404, "udp" },
+ { "ncld", { NULL }, 405, "tcp" },
+ { "ncld", { NULL }, 405, "udp" },
+ { "imsp", { NULL }, 406, "tcp" },
+ { "imsp", { NULL }, 406, "udp" },
+ { "timbuktu", { NULL }, 407, "tcp" },
+ { "timbuktu", { NULL }, 407, "udp" },
+ { "prm-sm", { NULL }, 408, "tcp" },
+ { "prm-sm", { NULL }, 408, "udp" },
+ { "prm-nm", { NULL }, 409, "tcp" },
+ { "prm-nm", { NULL }, 409, "udp" },
+ { "decladebug", { NULL }, 410, "tcp" },
+ { "decladebug", { NULL }, 410, "udp" },
+ { "rmt", { NULL }, 411, "tcp" },
+ { "rmt", { NULL }, 411, "udp" },
+ { "synoptics-trap", { NULL }, 412, "tcp" },
+ { "synoptics-trap", { NULL }, 412, "udp" },
+ { "smsp", { NULL }, 413, "tcp" },
+ { "smsp", { NULL }, 413, "udp" },
+ { "infoseek", { NULL }, 414, "tcp" },
+ { "infoseek", { NULL }, 414, "udp" },
+ { "bnet", { NULL }, 415, "tcp" },
+ { "bnet", { NULL }, 415, "udp" },
+ { "silverplatter", { NULL }, 416, "tcp" },
+ { "silverplatter", { NULL }, 416, "udp" },
+ { "onmux", { NULL }, 417, "tcp" },
+ { "onmux", { NULL }, 417, "udp" },
+ { "hyper-g", { NULL }, 418, "tcp" },
+ { "hyper-g", { NULL }, 418, "udp" },
+ { "ariel1", { NULL }, 419, "tcp" },
+ { "ariel1", { NULL }, 419, "udp" },
+ { "smpte", { NULL }, 420, "tcp" },
+ { "smpte", { NULL }, 420, "udp" },
+ { "ariel2", { NULL }, 421, "tcp" },
+ { "ariel2", { NULL }, 421, "udp" },
+ { "ariel3", { NULL }, 422, "tcp" },
+ { "ariel3", { NULL }, 422, "udp" },
+ { "opc-job-start", { NULL }, 423, "tcp" },
+ { "opc-job-start", { NULL }, 423, "udp" },
+ { "opc-job-track", { NULL }, 424, "tcp" },
+ { "opc-job-track", { NULL }, 424, "udp" },
+ { "icad-el", { NULL }, 425, "tcp" },
+ { "icad-el", { NULL }, 425, "udp" },
+ { "smartsdp", { NULL }, 426, "tcp" },
+ { "smartsdp", { NULL }, 426, "udp" },
+ { "svrloc", { NULL }, 427, "tcp" },
+ { "svrloc", { NULL }, 427, "udp" },
+ { "ocs_cmu", { NULL }, 428, "tcp" },
+ { "ocs_cmu", { NULL }, 428, "udp" },
+ { "ocs_amu", { NULL }, 429, "tcp" },
+ { "ocs_amu", { NULL }, 429, "udp" },
+ { "utmpsd", { NULL }, 430, "tcp" },
+ { "utmpsd", { NULL }, 430, "udp" },
+ { "utmpcd", { NULL }, 431, "tcp" },
+ { "utmpcd", { NULL }, 431, "udp" },
+ { "iasd", { NULL }, 432, "tcp" },
+ { "iasd", { NULL }, 432, "udp" },
+ { "nnsp", { NULL }, 433, "tcp" },
+ { "nnsp", { NULL }, 433, "udp" },
+ { "mobileip-agent", { NULL }, 434, "tcp" },
+ { "mobileip-agent", { NULL }, 434, "udp" },
+ { "mobilip-mn", { NULL }, 435, "tcp" },
+ { "mobilip-mn", { NULL }, 435, "udp" },
+ { "dna-cml", { NULL }, 436, "tcp" },
+ { "dna-cml", { NULL }, 436, "udp" },
+ { "comscm", { NULL }, 437, "tcp" },
+ { "comscm", { NULL }, 437, "udp" },
+ { "dsfgw", { NULL }, 438, "tcp" },
+ { "dsfgw", { NULL }, 438, "udp" },
+ { "dasp", { NULL }, 439, "tcp" },
+ { "dasp", { NULL }, 439, "udp" },
+ { "sgcp", { NULL }, 440, "tcp" },
+ { "sgcp", { NULL }, 440, "udp" },
+ { "decvms-sysmgt", { NULL }, 441, "tcp" },
+ { "decvms-sysmgt", { NULL }, 441, "udp" },
+ { "cvc_hostd", { NULL }, 442, "tcp" },
+ { "cvc_hostd", { NULL }, 442, "udp" },
+ { "https", { NULL }, 443, "tcp" },
+ { "https", { NULL }, 443, "udp" },
+ { "https", { NULL }, 443, "sctp"},
+ { "snpp", { NULL }, 444, "tcp" },
+ { "snpp", { NULL }, 444, "udp" },
+ { "microsoft-ds", { NULL }, 445, "tcp" },
+ { "microsoft-ds", { NULL }, 445, "udp" },
+ { "ddm-rdb", { NULL }, 446, "tcp" },
+ { "ddm-rdb", { NULL }, 446, "udp" },
+ { "ddm-dfm", { NULL }, 447, "tcp" },
+ { "ddm-dfm", { NULL }, 447, "udp" },
+ { "ddm-ssl", { NULL }, 448, "tcp" },
+ { "ddm-ssl", { NULL }, 448, "udp" },
+ { "as-servermap", { NULL }, 449, "tcp" },
+ { "as-servermap", { NULL }, 449, "udp" },
+ { "tserver", { NULL }, 450, "tcp" },
+ { "tserver", { NULL }, 450, "udp" },
+ { "sfs-smp-net", { NULL }, 451, "tcp" },
+ { "sfs-smp-net", { NULL }, 451, "udp" },
+ { "sfs-config", { NULL }, 452, "tcp" },
+ { "sfs-config", { NULL }, 452, "udp" },
+ { "creativeserver", { NULL }, 453, "tcp" },
+ { "creativeserver", { NULL }, 453, "udp" },
+ { "contentserver", { NULL }, 454, "tcp" },
+ { "contentserver", { NULL }, 454, "udp" },
+ { "creativepartnr", { NULL }, 455, "tcp" },
+ { "creativepartnr", { NULL }, 455, "udp" },
+ { "macon-tcp", { NULL }, 456, "tcp" },
+ { "macon-udp", { NULL }, 456, "udp" },
+ { "scohelp", { NULL }, 457, "tcp" },
+ { "scohelp", { NULL }, 457, "udp" },
+ { "appleqtc", { NULL }, 458, "tcp" },
+ { "appleqtc", { NULL }, 458, "udp" },
+ { "ampr-rcmd", { NULL }, 459, "tcp" },
+ { "ampr-rcmd", { NULL }, 459, "udp" },
+ { "skronk", { NULL }, 460, "tcp" },
+ { "skronk", { NULL }, 460, "udp" },
+ { "datasurfsrv", { NULL }, 461, "tcp" },
+ { "datasurfsrv", { NULL }, 461, "udp" },
+ { "datasurfsrvsec", { NULL }, 462, "tcp" },
+ { "datasurfsrvsec", { NULL }, 462, "udp" },
+ { "alpes", { NULL }, 463, "tcp" },
+ { "alpes", { NULL }, 463, "udp" },
+ { "kpasswd", { NULL }, 464, "tcp" },
+ { "kpasswd", { NULL }, 464, "udp" },
+ { "urd", { NULL }, 465, "tcp" },
+ { "igmpv3lite", { NULL }, 465, "udp" },
+ { "digital-vrc", { NULL }, 466, "tcp" },
+ { "digital-vrc", { NULL }, 466, "udp" },
+ { "mylex-mapd", { NULL }, 467, "tcp" },
+ { "mylex-mapd", { NULL }, 467, "udp" },
+ { "photuris", { NULL }, 468, "tcp" },
+ { "photuris", { NULL }, 468, "udp" },
+ { "rcp", { NULL }, 469, "tcp" },
+ { "rcp", { NULL }, 469, "udp" },
+ { "scx-proxy", { NULL }, 470, "tcp" },
+ { "scx-proxy", { NULL }, 470, "udp" },
+ { "mondex", { NULL }, 471, "tcp" },
+ { "mondex", { NULL }, 471, "udp" },
+ { "ljk-login", { NULL }, 472, "tcp" },
+ { "ljk-login", { NULL }, 472, "udp" },
+ { "hybrid-pop", { NULL }, 473, "tcp" },
+ { "hybrid-pop", { NULL }, 473, "udp" },
+ { "tn-tl-w1", { NULL }, 474, "tcp" },
+ { "tn-tl-w2", { NULL }, 474, "udp" },
+ { "tcpnethaspsrv", { NULL }, 475, "tcp" },
+ { "tcpnethaspsrv", { NULL }, 475, "udp" },
+ { "tn-tl-fd1", { NULL }, 476, "tcp" },
+ { "tn-tl-fd1", { NULL }, 476, "udp" },
+ { "ss7ns", { NULL }, 477, "tcp" },
+ { "ss7ns", { NULL }, 477, "udp" },
+ { "spsc", { NULL }, 478, "tcp" },
+ { "spsc", { NULL }, 478, "udp" },
+ { "iafserver", { NULL }, 479, "tcp" },
+ { "iafserver", { NULL }, 479, "udp" },
+ { "iafdbase", { NULL }, 480, "tcp" },
+ { "iafdbase", { NULL }, 480, "udp" },
+ { "ph", { NULL }, 481, "tcp" },
+ { "ph", { NULL }, 481, "udp" },
+ { "bgs-nsi", { NULL }, 482, "tcp" },
+ { "bgs-nsi", { NULL }, 482, "udp" },
+ { "ulpnet", { NULL }, 483, "tcp" },
+ { "ulpnet", { NULL }, 483, "udp" },
+ { "integra-sme", { NULL }, 484, "tcp" },
+ { "integra-sme", { NULL }, 484, "udp" },
+ { "powerburst", { NULL }, 485, "tcp" },
+ { "powerburst", { NULL }, 485, "udp" },
+ { "avian", { NULL }, 486, "tcp" },
+ { "avian", { NULL }, 486, "udp" },
+ { "saft", { NULL }, 487, "tcp" },
+ { "saft", { NULL }, 487, "udp" },
+ { "gss-http", { NULL }, 488, "tcp" },
+ { "gss-http", { NULL }, 488, "udp" },
+ { "nest-protocol", { NULL }, 489, "tcp" },
+ { "nest-protocol", { NULL }, 489, "udp" },
+ { "micom-pfs", { NULL }, 490, "tcp" },
+ { "micom-pfs", { NULL }, 490, "udp" },
+ { "go-login", { NULL }, 491, "tcp" },
+ { "go-login", { NULL }, 491, "udp" },
+ { "ticf-1", { NULL }, 492, "tcp" },
+ { "ticf-1", { NULL }, 492, "udp" },
+ { "ticf-2", { NULL }, 493, "tcp" },
+ { "ticf-2", { NULL }, 493, "udp" },
+ { "pov-ray", { NULL }, 494, "tcp" },
+ { "pov-ray", { NULL }, 494, "udp" },
+ { "intecourier", { NULL }, 495, "tcp" },
+ { "intecourier", { NULL }, 495, "udp" },
+ { "pim-rp-disc", { NULL }, 496, "tcp" },
+ { "pim-rp-disc", { NULL }, 496, "udp" },
+ { "dantz", { NULL }, 497, "tcp" },
+ { "dantz", { NULL }, 497, "udp" },
+ { "siam", { NULL }, 498, "tcp" },
+ { "siam", { NULL }, 498, "udp" },
+ { "iso-ill", { NULL }, 499, "tcp" },
+ { "iso-ill", { NULL }, 499, "udp" },
+ { "isakmp", { NULL }, 500, "tcp" },
+ { "isakmp", { NULL }, 500, "udp" },
+ { "stmf", { NULL }, 501, "tcp" },
+ { "stmf", { NULL }, 501, "udp" },
+ { "asa-appl-proto", { NULL }, 502, "tcp" },
+ { "asa-appl-proto", { NULL }, 502, "udp" },
+ { "intrinsa", { NULL }, 503, "tcp" },
+ { "intrinsa", { NULL }, 503, "udp" },
+ { "citadel", { NULL }, 504, "tcp" },
+ { "citadel", { NULL }, 504, "udp" },
+ { "mailbox-lm", { NULL }, 505, "tcp" },
+ { "mailbox-lm", { NULL }, 505, "udp" },
+ { "ohimsrv", { NULL }, 506, "tcp" },
+ { "ohimsrv", { NULL }, 506, "udp" },
+ { "crs", { NULL }, 507, "tcp" },
+ { "crs", { NULL }, 507, "udp" },
+ { "xvttp", { NULL }, 508, "tcp" },
+ { "xvttp", { NULL }, 508, "udp" },
+ { "snare", { NULL }, 509, "tcp" },
+ { "snare", { NULL }, 509, "udp" },
+ { "fcp", { NULL }, 510, "tcp" },
+ { "fcp", { NULL }, 510, "udp" },
+ { "passgo", { NULL }, 511, "tcp" },
+ { "passgo", { NULL }, 511, "udp" },
+ { "exec", { NULL }, 512, "tcp" },
+ { "comsat", { NULL }, 512, "udp" },
+ { "biff", { NULL }, 512, "udp" },
+ { "login", { NULL }, 513, "tcp" },
+ { "who", { NULL }, 513, "udp" },
+ { "shell", { NULL }, 514, "tcp" },
+ { "syslog", { NULL }, 514, "udp" },
+ { "printer", { NULL }, 515, "tcp" },
+ { "printer", { NULL }, 515, "udp" },
+ { "videotex", { NULL }, 516, "tcp" },
+ { "videotex", { NULL }, 516, "udp" },
+ { "talk", { NULL }, 517, "tcp" },
+ { "talk", { NULL }, 517, "udp" },
+ { "ntalk", { NULL }, 518, "tcp" },
+ { "ntalk", { NULL }, 518, "udp" },
+ { "utime", { NULL }, 519, "tcp" },
+ { "utime", { NULL }, 519, "udp" },
+ { "efs", { NULL }, 520, "tcp" },
+ { "router", { NULL }, 520, "udp" },
+ { "ripng", { NULL }, 521, "tcp" },
+ { "ripng", { NULL }, 521, "udp" },
+ { "ulp", { NULL }, 522, "tcp" },
+ { "ulp", { NULL }, 522, "udp" },
+ { "ibm-db2", { NULL }, 523, "tcp" },
+ { "ibm-db2", { NULL }, 523, "udp" },
+ { "ncp", { NULL }, 524, "tcp" },
+ { "ncp", { NULL }, 524, "udp" },
+ { "timed", { NULL }, 525, "tcp" },
+ { "timed", { NULL }, 525, "udp" },
+ { "tempo", { NULL }, 526, "tcp" },
+ { "tempo", { NULL }, 526, "udp" },
+ { "stx", { NULL }, 527, "tcp" },
+ { "stx", { NULL }, 527, "udp" },
+ { "custix", { NULL }, 528, "tcp" },
+ { "custix", { NULL }, 528, "udp" },
+ { "irc-serv", { NULL }, 529, "tcp" },
+ { "irc-serv", { NULL }, 529, "udp" },
+ { "courier", { NULL }, 530, "tcp" },
+ { "courier", { NULL }, 530, "udp" },
+ { "conference", { NULL }, 531, "tcp" },
+ { "conference", { NULL }, 531, "udp" },
+ { "netnews", { NULL }, 532, "tcp" },
+ { "netnews", { NULL }, 532, "udp" },
+ { "netwall", { NULL }, 533, "tcp" },
+ { "netwall", { NULL }, 533, "udp" },
+ { "windream", { NULL }, 534, "tcp" },
+ { "windream", { NULL }, 534, "udp" },
+ { "iiop", { NULL }, 535, "tcp" },
+ { "iiop", { NULL }, 535, "udp" },
+ { "opalis-rdv", { NULL }, 536, "tcp" },
+ { "opalis-rdv", { NULL }, 536, "udp" },
+ { "nmsp", { NULL }, 537, "tcp" },
+ { "nmsp", { NULL }, 537, "udp" },
+ { "gdomap", { NULL }, 538, "tcp" },
+ { "gdomap", { NULL }, 538, "udp" },
+ { "apertus-ldp", { NULL }, 539, "tcp" },
+ { "apertus-ldp", { NULL }, 539, "udp" },
+ { "uucp", { NULL }, 540, "tcp" },
+ { "uucp", { NULL }, 540, "udp" },
+ { "uucp-rlogin", { NULL }, 541, "tcp" },
+ { "uucp-rlogin", { NULL }, 541, "udp" },
+ { "commerce", { NULL }, 542, "tcp" },
+ { "commerce", { NULL }, 542, "udp" },
+ { "klogin", { NULL }, 543, "tcp" },
+ { "klogin", { NULL }, 543, "udp" },
+ { "kshell", { NULL }, 544, "tcp" },
+ { "kshell", { NULL }, 544, "udp" },
+ { "appleqtcsrvr", { NULL }, 545, "tcp" },
+ { "appleqtcsrvr", { NULL }, 545, "udp" },
+ { "dhcpv6-client", { NULL }, 546, "tcp" },
+ { "dhcpv6-client", { NULL }, 546, "udp" },
+ { "dhcpv6-server", { NULL }, 547, "tcp" },
+ { "dhcpv6-server", { NULL }, 547, "udp" },
+ { "afpovertcp", { NULL }, 548, "tcp" },
+ { "afpovertcp", { NULL }, 548, "udp" },
+ { "idfp", { NULL }, 549, "tcp" },
+ { "idfp", { NULL }, 549, "udp" },
+ { "new-rwho", { NULL }, 550, "tcp" },
+ { "new-rwho", { NULL }, 550, "udp" },
+ { "cybercash", { NULL }, 551, "tcp" },
+ { "cybercash", { NULL }, 551, "udp" },
+ { "devshr-nts", { NULL }, 552, "tcp" },
+ { "devshr-nts", { NULL }, 552, "udp" },
+ { "pirp", { NULL }, 553, "tcp" },
+ { "pirp", { NULL }, 553, "udp" },
+ { "rtsp", { NULL }, 554, "tcp" },
+ { "rtsp", { NULL }, 554, "udp" },
+ { "dsf", { NULL }, 555, "tcp" },
+ { "dsf", { NULL }, 555, "udp" },
+ { "remotefs", { NULL }, 556, "tcp" },
+ { "remotefs", { NULL }, 556, "udp" },
+ { "openvms-sysipc", { NULL }, 557, "tcp" },
+ { "openvms-sysipc", { NULL }, 557, "udp" },
+ { "sdnskmp", { NULL }, 558, "tcp" },
+ { "sdnskmp", { NULL }, 558, "udp" },
+ { "teedtap", { NULL }, 559, "tcp" },
+ { "teedtap", { NULL }, 559, "udp" },
+ { "rmonitor", { NULL }, 560, "tcp" },
+ { "rmonitor", { NULL }, 560, "udp" },
+ { "monitor", { NULL }, 561, "tcp" },
+ { "monitor", { NULL }, 561, "udp" },
+ { "chshell", { NULL }, 562, "tcp" },
+ { "chshell", { NULL }, 562, "udp" },
+ { "nntps", { NULL }, 563, "tcp" },
+ { "nntps", { NULL }, 563, "udp" },
+ { "9pfs", { NULL }, 564, "tcp" },
+ { "9pfs", { NULL }, 564, "udp" },
+ { "whoami", { NULL }, 565, "tcp" },
+ { "whoami", { NULL }, 565, "udp" },
+ { "streettalk", { NULL }, 566, "tcp" },
+ { "streettalk", { NULL }, 566, "udp" },
+ { "banyan-rpc", { NULL }, 567, "tcp" },
+ { "banyan-rpc", { NULL }, 567, "udp" },
+ { "ms-shuttle", { NULL }, 568, "tcp" },
+ { "ms-shuttle", { NULL }, 568, "udp" },
+ { "ms-rome", { NULL }, 569, "tcp" },
+ { "ms-rome", { NULL }, 569, "udp" },
+ { "meter", { NULL }, 570, "tcp" },
+ { "meter", { NULL }, 570, "udp" },
+ { "meter", { NULL }, 571, "tcp" },
+ { "meter", { NULL }, 571, "udp" },
+ { "sonar", { NULL }, 572, "tcp" },
+ { "sonar", { NULL }, 572, "udp" },
+ { "banyan-vip", { NULL }, 573, "tcp" },
+ { "banyan-vip", { NULL }, 573, "udp" },
+ { "ftp-agent", { NULL }, 574, "tcp" },
+ { "ftp-agent", { NULL }, 574, "udp" },
+ { "vemmi", { NULL }, 575, "tcp" },
+ { "vemmi", { NULL }, 575, "udp" },
+ { "ipcd", { NULL }, 576, "tcp" },
+ { "ipcd", { NULL }, 576, "udp" },
+ { "vnas", { NULL }, 577, "tcp" },
+ { "vnas", { NULL }, 577, "udp" },
+ { "ipdd", { NULL }, 578, "tcp" },
+ { "ipdd", { NULL }, 578, "udp" },
+ { "decbsrv", { NULL }, 579, "tcp" },
+ { "decbsrv", { NULL }, 579, "udp" },
+ { "sntp-heartbeat", { NULL }, 580, "tcp" },
+ { "sntp-heartbeat", { NULL }, 580, "udp" },
+ { "bdp", { NULL }, 581, "tcp" },
+ { "bdp", { NULL }, 581, "udp" },
+ { "scc-security", { NULL }, 582, "tcp" },
+ { "scc-security", { NULL }, 582, "udp" },
+ { "philips-vc", { NULL }, 583, "tcp" },
+ { "philips-vc", { NULL }, 583, "udp" },
+ { "keyserver", { NULL }, 584, "tcp" },
+ { "keyserver", { NULL }, 584, "udp" },
+ { "password-chg", { NULL }, 586, "tcp" },
+ { "password-chg", { NULL }, 586, "udp" },
+ { "submission", { NULL }, 587, "tcp" },
+ { "submission", { NULL }, 587, "udp" },
+ { "cal", { NULL }, 588, "tcp" },
+ { "cal", { NULL }, 588, "udp" },
+ { "eyelink", { NULL }, 589, "tcp" },
+ { "eyelink", { NULL }, 589, "udp" },
+ { "tns-cml", { NULL }, 590, "tcp" },
+ { "tns-cml", { NULL }, 590, "udp" },
+ { "http-alt", { NULL }, 591, "tcp" },
+ { "http-alt", { NULL }, 591, "udp" },
+ { "eudora-set", { NULL }, 592, "tcp" },
+ { "eudora-set", { NULL }, 592, "udp" },
+ { "http-rpc-epmap", { NULL }, 593, "tcp" },
+ { "http-rpc-epmap", { NULL }, 593, "udp" },
+ { "tpip", { NULL }, 594, "tcp" },
+ { "tpip", { NULL }, 594, "udp" },
+ { "cab-protocol", { NULL }, 595, "tcp" },
+ { "cab-protocol", { NULL }, 595, "udp" },
+ { "smsd", { NULL }, 596, "tcp" },
+ { "smsd", { NULL }, 596, "udp" },
+ { "ptcnameservice", { NULL }, 597, "tcp" },
+ { "ptcnameservice", { NULL }, 597, "udp" },
+ { "sco-websrvrmg3", { NULL }, 598, "tcp" },
+ { "sco-websrvrmg3", { NULL }, 598, "udp" },
+ { "acp", { NULL }, 599, "tcp" },
+ { "acp", { NULL }, 599, "udp" },
+ { "ipcserver", { NULL }, 600, "tcp" },
+ { "ipcserver", { NULL }, 600, "udp" },
+ { "syslog-conn", { NULL }, 601, "tcp" },
+ { "syslog-conn", { NULL }, 601, "udp" },
+ { "xmlrpc-beep", { NULL }, 602, "tcp" },
+ { "xmlrpc-beep", { NULL }, 602, "udp" },
+ { "idxp", { NULL }, 603, "tcp" },
+ { "idxp", { NULL }, 603, "udp" },
+ { "tunnel", { NULL }, 604, "tcp" },
+ { "tunnel", { NULL }, 604, "udp" },
+ { "soap-beep", { NULL }, 605, "tcp" },
+ { "soap-beep", { NULL }, 605, "udp" },
+ { "urm", { NULL }, 606, "tcp" },
+ { "urm", { NULL }, 606, "udp" },
+ { "nqs", { NULL }, 607, "tcp" },
+ { "nqs", { NULL }, 607, "udp" },
+ { "sift-uft", { NULL }, 608, "tcp" },
+ { "sift-uft", { NULL }, 608, "udp" },
+ { "npmp-trap", { NULL }, 609, "tcp" },
+ { "npmp-trap", { NULL }, 609, "udp" },
+ { "npmp-local", { NULL }, 610, "tcp" },
+ { "npmp-local", { NULL }, 610, "udp" },
+ { "npmp-gui", { NULL }, 611, "tcp" },
+ { "npmp-gui", { NULL }, 611, "udp" },
+ { "hmmp-ind", { NULL }, 612, "tcp" },
+ { "hmmp-ind", { NULL }, 612, "udp" },
+ { "hmmp-op", { NULL }, 613, "tcp" },
+ { "hmmp-op", { NULL }, 613, "udp" },
+ { "sshell", { NULL }, 614, "tcp" },
+ { "sshell", { NULL }, 614, "udp" },
+ { "sco-inetmgr", { NULL }, 615, "tcp" },
+ { "sco-inetmgr", { NULL }, 615, "udp" },
+ { "sco-sysmgr", { NULL }, 616, "tcp" },
+ { "sco-sysmgr", { NULL }, 616, "udp" },
+ { "sco-dtmgr", { NULL }, 617, "tcp" },
+ { "sco-dtmgr", { NULL }, 617, "udp" },
+ { "dei-icda", { NULL }, 618, "tcp" },
+ { "dei-icda", { NULL }, 618, "udp" },
+ { "compaq-evm", { NULL }, 619, "tcp" },
+ { "compaq-evm", { NULL }, 619, "udp" },
+ { "sco-websrvrmgr", { NULL }, 620, "tcp" },
+ { "sco-websrvrmgr", { NULL }, 620, "udp" },
+ { "escp-ip", { NULL }, 621, "tcp" },
+ { "escp-ip", { NULL }, 621, "udp" },
+ { "collaborator", { NULL }, 622, "tcp" },
+ { "collaborator", { NULL }, 622, "udp" },
+ { "oob-ws-http", { NULL }, 623, "tcp" },
+ { "asf-rmcp", { NULL }, 623, "udp" },
+ { "cryptoadmin", { NULL }, 624, "tcp" },
+ { "cryptoadmin", { NULL }, 624, "udp" },
+ { "dec_dlm", { NULL }, 625, "tcp" },
+ { "dec_dlm", { NULL }, 625, "udp" },
+ { "asia", { NULL }, 626, "tcp" },
+ { "asia", { NULL }, 626, "udp" },
+ { "passgo-tivoli", { NULL }, 627, "tcp" },
+ { "passgo-tivoli", { NULL }, 627, "udp" },
+ { "qmqp", { NULL }, 628, "tcp" },
+ { "qmqp", { NULL }, 628, "udp" },
+ { "3com-amp3", { NULL }, 629, "tcp" },
+ { "3com-amp3", { NULL }, 629, "udp" },
+ { "rda", { NULL }, 630, "tcp" },
+ { "rda", { NULL }, 630, "udp" },
+ { "ipp", { NULL }, 631, "tcp" },
+ { "ipp", { NULL }, 631, "udp" },
+ { "bmpp", { NULL }, 632, "tcp" },
+ { "bmpp", { NULL }, 632, "udp" },
+ { "servstat", { NULL }, 633, "tcp" },
+ { "servstat", { NULL }, 633, "udp" },
+ { "ginad", { NULL }, 634, "tcp" },
+ { "ginad", { NULL }, 634, "udp" },
+ { "rlzdbase", { NULL }, 635, "tcp" },
+ { "rlzdbase", { NULL }, 635, "udp" },
+ { "ldaps", { NULL }, 636, "tcp" },
+ { "ldaps", { NULL }, 636, "udp" },
+ { "lanserver", { NULL }, 637, "tcp" },
+ { "lanserver", { NULL }, 637, "udp" },
+ { "mcns-sec", { NULL }, 638, "tcp" },
+ { "mcns-sec", { NULL }, 638, "udp" },
+ { "msdp", { NULL }, 639, "tcp" },
+ { "msdp", { NULL }, 639, "udp" },
+ { "entrust-sps", { NULL }, 640, "tcp" },
+ { "entrust-sps", { NULL }, 640, "udp" },
+ { "repcmd", { NULL }, 641, "tcp" },
+ { "repcmd", { NULL }, 641, "udp" },
+ { "esro-emsdp", { NULL }, 642, "tcp" },
+ { "esro-emsdp", { NULL }, 642, "udp" },
+ { "sanity", { NULL }, 643, "tcp" },
+ { "sanity", { NULL }, 643, "udp" },
+ { "dwr", { NULL }, 644, "tcp" },
+ { "dwr", { NULL }, 644, "udp" },
+ { "pssc", { NULL }, 645, "tcp" },
+ { "pssc", { NULL }, 645, "udp" },
+ { "ldp", { NULL }, 646, "tcp" },
+ { "ldp", { NULL }, 646, "udp" },
+ { "dhcp-failover", { NULL }, 647, "tcp" },
+ { "dhcp-failover", { NULL }, 647, "udp" },
+ { "rrp", { NULL }, 648, "tcp" },
+ { "rrp", { NULL }, 648, "udp" },
+ { "cadview-3d", { NULL }, 649, "tcp" },
+ { "cadview-3d", { NULL }, 649, "udp" },
+ { "obex", { NULL }, 650, "tcp" },
+ { "obex", { NULL }, 650, "udp" },
+ { "ieee-mms", { NULL }, 651, "tcp" },
+ { "ieee-mms", { NULL }, 651, "udp" },
+ { "hello-port", { NULL }, 652, "tcp" },
+ { "hello-port", { NULL }, 652, "udp" },
+ { "repscmd", { NULL }, 653, "tcp" },
+ { "repscmd", { NULL }, 653, "udp" },
+ { "aodv", { NULL }, 654, "tcp" },
+ { "aodv", { NULL }, 654, "udp" },
+ { "tinc", { NULL }, 655, "tcp" },
+ { "tinc", { NULL }, 655, "udp" },
+ { "spmp", { NULL }, 656, "tcp" },
+ { "spmp", { NULL }, 656, "udp" },
+ { "rmc", { NULL }, 657, "tcp" },
+ { "rmc", { NULL }, 657, "udp" },
+ { "tenfold", { NULL }, 658, "tcp" },
+ { "tenfold", { NULL }, 658, "udp" },
+ { "mac-srvr-admin", { NULL }, 660, "tcp" },
+ { "mac-srvr-admin", { NULL }, 660, "udp" },
+ { "hap", { NULL }, 661, "tcp" },
+ { "hap", { NULL }, 661, "udp" },
+ { "pftp", { NULL }, 662, "tcp" },
+ { "pftp", { NULL }, 662, "udp" },
+ { "purenoise", { NULL }, 663, "tcp" },
+ { "purenoise", { NULL }, 663, "udp" },
+ { "oob-ws-https", { NULL }, 664, "tcp" },
+ { "asf-secure-rmcp", { NULL }, 664, "udp" },
+ { "sun-dr", { NULL }, 665, "tcp" },
+ { "sun-dr", { NULL }, 665, "udp" },
+ { "mdqs", { NULL }, 666, "tcp" },
+ { "mdqs", { NULL }, 666, "udp" },
+ { "doom", { NULL }, 666, "tcp" },
+ { "doom", { NULL }, 666, "udp" },
+ { "disclose", { NULL }, 667, "tcp" },
+ { "disclose", { NULL }, 667, "udp" },
+ { "mecomm", { NULL }, 668, "tcp" },
+ { "mecomm", { NULL }, 668, "udp" },
+ { "meregister", { NULL }, 669, "tcp" },
+ { "meregister", { NULL }, 669, "udp" },
+ { "vacdsm-sws", { NULL }, 670, "tcp" },
+ { "vacdsm-sws", { NULL }, 670, "udp" },
+ { "vacdsm-app", { NULL }, 671, "tcp" },
+ { "vacdsm-app", { NULL }, 671, "udp" },
+ { "vpps-qua", { NULL }, 672, "tcp" },
+ { "vpps-qua", { NULL }, 672, "udp" },
+ { "cimplex", { NULL }, 673, "tcp" },
+ { "cimplex", { NULL }, 673, "udp" },
+ { "acap", { NULL }, 674, "tcp" },
+ { "acap", { NULL }, 674, "udp" },
+ { "dctp", { NULL }, 675, "tcp" },
+ { "dctp", { NULL }, 675, "udp" },
+ { "vpps-via", { NULL }, 676, "tcp" },
+ { "vpps-via", { NULL }, 676, "udp" },
+ { "vpp", { NULL }, 677, "tcp" },
+ { "vpp", { NULL }, 677, "udp" },
+ { "ggf-ncp", { NULL }, 678, "tcp" },
+ { "ggf-ncp", { NULL }, 678, "udp" },
+ { "mrm", { NULL }, 679, "tcp" },
+ { "mrm", { NULL }, 679, "udp" },
+ { "entrust-aaas", { NULL }, 680, "tcp" },
+ { "entrust-aaas", { NULL }, 680, "udp" },
+ { "entrust-aams", { NULL }, 681, "tcp" },
+ { "entrust-aams", { NULL }, 681, "udp" },
+ { "xfr", { NULL }, 682, "tcp" },
+ { "xfr", { NULL }, 682, "udp" },
+ { "corba-iiop", { NULL }, 683, "tcp" },
+ { "corba-iiop", { NULL }, 683, "udp" },
+ { "corba-iiop-ssl", { NULL }, 684, "tcp" },
+ { "corba-iiop-ssl", { NULL }, 684, "udp" },
+ { "mdc-portmapper", { NULL }, 685, "tcp" },
+ { "mdc-portmapper", { NULL }, 685, "udp" },
+ { "hcp-wismar", { NULL }, 686, "tcp" },
+ { "hcp-wismar", { NULL }, 686, "udp" },
+ { "asipregistry", { NULL }, 687, "tcp" },
+ { "asipregistry", { NULL }, 687, "udp" },
+ { "realm-rusd", { NULL }, 688, "tcp" },
+ { "realm-rusd", { NULL }, 688, "udp" },
+ { "nmap", { NULL }, 689, "tcp" },
+ { "nmap", { NULL }, 689, "udp" },
+ { "vatp", { NULL }, 690, "tcp" },
+ { "vatp", { NULL }, 690, "udp" },
+ { "msexch-routing", { NULL }, 691, "tcp" },
+ { "msexch-routing", { NULL }, 691, "udp" },
+ { "hyperwave-isp", { NULL }, 692, "tcp" },
+ { "hyperwave-isp", { NULL }, 692, "udp" },
+ { "connendp", { NULL }, 693, "tcp" },
+ { "connendp", { NULL }, 693, "udp" },
+ { "ha-cluster", { NULL }, 694, "tcp" },
+ { "ha-cluster", { NULL }, 694, "udp" },
+ { "ieee-mms-ssl", { NULL }, 695, "tcp" },
+ { "ieee-mms-ssl", { NULL }, 695, "udp" },
+ { "rushd", { NULL }, 696, "tcp" },
+ { "rushd", { NULL }, 696, "udp" },
+ { "uuidgen", { NULL }, 697, "tcp" },
+ { "uuidgen", { NULL }, 697, "udp" },
+ { "olsr", { NULL }, 698, "tcp" },
+ { "olsr", { NULL }, 698, "udp" },
+ { "accessnetwork", { NULL }, 699, "tcp" },
+ { "accessnetwork", { NULL }, 699, "udp" },
+ { "epp", { NULL }, 700, "tcp" },
+ { "epp", { NULL }, 700, "udp" },
+ { "lmp", { NULL }, 701, "tcp" },
+ { "lmp", { NULL }, 701, "udp" },
+ { "iris-beep", { NULL }, 702, "tcp" },
+ { "iris-beep", { NULL }, 702, "udp" },
+ { "elcsd", { NULL }, 704, "tcp" },
+ { "elcsd", { NULL }, 704, "udp" },
+ { "agentx", { NULL }, 705, "tcp" },
+ { "agentx", { NULL }, 705, "udp" },
+ { "silc", { NULL }, 706, "tcp" },
+ { "silc", { NULL }, 706, "udp" },
+ { "borland-dsj", { NULL }, 707, "tcp" },
+ { "borland-dsj", { NULL }, 707, "udp" },
+ { "entrust-kmsh", { NULL }, 709, "tcp" },
+ { "entrust-kmsh", { NULL }, 709, "udp" },
+ { "entrust-ash", { NULL }, 710, "tcp" },
+ { "entrust-ash", { NULL }, 710, "udp" },
+ { "cisco-tdp", { NULL }, 711, "tcp" },
+ { "cisco-tdp", { NULL }, 711, "udp" },
+ { "tbrpf", { NULL }, 712, "tcp" },
+ { "tbrpf", { NULL }, 712, "udp" },
+ { "iris-xpc", { NULL }, 713, "tcp" },
+ { "iris-xpc", { NULL }, 713, "udp" },
+ { "iris-xpcs", { NULL }, 714, "tcp" },
+ { "iris-xpcs", { NULL }, 714, "udp" },
+ { "iris-lwz", { NULL }, 715, "tcp" },
+ { "iris-lwz", { NULL }, 715, "udp" },
+ { "pana", { NULL }, 716, "udp" },
+ { "netviewdm1", { NULL }, 729, "tcp" },
+ { "netviewdm1", { NULL }, 729, "udp" },
+ { "netviewdm2", { NULL }, 730, "tcp" },
+ { "netviewdm2", { NULL }, 730, "udp" },
+ { "netviewdm3", { NULL }, 731, "tcp" },
+ { "netviewdm3", { NULL }, 731, "udp" },
+ { "netgw", { NULL }, 741, "tcp" },
+ { "netgw", { NULL }, 741, "udp" },
+ { "netrcs", { NULL }, 742, "tcp" },
+ { "netrcs", { NULL }, 742, "udp" },
+ { "flexlm", { NULL }, 744, "tcp" },
+ { "flexlm", { NULL }, 744, "udp" },
+ { "fujitsu-dev", { NULL }, 747, "tcp" },
+ { "fujitsu-dev", { NULL }, 747, "udp" },
+ { "ris-cm", { NULL }, 748, "tcp" },
+ { "ris-cm", { NULL }, 748, "udp" },
+ { "kerberos-adm", { NULL }, 749, "tcp" },
+ { "kerberos-adm", { NULL }, 749, "udp" },
+ { "rfile", { NULL }, 750, "tcp" },
+ { "loadav", { NULL }, 750, "udp" },
+ { "kerberos-iv", { NULL }, 750, "udp" },
+ { "pump", { NULL }, 751, "tcp" },
+ { "pump", { NULL }, 751, "udp" },
+ { "qrh", { NULL }, 752, "tcp" },
+ { "qrh", { NULL }, 752, "udp" },
+ { "rrh", { NULL }, 753, "tcp" },
+ { "rrh", { NULL }, 753, "udp" },
+ { "tell", { NULL }, 754, "tcp" },
+ { "tell", { NULL }, 754, "udp" },
+ { "nlogin", { NULL }, 758, "tcp" },
+ { "nlogin", { NULL }, 758, "udp" },
+ { "con", { NULL }, 759, "tcp" },
+ { "con", { NULL }, 759, "udp" },
+ { "ns", { NULL }, 760, "tcp" },
+ { "ns", { NULL }, 760, "udp" },
+ { "rxe", { NULL }, 761, "tcp" },
+ { "rxe", { NULL }, 761, "udp" },
+ { "quotad", { NULL }, 762, "tcp" },
+ { "quotad", { NULL }, 762, "udp" },
+ { "cycleserv", { NULL }, 763, "tcp" },
+ { "cycleserv", { NULL }, 763, "udp" },
+ { "omserv", { NULL }, 764, "tcp" },
+ { "omserv", { NULL }, 764, "udp" },
+ { "webster", { NULL }, 765, "tcp" },
+ { "webster", { NULL }, 765, "udp" },
+ { "phonebook", { NULL }, 767, "tcp" },
+ { "phonebook", { NULL }, 767, "udp" },
+ { "vid", { NULL }, 769, "tcp" },
+ { "vid", { NULL }, 769, "udp" },
+ { "cadlock", { NULL }, 770, "tcp" },
+ { "cadlock", { NULL }, 770, "udp" },
+ { "rtip", { NULL }, 771, "tcp" },
+ { "rtip", { NULL }, 771, "udp" },
+ { "cycleserv2", { NULL }, 772, "tcp" },
+ { "cycleserv2", { NULL }, 772, "udp" },
+ { "submit", { NULL }, 773, "tcp" },
+ { "notify", { NULL }, 773, "udp" },
+ { "rpasswd", { NULL }, 774, "tcp" },
+ { "acmaint_dbd", { NULL }, 774, "udp" },
+ { "entomb", { NULL }, 775, "tcp" },
+ { "acmaint_transd", { NULL }, 775, "udp" },
+ { "wpages", { NULL }, 776, "tcp" },
+ { "wpages", { NULL }, 776, "udp" },
+ { "multiling-http", { NULL }, 777, "tcp" },
+ { "multiling-http", { NULL }, 777, "udp" },
+ { "wpgs", { NULL }, 780, "tcp" },
+ { "wpgs", { NULL }, 780, "udp" },
+ { "mdbs_daemon", { NULL }, 800, "tcp" },
+ { "mdbs_daemon", { NULL }, 800, "udp" },
+ { "device", { NULL }, 801, "tcp" },
+ { "device", { NULL }, 801, "udp" },
+ { "fcp-udp", { NULL }, 810, "tcp" },
+ { "fcp-udp", { NULL }, 810, "udp" },
+ { "itm-mcell-s", { NULL }, 828, "tcp" },
+ { "itm-mcell-s", { NULL }, 828, "udp" },
+ { "pkix-3-ca-ra", { NULL }, 829, "tcp" },
+ { "pkix-3-ca-ra", { NULL }, 829, "udp" },
+ { "netconf-ssh", { NULL }, 830, "tcp" },
+ { "netconf-ssh", { NULL }, 830, "udp" },
+ { "netconf-beep", { NULL }, 831, "tcp" },
+ { "netconf-beep", { NULL }, 831, "udp" },
+ { "netconfsoaphttp", { NULL }, 832, "tcp" },
+ { "netconfsoaphttp", { NULL }, 832, "udp" },
+ { "netconfsoapbeep", { NULL }, 833, "tcp" },
+ { "netconfsoapbeep", { NULL }, 833, "udp" },
+ { "dhcp-failover2", { NULL }, 847, "tcp" },
+ { "dhcp-failover2", { NULL }, 847, "udp" },
+ { "gdoi", { NULL }, 848, "tcp" },
+ { "gdoi", { NULL }, 848, "udp" },
+ { "iscsi", { NULL }, 860, "tcp" },
+ { "iscsi", { NULL }, 860, "udp" },
+ { "owamp-control", { NULL }, 861, "tcp" },
+ { "owamp-control", { NULL }, 861, "udp" },
+ { "twamp-control", { NULL }, 862, "tcp" },
+ { "twamp-control", { NULL }, 862, "udp" },
+ { "rsync", { NULL }, 873, "tcp" },
+ { "rsync", { NULL }, 873, "udp" },
+ { "iclcnet-locate", { NULL }, 886, "tcp" },
+ { "iclcnet-locate", { NULL }, 886, "udp" },
+ { "iclcnet_svinfo", { NULL }, 887, "tcp" },
+ { "iclcnet_svinfo", { NULL }, 887, "udp" },
+ { "accessbuilder", { NULL }, 888, "tcp" },
+ { "accessbuilder", { NULL }, 888, "udp" },
+ { "cddbp", { NULL }, 888, "tcp" },
+ { "omginitialrefs", { NULL }, 900, "tcp" },
+ { "omginitialrefs", { NULL }, 900, "udp" },
+ { "smpnameres", { NULL }, 901, "tcp" },
+ { "smpnameres", { NULL }, 901, "udp" },
+ { "ideafarm-door", { NULL }, 902, "tcp" },
+ { "ideafarm-door", { NULL }, 902, "udp" },
+ { "ideafarm-panic", { NULL }, 903, "tcp" },
+ { "ideafarm-panic", { NULL }, 903, "udp" },
+ { "kink", { NULL }, 910, "tcp" },
+ { "kink", { NULL }, 910, "udp" },
+ { "xact-backup", { NULL }, 911, "tcp" },
+ { "xact-backup", { NULL }, 911, "udp" },
+ { "apex-mesh", { NULL }, 912, "tcp" },
+ { "apex-mesh", { NULL }, 912, "udp" },
+ { "apex-edge", { NULL }, 913, "tcp" },
+ { "apex-edge", { NULL }, 913, "udp" },
+ { "ftps-data", { NULL }, 989, "tcp" },
+ { "ftps-data", { NULL }, 989, "udp" },
+ { "ftps", { NULL }, 990, "tcp" },
+ { "ftps", { NULL }, 990, "udp" },
+ { "nas", { NULL }, 991, "tcp" },
+ { "nas", { NULL }, 991, "udp" },
+ { "telnets", { NULL }, 992, "tcp" },
+ { "telnets", { NULL }, 992, "udp" },
+ { "imaps", { NULL }, 993, "tcp" },
+ { "imaps", { NULL }, 993, "udp" },
+ { "ircs", { NULL }, 994, "tcp" },
+ { "ircs", { NULL }, 994, "udp" },
+ { "pop3s", { NULL }, 995, "tcp" },
+ { "pop3s", { NULL }, 995, "udp" },
+ { "vsinet", { NULL }, 996, "tcp" },
+ { "vsinet", { NULL }, 996, "udp" },
+ { "maitrd", { NULL }, 997, "tcp" },
+ { "maitrd", { NULL }, 997, "udp" },
+ { "busboy", { NULL }, 998, "tcp" },
+ { "puparp", { NULL }, 998, "udp" },
+ { "garcon", { NULL }, 999, "tcp" },
+ { "applix", { NULL }, 999, "udp" },
+ { "puprouter", { NULL }, 999, "tcp" },
+ { "puprouter", { NULL }, 999, "udp" },
+ { "cadlock2", { NULL }, 1000, "tcp" },
+ { "cadlock2", { NULL }, 1000, "udp" },
+ { "surf", { NULL }, 1010, "tcp" },
+ { "surf", { NULL }, 1010, "udp" },
+ { "exp1", { NULL }, 1021, "tcp" },
+ { "exp1", { NULL }, 1021, "udp" },
+ { "exp2", { NULL }, 1022, "tcp" },
+ { "exp2", { NULL }, 1022, "udp" },
+# endif /* USE_IANA_WELL_KNOWN_PORTS */
+# ifdef USE_IANA_REGISTERED_PORTS
+ { "blackjack", { NULL }, 1025, "tcp" },
+ { "blackjack", { NULL }, 1025, "udp" },
+ { "cap", { NULL }, 1026, "tcp" },
+ { "cap", { NULL }, 1026, "udp" },
+ { "solid-mux", { NULL }, 1029, "tcp" },
+ { "solid-mux", { NULL }, 1029, "udp" },
+ { "iad1", { NULL }, 1030, "tcp" },
+ { "iad1", { NULL }, 1030, "udp" },
+ { "iad2", { NULL }, 1031, "tcp" },
+ { "iad2", { NULL }, 1031, "udp" },
+ { "iad3", { NULL }, 1032, "tcp" },
+ { "iad3", { NULL }, 1032, "udp" },
+ { "netinfo-local", { NULL }, 1033, "tcp" },
+ { "netinfo-local", { NULL }, 1033, "udp" },
+ { "activesync", { NULL }, 1034, "tcp" },
+ { "activesync", { NULL }, 1034, "udp" },
+ { "mxxrlogin", { NULL }, 1035, "tcp" },
+ { "mxxrlogin", { NULL }, 1035, "udp" },
+ { "nsstp", { NULL }, 1036, "tcp" },
+ { "nsstp", { NULL }, 1036, "udp" },
+ { "ams", { NULL }, 1037, "tcp" },
+ { "ams", { NULL }, 1037, "udp" },
+ { "mtqp", { NULL }, 1038, "tcp" },
+ { "mtqp", { NULL }, 1038, "udp" },
+ { "sbl", { NULL }, 1039, "tcp" },
+ { "sbl", { NULL }, 1039, "udp" },
+ { "netarx", { NULL }, 1040, "tcp" },
+ { "netarx", { NULL }, 1040, "udp" },
+ { "danf-ak2", { NULL }, 1041, "tcp" },
+ { "danf-ak2", { NULL }, 1041, "udp" },
+ { "afrog", { NULL }, 1042, "tcp" },
+ { "afrog", { NULL }, 1042, "udp" },
+ { "boinc-client", { NULL }, 1043, "tcp" },
+ { "boinc-client", { NULL }, 1043, "udp" },
+ { "dcutility", { NULL }, 1044, "tcp" },
+ { "dcutility", { NULL }, 1044, "udp" },
+ { "fpitp", { NULL }, 1045, "tcp" },
+ { "fpitp", { NULL }, 1045, "udp" },
+ { "wfremotertm", { NULL }, 1046, "tcp" },
+ { "wfremotertm", { NULL }, 1046, "udp" },
+ { "neod1", { NULL }, 1047, "tcp" },
+ { "neod1", { NULL }, 1047, "udp" },
+ { "neod2", { NULL }, 1048, "tcp" },
+ { "neod2", { NULL }, 1048, "udp" },
+ { "td-postman", { NULL }, 1049, "tcp" },
+ { "td-postman", { NULL }, 1049, "udp" },
+ { "cma", { NULL }, 1050, "tcp" },
+ { "cma", { NULL }, 1050, "udp" },
+ { "optima-vnet", { NULL }, 1051, "tcp" },
+ { "optima-vnet", { NULL }, 1051, "udp" },
+ { "ddt", { NULL }, 1052, "tcp" },
+ { "ddt", { NULL }, 1052, "udp" },
+ { "remote-as", { NULL }, 1053, "tcp" },
+ { "remote-as", { NULL }, 1053, "udp" },
+ { "brvread", { NULL }, 1054, "tcp" },
+ { "brvread", { NULL }, 1054, "udp" },
+ { "ansyslmd", { NULL }, 1055, "tcp" },
+ { "ansyslmd", { NULL }, 1055, "udp" },
+ { "vfo", { NULL }, 1056, "tcp" },
+ { "vfo", { NULL }, 1056, "udp" },
+ { "startron", { NULL }, 1057, "tcp" },
+ { "startron", { NULL }, 1057, "udp" },
+ { "nim", { NULL }, 1058, "tcp" },
+ { "nim", { NULL }, 1058, "udp" },
+ { "nimreg", { NULL }, 1059, "tcp" },
+ { "nimreg", { NULL }, 1059, "udp" },
+ { "polestar", { NULL }, 1060, "tcp" },
+ { "polestar", { NULL }, 1060, "udp" },
+ { "kiosk", { NULL }, 1061, "tcp" },
+ { "kiosk", { NULL }, 1061, "udp" },
+ { "veracity", { NULL }, 1062, "tcp" },
+ { "veracity", { NULL }, 1062, "udp" },
+ { "kyoceranetdev", { NULL }, 1063, "tcp" },
+ { "kyoceranetdev", { NULL }, 1063, "udp" },
+ { "jstel", { NULL }, 1064, "tcp" },
+ { "jstel", { NULL }, 1064, "udp" },
+ { "syscomlan", { NULL }, 1065, "tcp" },
+ { "syscomlan", { NULL }, 1065, "udp" },
+ { "fpo-fns", { NULL }, 1066, "tcp" },
+ { "fpo-fns", { NULL }, 1066, "udp" },
+ { "instl_boots", { NULL }, 1067, "tcp" },
+ { "instl_boots", { NULL }, 1067, "udp" },
+ { "instl_bootc", { NULL }, 1068, "tcp" },
+ { "instl_bootc", { NULL }, 1068, "udp" },
+ { "cognex-insight", { NULL }, 1069, "tcp" },
+ { "cognex-insight", { NULL }, 1069, "udp" },
+ { "gmrupdateserv", { NULL }, 1070, "tcp" },
+ { "gmrupdateserv", { NULL }, 1070, "udp" },
+ { "bsquare-voip", { NULL }, 1071, "tcp" },
+ { "bsquare-voip", { NULL }, 1071, "udp" },
+ { "cardax", { NULL }, 1072, "tcp" },
+ { "cardax", { NULL }, 1072, "udp" },
+ { "bridgecontrol", { NULL }, 1073, "tcp" },
+ { "bridgecontrol", { NULL }, 1073, "udp" },
+ { "warmspotMgmt", { NULL }, 1074, "tcp" },
+ { "warmspotMgmt", { NULL }, 1074, "udp" },
+ { "rdrmshc", { NULL }, 1075, "tcp" },
+ { "rdrmshc", { NULL }, 1075, "udp" },
+ { "dab-sti-c", { NULL }, 1076, "tcp" },
+ { "dab-sti-c", { NULL }, 1076, "udp" },
+ { "imgames", { NULL }, 1077, "tcp" },
+ { "imgames", { NULL }, 1077, "udp" },
+ { "avocent-proxy", { NULL }, 1078, "tcp" },
+ { "avocent-proxy", { NULL }, 1078, "udp" },
+ { "asprovatalk", { NULL }, 1079, "tcp" },
+ { "asprovatalk", { NULL }, 1079, "udp" },
+ { "socks", { NULL }, 1080, "tcp" },
+ { "socks", { NULL }, 1080, "udp" },
+ { "pvuniwien", { NULL }, 1081, "tcp" },
+ { "pvuniwien", { NULL }, 1081, "udp" },
+ { "amt-esd-prot", { NULL }, 1082, "tcp" },
+ { "amt-esd-prot", { NULL }, 1082, "udp" },
+ { "ansoft-lm-1", { NULL }, 1083, "tcp" },
+ { "ansoft-lm-1", { NULL }, 1083, "udp" },
+ { "ansoft-lm-2", { NULL }, 1084, "tcp" },
+ { "ansoft-lm-2", { NULL }, 1084, "udp" },
+ { "webobjects", { NULL }, 1085, "tcp" },
+ { "webobjects", { NULL }, 1085, "udp" },
+ { "cplscrambler-lg", { NULL }, 1086, "tcp" },
+ { "cplscrambler-lg", { NULL }, 1086, "udp" },
+ { "cplscrambler-in", { NULL }, 1087, "tcp" },
+ { "cplscrambler-in", { NULL }, 1087, "udp" },
+ { "cplscrambler-al", { NULL }, 1088, "tcp" },
+ { "cplscrambler-al", { NULL }, 1088, "udp" },
+ { "ff-annunc", { NULL }, 1089, "tcp" },
+ { "ff-annunc", { NULL }, 1089, "udp" },
+ { "ff-fms", { NULL }, 1090, "tcp" },
+ { "ff-fms", { NULL }, 1090, "udp" },
+ { "ff-sm", { NULL }, 1091, "tcp" },
+ { "ff-sm", { NULL }, 1091, "udp" },
+ { "obrpd", { NULL }, 1092, "tcp" },
+ { "obrpd", { NULL }, 1092, "udp" },
+ { "proofd", { NULL }, 1093, "tcp" },
+ { "proofd", { NULL }, 1093, "udp" },
+ { "rootd", { NULL }, 1094, "tcp" },
+ { "rootd", { NULL }, 1094, "udp" },
+ { "nicelink", { NULL }, 1095, "tcp" },
+ { "nicelink", { NULL }, 1095, "udp" },
+ { "cnrprotocol", { NULL }, 1096, "tcp" },
+ { "cnrprotocol", { NULL }, 1096, "udp" },
+ { "sunclustermgr", { NULL }, 1097, "tcp" },
+ { "sunclustermgr", { NULL }, 1097, "udp" },
+ { "rmiactivation", { NULL }, 1098, "tcp" },
+ { "rmiactivation", { NULL }, 1098, "udp" },
+ { "rmiregistry", { NULL }, 1099, "tcp" },
+ { "rmiregistry", { NULL }, 1099, "udp" },
+ { "mctp", { NULL }, 1100, "tcp" },
+ { "mctp", { NULL }, 1100, "udp" },
+ { "pt2-discover", { NULL }, 1101, "tcp" },
+ { "pt2-discover", { NULL }, 1101, "udp" },
+ { "adobeserver-1", { NULL }, 1102, "tcp" },
+ { "adobeserver-1", { NULL }, 1102, "udp" },
+ { "adobeserver-2", { NULL }, 1103, "tcp" },
+ { "adobeserver-2", { NULL }, 1103, "udp" },
+ { "xrl", { NULL }, 1104, "tcp" },
+ { "xrl", { NULL }, 1104, "udp" },
+ { "ftranhc", { NULL }, 1105, "tcp" },
+ { "ftranhc", { NULL }, 1105, "udp" },
+ { "isoipsigport-1", { NULL }, 1106, "tcp" },
+ { "isoipsigport-1", { NULL }, 1106, "udp" },
+ { "isoipsigport-2", { NULL }, 1107, "tcp" },
+ { "isoipsigport-2", { NULL }, 1107, "udp" },
+ { "ratio-adp", { NULL }, 1108, "tcp" },
+ { "ratio-adp", { NULL }, 1108, "udp" },
+ { "webadmstart", { NULL }, 1110, "tcp" },
+ { "nfsd-keepalive", { NULL }, 1110, "udp" },
+ { "lmsocialserver", { NULL }, 1111, "tcp" },
+ { "lmsocialserver", { NULL }, 1111, "udp" },
+ { "icp", { NULL }, 1112, "tcp" },
+ { "icp", { NULL }, 1112, "udp" },
+ { "ltp-deepspace", { NULL }, 1113, "tcp" },
+ { "ltp-deepspace", { NULL }, 1113, "udp" },
+ { "mini-sql", { NULL }, 1114, "tcp" },
+ { "mini-sql", { NULL }, 1114, "udp" },
+ { "ardus-trns", { NULL }, 1115, "tcp" },
+ { "ardus-trns", { NULL }, 1115, "udp" },
+ { "ardus-cntl", { NULL }, 1116, "tcp" },
+ { "ardus-cntl", { NULL }, 1116, "udp" },
+ { "ardus-mtrns", { NULL }, 1117, "tcp" },
+ { "ardus-mtrns", { NULL }, 1117, "udp" },
+ { "sacred", { NULL }, 1118, "tcp" },
+ { "sacred", { NULL }, 1118, "udp" },
+ { "bnetgame", { NULL }, 1119, "tcp" },
+ { "bnetgame", { NULL }, 1119, "udp" },
+ { "bnetfile", { NULL }, 1120, "tcp" },
+ { "bnetfile", { NULL }, 1120, "udp" },
+ { "rmpp", { NULL }, 1121, "tcp" },
+ { "rmpp", { NULL }, 1121, "udp" },
+ { "availant-mgr", { NULL }, 1122, "tcp" },
+ { "availant-mgr", { NULL }, 1122, "udp" },
+ { "murray", { NULL }, 1123, "tcp" },
+ { "murray", { NULL }, 1123, "udp" },
+ { "hpvmmcontrol", { NULL }, 1124, "tcp" },
+ { "hpvmmcontrol", { NULL }, 1124, "udp" },
+ { "hpvmmagent", { NULL }, 1125, "tcp" },
+ { "hpvmmagent", { NULL }, 1125, "udp" },
+ { "hpvmmdata", { NULL }, 1126, "tcp" },
+ { "hpvmmdata", { NULL }, 1126, "udp" },
+ { "kwdb-commn", { NULL }, 1127, "tcp" },
+ { "kwdb-commn", { NULL }, 1127, "udp" },
+ { "saphostctrl", { NULL }, 1128, "tcp" },
+ { "saphostctrl", { NULL }, 1128, "udp" },
+ { "saphostctrls", { NULL }, 1129, "tcp" },
+ { "saphostctrls", { NULL }, 1129, "udp" },
+ { "casp", { NULL }, 1130, "tcp" },
+ { "casp", { NULL }, 1130, "udp" },
+ { "caspssl", { NULL }, 1131, "tcp" },
+ { "caspssl", { NULL }, 1131, "udp" },
+ { "kvm-via-ip", { NULL }, 1132, "tcp" },
+ { "kvm-via-ip", { NULL }, 1132, "udp" },
+ { "dfn", { NULL }, 1133, "tcp" },
+ { "dfn", { NULL }, 1133, "udp" },
+ { "aplx", { NULL }, 1134, "tcp" },
+ { "aplx", { NULL }, 1134, "udp" },
+ { "omnivision", { NULL }, 1135, "tcp" },
+ { "omnivision", { NULL }, 1135, "udp" },
+ { "hhb-gateway", { NULL }, 1136, "tcp" },
+ { "hhb-gateway", { NULL }, 1136, "udp" },
+ { "trim", { NULL }, 1137, "tcp" },
+ { "trim", { NULL }, 1137, "udp" },
+ { "encrypted_admin", { NULL }, 1138, "tcp" },
+ { "encrypted_admin", { NULL }, 1138, "udp" },
+ { "evm", { NULL }, 1139, "tcp" },
+ { "evm", { NULL }, 1139, "udp" },
+ { "autonoc", { NULL }, 1140, "tcp" },
+ { "autonoc", { NULL }, 1140, "udp" },
+ { "mxomss", { NULL }, 1141, "tcp" },
+ { "mxomss", { NULL }, 1141, "udp" },
+ { "edtools", { NULL }, 1142, "tcp" },
+ { "edtools", { NULL }, 1142, "udp" },
+ { "imyx", { NULL }, 1143, "tcp" },
+ { "imyx", { NULL }, 1143, "udp" },
+ { "fuscript", { NULL }, 1144, "tcp" },
+ { "fuscript", { NULL }, 1144, "udp" },
+ { "x9-icue", { NULL }, 1145, "tcp" },
+ { "x9-icue", { NULL }, 1145, "udp" },
+ { "audit-transfer", { NULL }, 1146, "tcp" },
+ { "audit-transfer", { NULL }, 1146, "udp" },
+ { "capioverlan", { NULL }, 1147, "tcp" },
+ { "capioverlan", { NULL }, 1147, "udp" },
+ { "elfiq-repl", { NULL }, 1148, "tcp" },
+ { "elfiq-repl", { NULL }, 1148, "udp" },
+ { "bvtsonar", { NULL }, 1149, "tcp" },
+ { "bvtsonar", { NULL }, 1149, "udp" },
+ { "blaze", { NULL }, 1150, "tcp" },
+ { "blaze", { NULL }, 1150, "udp" },
+ { "unizensus", { NULL }, 1151, "tcp" },
+ { "unizensus", { NULL }, 1151, "udp" },
+ { "winpoplanmess", { NULL }, 1152, "tcp" },
+ { "winpoplanmess", { NULL }, 1152, "udp" },
+ { "c1222-acse", { NULL }, 1153, "tcp" },
+ { "c1222-acse", { NULL }, 1153, "udp" },
+ { "resacommunity", { NULL }, 1154, "tcp" },
+ { "resacommunity", { NULL }, 1154, "udp" },
+ { "nfa", { NULL }, 1155, "tcp" },
+ { "nfa", { NULL }, 1155, "udp" },
+ { "iascontrol-oms", { NULL }, 1156, "tcp" },
+ { "iascontrol-oms", { NULL }, 1156, "udp" },
+ { "iascontrol", { NULL }, 1157, "tcp" },
+ { "iascontrol", { NULL }, 1157, "udp" },
+ { "dbcontrol-oms", { NULL }, 1158, "tcp" },
+ { "dbcontrol-oms", { NULL }, 1158, "udp" },
+ { "oracle-oms", { NULL }, 1159, "tcp" },
+ { "oracle-oms", { NULL }, 1159, "udp" },
+ { "olsv", { NULL }, 1160, "tcp" },
+ { "olsv", { NULL }, 1160, "udp" },
+ { "health-polling", { NULL }, 1161, "tcp" },
+ { "health-polling", { NULL }, 1161, "udp" },
+ { "health-trap", { NULL }, 1162, "tcp" },
+ { "health-trap", { NULL }, 1162, "udp" },
+ { "sddp", { NULL }, 1163, "tcp" },
+ { "sddp", { NULL }, 1163, "udp" },
+ { "qsm-proxy", { NULL }, 1164, "tcp" },
+ { "qsm-proxy", { NULL }, 1164, "udp" },
+ { "qsm-gui", { NULL }, 1165, "tcp" },
+ { "qsm-gui", { NULL }, 1165, "udp" },
+ { "qsm-remote", { NULL }, 1166, "tcp" },
+ { "qsm-remote", { NULL }, 1166, "udp" },
+ { "cisco-ipsla", { NULL }, 1167, "tcp" },
+ { "cisco-ipsla", { NULL }, 1167, "udp" },
+ { "cisco-ipsla", { NULL }, 1167, "sctp"},
+ { "vchat", { NULL }, 1168, "tcp" },
+ { "vchat", { NULL }, 1168, "udp" },
+ { "tripwire", { NULL }, 1169, "tcp" },
+ { "tripwire", { NULL }, 1169, "udp" },
+ { "atc-lm", { NULL }, 1170, "tcp" },
+ { "atc-lm", { NULL }, 1170, "udp" },
+ { "atc-appserver", { NULL }, 1171, "tcp" },
+ { "atc-appserver", { NULL }, 1171, "udp" },
+ { "dnap", { NULL }, 1172, "tcp" },
+ { "dnap", { NULL }, 1172, "udp" },
+ { "d-cinema-rrp", { NULL }, 1173, "tcp" },
+ { "d-cinema-rrp", { NULL }, 1173, "udp" },
+ { "fnet-remote-ui", { NULL }, 1174, "tcp" },
+ { "fnet-remote-ui", { NULL }, 1174, "udp" },
+ { "dossier", { NULL }, 1175, "tcp" },
+ { "dossier", { NULL }, 1175, "udp" },
+ { "indigo-server", { NULL }, 1176, "tcp" },
+ { "indigo-server", { NULL }, 1176, "udp" },
+ { "dkmessenger", { NULL }, 1177, "tcp" },
+ { "dkmessenger", { NULL }, 1177, "udp" },
+ { "sgi-storman", { NULL }, 1178, "tcp" },
+ { "sgi-storman", { NULL }, 1178, "udp" },
+ { "b2n", { NULL }, 1179, "tcp" },
+ { "b2n", { NULL }, 1179, "udp" },
+ { "mc-client", { NULL }, 1180, "tcp" },
+ { "mc-client", { NULL }, 1180, "udp" },
+ { "3comnetman", { NULL }, 1181, "tcp" },
+ { "3comnetman", { NULL }, 1181, "udp" },
+ { "accelenet", { NULL }, 1182, "tcp" },
+ { "accelenet-data", { NULL }, 1182, "udp" },
+ { "llsurfup-http", { NULL }, 1183, "tcp" },
+ { "llsurfup-http", { NULL }, 1183, "udp" },
+ { "llsurfup-https", { NULL }, 1184, "tcp" },
+ { "llsurfup-https", { NULL }, 1184, "udp" },
+ { "catchpole", { NULL }, 1185, "tcp" },
+ { "catchpole", { NULL }, 1185, "udp" },
+ { "mysql-cluster", { NULL }, 1186, "tcp" },
+ { "mysql-cluster", { NULL }, 1186, "udp" },
+ { "alias", { NULL }, 1187, "tcp" },
+ { "alias", { NULL }, 1187, "udp" },
+ { "hp-webadmin", { NULL }, 1188, "tcp" },
+ { "hp-webadmin", { NULL }, 1188, "udp" },
+ { "unet", { NULL }, 1189, "tcp" },
+ { "unet", { NULL }, 1189, "udp" },
+ { "commlinx-avl", { NULL }, 1190, "tcp" },
+ { "commlinx-avl", { NULL }, 1190, "udp" },
+ { "gpfs", { NULL }, 1191, "tcp" },
+ { "gpfs", { NULL }, 1191, "udp" },
+ { "caids-sensor", { NULL }, 1192, "tcp" },
+ { "caids-sensor", { NULL }, 1192, "udp" },
+ { "fiveacross", { NULL }, 1193, "tcp" },
+ { "fiveacross", { NULL }, 1193, "udp" },
+ { "openvpn", { NULL }, 1194, "tcp" },
+ { "openvpn", { NULL }, 1194, "udp" },
+ { "rsf-1", { NULL }, 1195, "tcp" },
+ { "rsf-1", { NULL }, 1195, "udp" },
+ { "netmagic", { NULL }, 1196, "tcp" },
+ { "netmagic", { NULL }, 1196, "udp" },
+ { "carrius-rshell", { NULL }, 1197, "tcp" },
+ { "carrius-rshell", { NULL }, 1197, "udp" },
+ { "cajo-discovery", { NULL }, 1198, "tcp" },
+ { "cajo-discovery", { NULL }, 1198, "udp" },
+ { "dmidi", { NULL }, 1199, "tcp" },
+ { "dmidi", { NULL }, 1199, "udp" },
+ { "scol", { NULL }, 1200, "tcp" },
+ { "scol", { NULL }, 1200, "udp" },
+ { "nucleus-sand", { NULL }, 1201, "tcp" },
+ { "nucleus-sand", { NULL }, 1201, "udp" },
+ { "caiccipc", { NULL }, 1202, "tcp" },
+ { "caiccipc", { NULL }, 1202, "udp" },
+ { "ssslic-mgr", { NULL }, 1203, "tcp" },
+ { "ssslic-mgr", { NULL }, 1203, "udp" },
+ { "ssslog-mgr", { NULL }, 1204, "tcp" },
+ { "ssslog-mgr", { NULL }, 1204, "udp" },
+ { "accord-mgc", { NULL }, 1205, "tcp" },
+ { "accord-mgc", { NULL }, 1205, "udp" },
+ { "anthony-data", { NULL }, 1206, "tcp" },
+ { "anthony-data", { NULL }, 1206, "udp" },
+ { "metasage", { NULL }, 1207, "tcp" },
+ { "metasage", { NULL }, 1207, "udp" },
+ { "seagull-ais", { NULL }, 1208, "tcp" },
+ { "seagull-ais", { NULL }, 1208, "udp" },
+ { "ipcd3", { NULL }, 1209, "tcp" },
+ { "ipcd3", { NULL }, 1209, "udp" },
+ { "eoss", { NULL }, 1210, "tcp" },
+ { "eoss", { NULL }, 1210, "udp" },
+ { "groove-dpp", { NULL }, 1211, "tcp" },
+ { "groove-dpp", { NULL }, 1211, "udp" },
+ { "lupa", { NULL }, 1212, "tcp" },
+ { "lupa", { NULL }, 1212, "udp" },
+ { "mpc-lifenet", { NULL }, 1213, "tcp" },
+ { "mpc-lifenet", { NULL }, 1213, "udp" },
+ { "kazaa", { NULL }, 1214, "tcp" },
+ { "kazaa", { NULL }, 1214, "udp" },
+ { "scanstat-1", { NULL }, 1215, "tcp" },
+ { "scanstat-1", { NULL }, 1215, "udp" },
+ { "etebac5", { NULL }, 1216, "tcp" },
+ { "etebac5", { NULL }, 1216, "udp" },
+ { "hpss-ndapi", { NULL }, 1217, "tcp" },
+ { "hpss-ndapi", { NULL }, 1217, "udp" },
+ { "aeroflight-ads", { NULL }, 1218, "tcp" },
+ { "aeroflight-ads", { NULL }, 1218, "udp" },
+ { "aeroflight-ret", { NULL }, 1219, "tcp" },
+ { "aeroflight-ret", { NULL }, 1219, "udp" },
+ { "qt-serveradmin", { NULL }, 1220, "tcp" },
+ { "qt-serveradmin", { NULL }, 1220, "udp" },
+ { "sweetware-apps", { NULL }, 1221, "tcp" },
+ { "sweetware-apps", { NULL }, 1221, "udp" },
+ { "nerv", { NULL }, 1222, "tcp" },
+ { "nerv", { NULL }, 1222, "udp" },
+ { "tgp", { NULL }, 1223, "tcp" },
+ { "tgp", { NULL }, 1223, "udp" },
+ { "vpnz", { NULL }, 1224, "tcp" },
+ { "vpnz", { NULL }, 1224, "udp" },
+ { "slinkysearch", { NULL }, 1225, "tcp" },
+ { "slinkysearch", { NULL }, 1225, "udp" },
+ { "stgxfws", { NULL }, 1226, "tcp" },
+ { "stgxfws", { NULL }, 1226, "udp" },
+ { "dns2go", { NULL }, 1227, "tcp" },
+ { "dns2go", { NULL }, 1227, "udp" },
+ { "florence", { NULL }, 1228, "tcp" },
+ { "florence", { NULL }, 1228, "udp" },
+ { "zented", { NULL }, 1229, "tcp" },
+ { "zented", { NULL }, 1229, "udp" },
+ { "periscope", { NULL }, 1230, "tcp" },
+ { "periscope", { NULL }, 1230, "udp" },
+ { "menandmice-lpm", { NULL }, 1231, "tcp" },
+ { "menandmice-lpm", { NULL }, 1231, "udp" },
+ { "univ-appserver", { NULL }, 1233, "tcp" },
+ { "univ-appserver", { NULL }, 1233, "udp" },
+ { "search-agent", { NULL }, 1234, "tcp" },
+ { "search-agent", { NULL }, 1234, "udp" },
+ { "mosaicsyssvc1", { NULL }, 1235, "tcp" },
+ { "mosaicsyssvc1", { NULL }, 1235, "udp" },
+ { "bvcontrol", { NULL }, 1236, "tcp" },
+ { "bvcontrol", { NULL }, 1236, "udp" },
+ { "tsdos390", { NULL }, 1237, "tcp" },
+ { "tsdos390", { NULL }, 1237, "udp" },
+ { "hacl-qs", { NULL }, 1238, "tcp" },
+ { "hacl-qs", { NULL }, 1238, "udp" },
+ { "nmsd", { NULL }, 1239, "tcp" },
+ { "nmsd", { NULL }, 1239, "udp" },
+ { "instantia", { NULL }, 1240, "tcp" },
+ { "instantia", { NULL }, 1240, "udp" },
+ { "nessus", { NULL }, 1241, "tcp" },
+ { "nessus", { NULL }, 1241, "udp" },
+ { "nmasoverip", { NULL }, 1242, "tcp" },
+ { "nmasoverip", { NULL }, 1242, "udp" },
+ { "serialgateway", { NULL }, 1243, "tcp" },
+ { "serialgateway", { NULL }, 1243, "udp" },
+ { "isbconference1", { NULL }, 1244, "tcp" },
+ { "isbconference1", { NULL }, 1244, "udp" },
+ { "isbconference2", { NULL }, 1245, "tcp" },
+ { "isbconference2", { NULL }, 1245, "udp" },
+ { "payrouter", { NULL }, 1246, "tcp" },
+ { "payrouter", { NULL }, 1246, "udp" },
+ { "visionpyramid", { NULL }, 1247, "tcp" },
+ { "visionpyramid", { NULL }, 1247, "udp" },
+ { "hermes", { NULL }, 1248, "tcp" },
+ { "hermes", { NULL }, 1248, "udp" },
+ { "mesavistaco", { NULL }, 1249, "tcp" },
+ { "mesavistaco", { NULL }, 1249, "udp" },
+ { "swldy-sias", { NULL }, 1250, "tcp" },
+ { "swldy-sias", { NULL }, 1250, "udp" },
+ { "servergraph", { NULL }, 1251, "tcp" },
+ { "servergraph", { NULL }, 1251, "udp" },
+ { "bspne-pcc", { NULL }, 1252, "tcp" },
+ { "bspne-pcc", { NULL }, 1252, "udp" },
+ { "q55-pcc", { NULL }, 1253, "tcp" },
+ { "q55-pcc", { NULL }, 1253, "udp" },
+ { "de-noc", { NULL }, 1254, "tcp" },
+ { "de-noc", { NULL }, 1254, "udp" },
+ { "de-cache-query", { NULL }, 1255, "tcp" },
+ { "de-cache-query", { NULL }, 1255, "udp" },
+ { "de-server", { NULL }, 1256, "tcp" },
+ { "de-server", { NULL }, 1256, "udp" },
+ { "shockwave2", { NULL }, 1257, "tcp" },
+ { "shockwave2", { NULL }, 1257, "udp" },
+ { "opennl", { NULL }, 1258, "tcp" },
+ { "opennl", { NULL }, 1258, "udp" },
+ { "opennl-voice", { NULL }, 1259, "tcp" },
+ { "opennl-voice", { NULL }, 1259, "udp" },
+ { "ibm-ssd", { NULL }, 1260, "tcp" },
+ { "ibm-ssd", { NULL }, 1260, "udp" },
+ { "mpshrsv", { NULL }, 1261, "tcp" },
+ { "mpshrsv", { NULL }, 1261, "udp" },
+ { "qnts-orb", { NULL }, 1262, "tcp" },
+ { "qnts-orb", { NULL }, 1262, "udp" },
+ { "dka", { NULL }, 1263, "tcp" },
+ { "dka", { NULL }, 1263, "udp" },
+ { "prat", { NULL }, 1264, "tcp" },
+ { "prat", { NULL }, 1264, "udp" },
+ { "dssiapi", { NULL }, 1265, "tcp" },
+ { "dssiapi", { NULL }, 1265, "udp" },
+ { "dellpwrappks", { NULL }, 1266, "tcp" },
+ { "dellpwrappks", { NULL }, 1266, "udp" },
+ { "epc", { NULL }, 1267, "tcp" },
+ { "epc", { NULL }, 1267, "udp" },
+ { "propel-msgsys", { NULL }, 1268, "tcp" },
+ { "propel-msgsys", { NULL }, 1268, "udp" },
+ { "watilapp", { NULL }, 1269, "tcp" },
+ { "watilapp", { NULL }, 1269, "udp" },
+ { "opsmgr", { NULL }, 1270, "tcp" },
+ { "opsmgr", { NULL }, 1270, "udp" },
+ { "excw", { NULL }, 1271, "tcp" },
+ { "excw", { NULL }, 1271, "udp" },
+ { "cspmlockmgr", { NULL }, 1272, "tcp" },
+ { "cspmlockmgr", { NULL }, 1272, "udp" },
+ { "emc-gateway", { NULL }, 1273, "tcp" },
+ { "emc-gateway", { NULL }, 1273, "udp" },
+ { "t1distproc", { NULL }, 1274, "tcp" },
+ { "t1distproc", { NULL }, 1274, "udp" },
+ { "ivcollector", { NULL }, 1275, "tcp" },
+ { "ivcollector", { NULL }, 1275, "udp" },
+ { "ivmanager", { NULL }, 1276, "tcp" },
+ { "ivmanager", { NULL }, 1276, "udp" },
+ { "miva-mqs", { NULL }, 1277, "tcp" },
+ { "miva-mqs", { NULL }, 1277, "udp" },
+ { "dellwebadmin-1", { NULL }, 1278, "tcp" },
+ { "dellwebadmin-1", { NULL }, 1278, "udp" },
+ { "dellwebadmin-2", { NULL }, 1279, "tcp" },
+ { "dellwebadmin-2", { NULL }, 1279, "udp" },
+ { "pictrography", { NULL }, 1280, "tcp" },
+ { "pictrography", { NULL }, 1280, "udp" },
+ { "healthd", { NULL }, 1281, "tcp" },
+ { "healthd", { NULL }, 1281, "udp" },
+ { "emperion", { NULL }, 1282, "tcp" },
+ { "emperion", { NULL }, 1282, "udp" },
+ { "productinfo", { NULL }, 1283, "tcp" },
+ { "productinfo", { NULL }, 1283, "udp" },
+ { "iee-qfx", { NULL }, 1284, "tcp" },
+ { "iee-qfx", { NULL }, 1284, "udp" },
+ { "neoiface", { NULL }, 1285, "tcp" },
+ { "neoiface", { NULL }, 1285, "udp" },
+ { "netuitive", { NULL }, 1286, "tcp" },
+ { "netuitive", { NULL }, 1286, "udp" },
+ { "routematch", { NULL }, 1287, "tcp" },
+ { "routematch", { NULL }, 1287, "udp" },
+ { "navbuddy", { NULL }, 1288, "tcp" },
+ { "navbuddy", { NULL }, 1288, "udp" },
+ { "jwalkserver", { NULL }, 1289, "tcp" },
+ { "jwalkserver", { NULL }, 1289, "udp" },
+ { "winjaserver", { NULL }, 1290, "tcp" },
+ { "winjaserver", { NULL }, 1290, "udp" },
+ { "seagulllms", { NULL }, 1291, "tcp" },
+ { "seagulllms", { NULL }, 1291, "udp" },
+ { "dsdn", { NULL }, 1292, "tcp" },
+ { "dsdn", { NULL }, 1292, "udp" },
+ { "pkt-krb-ipsec", { NULL }, 1293, "tcp" },
+ { "pkt-krb-ipsec", { NULL }, 1293, "udp" },
+ { "cmmdriver", { NULL }, 1294, "tcp" },
+ { "cmmdriver", { NULL }, 1294, "udp" },
+ { "ehtp", { NULL }, 1295, "tcp" },
+ { "ehtp", { NULL }, 1295, "udp" },
+ { "dproxy", { NULL }, 1296, "tcp" },
+ { "dproxy", { NULL }, 1296, "udp" },
+ { "sdproxy", { NULL }, 1297, "tcp" },
+ { "sdproxy", { NULL }, 1297, "udp" },
+ { "lpcp", { NULL }, 1298, "tcp" },
+ { "lpcp", { NULL }, 1298, "udp" },
+ { "hp-sci", { NULL }, 1299, "tcp" },
+ { "hp-sci", { NULL }, 1299, "udp" },
+ { "h323hostcallsc", { NULL }, 1300, "tcp" },
+ { "h323hostcallsc", { NULL }, 1300, "udp" },
+ { "ci3-software-1", { NULL }, 1301, "tcp" },
+ { "ci3-software-1", { NULL }, 1301, "udp" },
+ { "ci3-software-2", { NULL }, 1302, "tcp" },
+ { "ci3-software-2", { NULL }, 1302, "udp" },
+ { "sftsrv", { NULL }, 1303, "tcp" },
+ { "sftsrv", { NULL }, 1303, "udp" },
+ { "boomerang", { NULL }, 1304, "tcp" },
+ { "boomerang", { NULL }, 1304, "udp" },
+ { "pe-mike", { NULL }, 1305, "tcp" },
+ { "pe-mike", { NULL }, 1305, "udp" },
+ { "re-conn-proto", { NULL }, 1306, "tcp" },
+ { "re-conn-proto", { NULL }, 1306, "udp" },
+ { "pacmand", { NULL }, 1307, "tcp" },
+ { "pacmand", { NULL }, 1307, "udp" },
+ { "odsi", { NULL }, 1308, "tcp" },
+ { "odsi", { NULL }, 1308, "udp" },
+ { "jtag-server", { NULL }, 1309, "tcp" },
+ { "jtag-server", { NULL }, 1309, "udp" },
+ { "husky", { NULL }, 1310, "tcp" },
+ { "husky", { NULL }, 1310, "udp" },
+ { "rxmon", { NULL }, 1311, "tcp" },
+ { "rxmon", { NULL }, 1311, "udp" },
+ { "sti-envision", { NULL }, 1312, "tcp" },
+ { "sti-envision", { NULL }, 1312, "udp" },
+ { "bmc_patroldb", { NULL }, 1313, "tcp" },
+ { "bmc_patroldb", { NULL }, 1313, "udp" },
+ { "pdps", { NULL }, 1314, "tcp" },
+ { "pdps", { NULL }, 1314, "udp" },
+ { "els", { NULL }, 1315, "tcp" },
+ { "els", { NULL }, 1315, "udp" },
+ { "exbit-escp", { NULL }, 1316, "tcp" },
+ { "exbit-escp", { NULL }, 1316, "udp" },
+ { "vrts-ipcserver", { NULL }, 1317, "tcp" },
+ { "vrts-ipcserver", { NULL }, 1317, "udp" },
+ { "krb5gatekeeper", { NULL }, 1318, "tcp" },
+ { "krb5gatekeeper", { NULL }, 1318, "udp" },
+ { "amx-icsp", { NULL }, 1319, "tcp" },
+ { "amx-icsp", { NULL }, 1319, "udp" },
+ { "amx-axbnet", { NULL }, 1320, "tcp" },
+ { "amx-axbnet", { NULL }, 1320, "udp" },
+ { "pip", { NULL }, 1321, "tcp" },
+ { "pip", { NULL }, 1321, "udp" },
+ { "novation", { NULL }, 1322, "tcp" },
+ { "novation", { NULL }, 1322, "udp" },
+ { "brcd", { NULL }, 1323, "tcp" },
+ { "brcd", { NULL }, 1323, "udp" },
+ { "delta-mcp", { NULL }, 1324, "tcp" },
+ { "delta-mcp", { NULL }, 1324, "udp" },
+ { "dx-instrument", { NULL }, 1325, "tcp" },
+ { "dx-instrument", { NULL }, 1325, "udp" },
+ { "wimsic", { NULL }, 1326, "tcp" },
+ { "wimsic", { NULL }, 1326, "udp" },
+ { "ultrex", { NULL }, 1327, "tcp" },
+ { "ultrex", { NULL }, 1327, "udp" },
+ { "ewall", { NULL }, 1328, "tcp" },
+ { "ewall", { NULL }, 1328, "udp" },
+ { "netdb-export", { NULL }, 1329, "tcp" },
+ { "netdb-export", { NULL }, 1329, "udp" },
+ { "streetperfect", { NULL }, 1330, "tcp" },
+ { "streetperfect", { NULL }, 1330, "udp" },
+ { "intersan", { NULL }, 1331, "tcp" },
+ { "intersan", { NULL }, 1331, "udp" },
+ { "pcia-rxp-b", { NULL }, 1332, "tcp" },
+ { "pcia-rxp-b", { NULL }, 1332, "udp" },
+ { "passwrd-policy", { NULL }, 1333, "tcp" },
+ { "passwrd-policy", { NULL }, 1333, "udp" },
+ { "writesrv", { NULL }, 1334, "tcp" },
+ { "writesrv", { NULL }, 1334, "udp" },
+ { "digital-notary", { NULL }, 1335, "tcp" },
+ { "digital-notary", { NULL }, 1335, "udp" },
+ { "ischat", { NULL }, 1336, "tcp" },
+ { "ischat", { NULL }, 1336, "udp" },
+ { "menandmice-dns", { NULL }, 1337, "tcp" },
+ { "menandmice-dns", { NULL }, 1337, "udp" },
+ { "wmc-log-svc", { NULL }, 1338, "tcp" },
+ { "wmc-log-svc", { NULL }, 1338, "udp" },
+ { "kjtsiteserver", { NULL }, 1339, "tcp" },
+ { "kjtsiteserver", { NULL }, 1339, "udp" },
+ { "naap", { NULL }, 1340, "tcp" },
+ { "naap", { NULL }, 1340, "udp" },
+ { "qubes", { NULL }, 1341, "tcp" },
+ { "qubes", { NULL }, 1341, "udp" },
+ { "esbroker", { NULL }, 1342, "tcp" },
+ { "esbroker", { NULL }, 1342, "udp" },
+ { "re101", { NULL }, 1343, "tcp" },
+ { "re101", { NULL }, 1343, "udp" },
+ { "icap", { NULL }, 1344, "tcp" },
+ { "icap", { NULL }, 1344, "udp" },
+ { "vpjp", { NULL }, 1345, "tcp" },
+ { "vpjp", { NULL }, 1345, "udp" },
+ { "alta-ana-lm", { NULL }, 1346, "tcp" },
+ { "alta-ana-lm", { NULL }, 1346, "udp" },
+ { "bbn-mmc", { NULL }, 1347, "tcp" },
+ { "bbn-mmc", { NULL }, 1347, "udp" },
+ { "bbn-mmx", { NULL }, 1348, "tcp" },
+ { "bbn-mmx", { NULL }, 1348, "udp" },
+ { "sbook", { NULL }, 1349, "tcp" },
+ { "sbook", { NULL }, 1349, "udp" },
+ { "editbench", { NULL }, 1350, "tcp" },
+ { "editbench", { NULL }, 1350, "udp" },
+ { "equationbuilder", { NULL }, 1351, "tcp" },
+ { "equationbuilder", { NULL }, 1351, "udp" },
+ { "lotusnote", { NULL }, 1352, "tcp" },
+ { "lotusnote", { NULL }, 1352, "udp" },
+ { "relief", { NULL }, 1353, "tcp" },
+ { "relief", { NULL }, 1353, "udp" },
+ { "XSIP-network", { NULL }, 1354, "tcp" },
+ { "XSIP-network", { NULL }, 1354, "udp" },
+ { "intuitive-edge", { NULL }, 1355, "tcp" },
+ { "intuitive-edge", { NULL }, 1355, "udp" },
+ { "cuillamartin", { NULL }, 1356, "tcp" },
+ { "cuillamartin", { NULL }, 1356, "udp" },
+ { "pegboard", { NULL }, 1357, "tcp" },
+ { "pegboard", { NULL }, 1357, "udp" },
+ { "connlcli", { NULL }, 1358, "tcp" },
+ { "connlcli", { NULL }, 1358, "udp" },
+ { "ftsrv", { NULL }, 1359, "tcp" },
+ { "ftsrv", { NULL }, 1359, "udp" },
+ { "mimer", { NULL }, 1360, "tcp" },
+ { "mimer", { NULL }, 1360, "udp" },
+ { "linx", { NULL }, 1361, "tcp" },
+ { "linx", { NULL }, 1361, "udp" },
+ { "timeflies", { NULL }, 1362, "tcp" },
+ { "timeflies", { NULL }, 1362, "udp" },
+ { "ndm-requester", { NULL }, 1363, "tcp" },
+ { "ndm-requester", { NULL }, 1363, "udp" },
+ { "ndm-server", { NULL }, 1364, "tcp" },
+ { "ndm-server", { NULL }, 1364, "udp" },
+ { "adapt-sna", { NULL }, 1365, "tcp" },
+ { "adapt-sna", { NULL }, 1365, "udp" },
+ { "netware-csp", { NULL }, 1366, "tcp" },
+ { "netware-csp", { NULL }, 1366, "udp" },
+ { "dcs", { NULL }, 1367, "tcp" },
+ { "dcs", { NULL }, 1367, "udp" },
+ { "screencast", { NULL }, 1368, "tcp" },
+ { "screencast", { NULL }, 1368, "udp" },
+ { "gv-us", { NULL }, 1369, "tcp" },
+ { "gv-us", { NULL }, 1369, "udp" },
+ { "us-gv", { NULL }, 1370, "tcp" },
+ { "us-gv", { NULL }, 1370, "udp" },
+ { "fc-cli", { NULL }, 1371, "tcp" },
+ { "fc-cli", { NULL }, 1371, "udp" },
+ { "fc-ser", { NULL }, 1372, "tcp" },
+ { "fc-ser", { NULL }, 1372, "udp" },
+ { "chromagrafx", { NULL }, 1373, "tcp" },
+ { "chromagrafx", { NULL }, 1373, "udp" },
+ { "molly", { NULL }, 1374, "tcp" },
+ { "molly", { NULL }, 1374, "udp" },
+ { "bytex", { NULL }, 1375, "tcp" },
+ { "bytex", { NULL }, 1375, "udp" },
+ { "ibm-pps", { NULL }, 1376, "tcp" },
+ { "ibm-pps", { NULL }, 1376, "udp" },
+ { "cichlid", { NULL }, 1377, "tcp" },
+ { "cichlid", { NULL }, 1377, "udp" },
+ { "elan", { NULL }, 1378, "tcp" },
+ { "elan", { NULL }, 1378, "udp" },
+ { "dbreporter", { NULL }, 1379, "tcp" },
+ { "dbreporter", { NULL }, 1379, "udp" },
+ { "telesis-licman", { NULL }, 1380, "tcp" },
+ { "telesis-licman", { NULL }, 1380, "udp" },
+ { "apple-licman", { NULL }, 1381, "tcp" },
+ { "apple-licman", { NULL }, 1381, "udp" },
+ { "udt_os", { NULL }, 1382, "tcp" },
+ { "udt_os", { NULL }, 1382, "udp" },
+ { "gwha", { NULL }, 1383, "tcp" },
+ { "gwha", { NULL }, 1383, "udp" },
+ { "os-licman", { NULL }, 1384, "tcp" },
+ { "os-licman", { NULL }, 1384, "udp" },
+ { "atex_elmd", { NULL }, 1385, "tcp" },
+ { "atex_elmd", { NULL }, 1385, "udp" },
+ { "checksum", { NULL }, 1386, "tcp" },
+ { "checksum", { NULL }, 1386, "udp" },
+ { "cadsi-lm", { NULL }, 1387, "tcp" },
+ { "cadsi-lm", { NULL }, 1387, "udp" },
+ { "objective-dbc", { NULL }, 1388, "tcp" },
+ { "objective-dbc", { NULL }, 1388, "udp" },
+ { "iclpv-dm", { NULL }, 1389, "tcp" },
+ { "iclpv-dm", { NULL }, 1389, "udp" },
+ { "iclpv-sc", { NULL }, 1390, "tcp" },
+ { "iclpv-sc", { NULL }, 1390, "udp" },
+ { "iclpv-sas", { NULL }, 1391, "tcp" },
+ { "iclpv-sas", { NULL }, 1391, "udp" },
+ { "iclpv-pm", { NULL }, 1392, "tcp" },
+ { "iclpv-pm", { NULL }, 1392, "udp" },
+ { "iclpv-nls", { NULL }, 1393, "tcp" },
+ { "iclpv-nls", { NULL }, 1393, "udp" },
+ { "iclpv-nlc", { NULL }, 1394, "tcp" },
+ { "iclpv-nlc", { NULL }, 1394, "udp" },
+ { "iclpv-wsm", { NULL }, 1395, "tcp" },
+ { "iclpv-wsm", { NULL }, 1395, "udp" },
+ { "dvl-activemail", { NULL }, 1396, "tcp" },
+ { "dvl-activemail", { NULL }, 1396, "udp" },
+ { "audio-activmail", { NULL }, 1397, "tcp" },
+ { "audio-activmail", { NULL }, 1397, "udp" },
+ { "video-activmail", { NULL }, 1398, "tcp" },
+ { "video-activmail", { NULL }, 1398, "udp" },
+ { "cadkey-licman", { NULL }, 1399, "tcp" },
+ { "cadkey-licman", { NULL }, 1399, "udp" },
+ { "cadkey-tablet", { NULL }, 1400, "tcp" },
+ { "cadkey-tablet", { NULL }, 1400, "udp" },
+ { "goldleaf-licman", { NULL }, 1401, "tcp" },
+ { "goldleaf-licman", { NULL }, 1401, "udp" },
+ { "prm-sm-np", { NULL }, 1402, "tcp" },
+ { "prm-sm-np", { NULL }, 1402, "udp" },
+ { "prm-nm-np", { NULL }, 1403, "tcp" },
+ { "prm-nm-np", { NULL }, 1403, "udp" },
+ { "igi-lm", { NULL }, 1404, "tcp" },
+ { "igi-lm", { NULL }, 1404, "udp" },
+ { "ibm-res", { NULL }, 1405, "tcp" },
+ { "ibm-res", { NULL }, 1405, "udp" },
+ { "netlabs-lm", { NULL }, 1406, "tcp" },
+ { "netlabs-lm", { NULL }, 1406, "udp" },
+ { "dbsa-lm", { NULL }, 1407, "tcp" },
+ { "dbsa-lm", { NULL }, 1407, "udp" },
+ { "sophia-lm", { NULL }, 1408, "tcp" },
+ { "sophia-lm", { NULL }, 1408, "udp" },
+ { "here-lm", { NULL }, 1409, "tcp" },
+ { "here-lm", { NULL }, 1409, "udp" },
+ { "hiq", { NULL }, 1410, "tcp" },
+ { "hiq", { NULL }, 1410, "udp" },
+ { "af", { NULL }, 1411, "tcp" },
+ { "af", { NULL }, 1411, "udp" },
+ { "innosys", { NULL }, 1412, "tcp" },
+ { "innosys", { NULL }, 1412, "udp" },
+ { "innosys-acl", { NULL }, 1413, "tcp" },
+ { "innosys-acl", { NULL }, 1413, "udp" },
+ { "ibm-mqseries", { NULL }, 1414, "tcp" },
+ { "ibm-mqseries", { NULL }, 1414, "udp" },
+ { "dbstar", { NULL }, 1415, "tcp" },
+ { "dbstar", { NULL }, 1415, "udp" },
+ { "novell-lu6.2", { NULL }, 1416, "tcp" },
+ { "novell-lu6.2", { NULL }, 1416, "udp" },
+ { "timbuktu-srv1", { NULL }, 1417, "tcp" },
+ { "timbuktu-srv1", { NULL }, 1417, "udp" },
+ { "timbuktu-srv2", { NULL }, 1418, "tcp" },
+ { "timbuktu-srv2", { NULL }, 1418, "udp" },
+ { "timbuktu-srv3", { NULL }, 1419, "tcp" },
+ { "timbuktu-srv3", { NULL }, 1419, "udp" },
+ { "timbuktu-srv4", { NULL }, 1420, "tcp" },
+ { "timbuktu-srv4", { NULL }, 1420, "udp" },
+ { "gandalf-lm", { NULL }, 1421, "tcp" },
+ { "gandalf-lm", { NULL }, 1421, "udp" },
+ { "autodesk-lm", { NULL }, 1422, "tcp" },
+ { "autodesk-lm", { NULL }, 1422, "udp" },
+ { "essbase", { NULL }, 1423, "tcp" },
+ { "essbase", { NULL }, 1423, "udp" },
+ { "hybrid", { NULL }, 1424, "tcp" },
+ { "hybrid", { NULL }, 1424, "udp" },
+ { "zion-lm", { NULL }, 1425, "tcp" },
+ { "zion-lm", { NULL }, 1425, "udp" },
+ { "sais", { NULL }, 1426, "tcp" },
+ { "sais", { NULL }, 1426, "udp" },
+ { "mloadd", { NULL }, 1427, "tcp" },
+ { "mloadd", { NULL }, 1427, "udp" },
+ { "informatik-lm", { NULL }, 1428, "tcp" },
+ { "informatik-lm", { NULL }, 1428, "udp" },
+ { "nms", { NULL }, 1429, "tcp" },
+ { "nms", { NULL }, 1429, "udp" },
+ { "tpdu", { NULL }, 1430, "tcp" },
+ { "tpdu", { NULL }, 1430, "udp" },
+ { "rgtp", { NULL }, 1431, "tcp" },
+ { "rgtp", { NULL }, 1431, "udp" },
+ { "blueberry-lm", { NULL }, 1432, "tcp" },
+ { "blueberry-lm", { NULL }, 1432, "udp" },
+ { "ms-sql-s", { NULL }, 1433, "tcp" },
+ { "ms-sql-s", { NULL }, 1433, "udp" },
+ { "ms-sql-m", { NULL }, 1434, "tcp" },
+ { "ms-sql-m", { NULL }, 1434, "udp" },
+ { "ibm-cics", { NULL }, 1435, "tcp" },
+ { "ibm-cics", { NULL }, 1435, "udp" },
+ { "saism", { NULL }, 1436, "tcp" },
+ { "saism", { NULL }, 1436, "udp" },
+ { "tabula", { NULL }, 1437, "tcp" },
+ { "tabula", { NULL }, 1437, "udp" },
+ { "eicon-server", { NULL }, 1438, "tcp" },
+ { "eicon-server", { NULL }, 1438, "udp" },
+ { "eicon-x25", { NULL }, 1439, "tcp" },
+ { "eicon-x25", { NULL }, 1439, "udp" },
+ { "eicon-slp", { NULL }, 1440, "tcp" },
+ { "eicon-slp", { NULL }, 1440, "udp" },
+ { "cadis-1", { NULL }, 1441, "tcp" },
+ { "cadis-1", { NULL }, 1441, "udp" },
+ { "cadis-2", { NULL }, 1442, "tcp" },
+ { "cadis-2", { NULL }, 1442, "udp" },
+ { "ies-lm", { NULL }, 1443, "tcp" },
+ { "ies-lm", { NULL }, 1443, "udp" },
+ { "marcam-lm", { NULL }, 1444, "tcp" },
+ { "marcam-lm", { NULL }, 1444, "udp" },
+ { "proxima-lm", { NULL }, 1445, "tcp" },
+ { "proxima-lm", { NULL }, 1445, "udp" },
+ { "ora-lm", { NULL }, 1446, "tcp" },
+ { "ora-lm", { NULL }, 1446, "udp" },
+ { "apri-lm", { NULL }, 1447, "tcp" },
+ { "apri-lm", { NULL }, 1447, "udp" },
+ { "oc-lm", { NULL }, 1448, "tcp" },
+ { "oc-lm", { NULL }, 1448, "udp" },
+ { "peport", { NULL }, 1449, "tcp" },
+ { "peport", { NULL }, 1449, "udp" },
+ { "dwf", { NULL }, 1450, "tcp" },
+ { "dwf", { NULL }, 1450, "udp" },
+ { "infoman", { NULL }, 1451, "tcp" },
+ { "infoman", { NULL }, 1451, "udp" },
+ { "gtegsc-lm", { NULL }, 1452, "tcp" },
+ { "gtegsc-lm", { NULL }, 1452, "udp" },
+ { "genie-lm", { NULL }, 1453, "tcp" },
+ { "genie-lm", { NULL }, 1453, "udp" },
+ { "interhdl_elmd", { NULL }, 1454, "tcp" },
+ { "interhdl_elmd", { NULL }, 1454, "udp" },
+ { "esl-lm", { NULL }, 1455, "tcp" },
+ { "esl-lm", { NULL }, 1455, "udp" },
+ { "dca", { NULL }, 1456, "tcp" },
+ { "dca", { NULL }, 1456, "udp" },
+ { "valisys-lm", { NULL }, 1457, "tcp" },
+ { "valisys-lm", { NULL }, 1457, "udp" },
+ { "nrcabq-lm", { NULL }, 1458, "tcp" },
+ { "nrcabq-lm", { NULL }, 1458, "udp" },
+ { "proshare1", { NULL }, 1459, "tcp" },
+ { "proshare1", { NULL }, 1459, "udp" },
+ { "proshare2", { NULL }, 1460, "tcp" },
+ { "proshare2", { NULL }, 1460, "udp" },
+ { "ibm_wrless_lan", { NULL }, 1461, "tcp" },
+ { "ibm_wrless_lan", { NULL }, 1461, "udp" },
+ { "world-lm", { NULL }, 1462, "tcp" },
+ { "world-lm", { NULL }, 1462, "udp" },
+ { "nucleus", { NULL }, 1463, "tcp" },
+ { "nucleus", { NULL }, 1463, "udp" },
+ { "msl_lmd", { NULL }, 1464, "tcp" },
+ { "msl_lmd", { NULL }, 1464, "udp" },
+ { "pipes", { NULL }, 1465, "tcp" },
+ { "pipes", { NULL }, 1465, "udp" },
+ { "oceansoft-lm", { NULL }, 1466, "tcp" },
+ { "oceansoft-lm", { NULL }, 1466, "udp" },
+ { "csdmbase", { NULL }, 1467, "tcp" },
+ { "csdmbase", { NULL }, 1467, "udp" },
+ { "csdm", { NULL }, 1468, "tcp" },
+ { "csdm", { NULL }, 1468, "udp" },
+ { "aal-lm", { NULL }, 1469, "tcp" },
+ { "aal-lm", { NULL }, 1469, "udp" },
+ { "uaiact", { NULL }, 1470, "tcp" },
+ { "uaiact", { NULL }, 1470, "udp" },
+ { "csdmbase", { NULL }, 1471, "tcp" },
+ { "csdmbase", { NULL }, 1471, "udp" },
+ { "csdm", { NULL }, 1472, "tcp" },
+ { "csdm", { NULL }, 1472, "udp" },
+ { "openmath", { NULL }, 1473, "tcp" },
+ { "openmath", { NULL }, 1473, "udp" },
+ { "telefinder", { NULL }, 1474, "tcp" },
+ { "telefinder", { NULL }, 1474, "udp" },
+ { "taligent-lm", { NULL }, 1475, "tcp" },
+ { "taligent-lm", { NULL }, 1475, "udp" },
+ { "clvm-cfg", { NULL }, 1476, "tcp" },
+ { "clvm-cfg", { NULL }, 1476, "udp" },
+ { "ms-sna-server", { NULL }, 1477, "tcp" },
+ { "ms-sna-server", { NULL }, 1477, "udp" },
+ { "ms-sna-base", { NULL }, 1478, "tcp" },
+ { "ms-sna-base", { NULL }, 1478, "udp" },
+ { "dberegister", { NULL }, 1479, "tcp" },
+ { "dberegister", { NULL }, 1479, "udp" },
+ { "pacerforum", { NULL }, 1480, "tcp" },
+ { "pacerforum", { NULL }, 1480, "udp" },
+ { "airs", { NULL }, 1481, "tcp" },
+ { "airs", { NULL }, 1481, "udp" },
+ { "miteksys-lm", { NULL }, 1482, "tcp" },
+ { "miteksys-lm", { NULL }, 1482, "udp" },
+ { "afs", { NULL }, 1483, "tcp" },
+ { "afs", { NULL }, 1483, "udp" },
+ { "confluent", { NULL }, 1484, "tcp" },
+ { "confluent", { NULL }, 1484, "udp" },
+ { "lansource", { NULL }, 1485, "tcp" },
+ { "lansource", { NULL }, 1485, "udp" },
+ { "nms_topo_serv", { NULL }, 1486, "tcp" },
+ { "nms_topo_serv", { NULL }, 1486, "udp" },
+ { "localinfosrvr", { NULL }, 1487, "tcp" },
+ { "localinfosrvr", { NULL }, 1487, "udp" },
+ { "docstor", { NULL }, 1488, "tcp" },
+ { "docstor", { NULL }, 1488, "udp" },
+ { "dmdocbroker", { NULL }, 1489, "tcp" },
+ { "dmdocbroker", { NULL }, 1489, "udp" },
+ { "insitu-conf", { NULL }, 1490, "tcp" },
+ { "insitu-conf", { NULL }, 1490, "udp" },
+ { "stone-design-1", { NULL }, 1492, "tcp" },
+ { "stone-design-1", { NULL }, 1492, "udp" },
+ { "netmap_lm", { NULL }, 1493, "tcp" },
+ { "netmap_lm", { NULL }, 1493, "udp" },
+ { "ica", { NULL }, 1494, "tcp" },
+ { "ica", { NULL }, 1494, "udp" },
+ { "cvc", { NULL }, 1495, "tcp" },
+ { "cvc", { NULL }, 1495, "udp" },
+ { "liberty-lm", { NULL }, 1496, "tcp" },
+ { "liberty-lm", { NULL }, 1496, "udp" },
+ { "rfx-lm", { NULL }, 1497, "tcp" },
+ { "rfx-lm", { NULL }, 1497, "udp" },
+ { "sybase-sqlany", { NULL }, 1498, "tcp" },
+ { "sybase-sqlany", { NULL }, 1498, "udp" },
+ { "fhc", { NULL }, 1499, "tcp" },
+ { "fhc", { NULL }, 1499, "udp" },
+ { "vlsi-lm", { NULL }, 1500, "tcp" },
+ { "vlsi-lm", { NULL }, 1500, "udp" },
+ { "saiscm", { NULL }, 1501, "tcp" },
+ { "saiscm", { NULL }, 1501, "udp" },
+ { "shivadiscovery", { NULL }, 1502, "tcp" },
+ { "shivadiscovery", { NULL }, 1502, "udp" },
+ { "imtc-mcs", { NULL }, 1503, "tcp" },
+ { "imtc-mcs", { NULL }, 1503, "udp" },
+ { "evb-elm", { NULL }, 1504, "tcp" },
+ { "evb-elm", { NULL }, 1504, "udp" },
+ { "funkproxy", { NULL }, 1505, "tcp" },
+ { "funkproxy", { NULL }, 1505, "udp" },
+ { "utcd", { NULL }, 1506, "tcp" },
+ { "utcd", { NULL }, 1506, "udp" },
+ { "symplex", { NULL }, 1507, "tcp" },
+ { "symplex", { NULL }, 1507, "udp" },
+ { "diagmond", { NULL }, 1508, "tcp" },
+ { "diagmond", { NULL }, 1508, "udp" },
+ { "robcad-lm", { NULL }, 1509, "tcp" },
+ { "robcad-lm", { NULL }, 1509, "udp" },
+ { "mvx-lm", { NULL }, 1510, "tcp" },
+ { "mvx-lm", { NULL }, 1510, "udp" },
+ { "3l-l1", { NULL }, 1511, "tcp" },
+ { "3l-l1", { NULL }, 1511, "udp" },
+ { "wins", { NULL }, 1512, "tcp" },
+ { "wins", { NULL }, 1512, "udp" },
+ { "fujitsu-dtc", { NULL }, 1513, "tcp" },
+ { "fujitsu-dtc", { NULL }, 1513, "udp" },
+ { "fujitsu-dtcns", { NULL }, 1514, "tcp" },
+ { "fujitsu-dtcns", { NULL }, 1514, "udp" },
+ { "ifor-protocol", { NULL }, 1515, "tcp" },
+ { "ifor-protocol", { NULL }, 1515, "udp" },
+ { "vpad", { NULL }, 1516, "tcp" },
+ { "vpad", { NULL }, 1516, "udp" },
+ { "vpac", { NULL }, 1517, "tcp" },
+ { "vpac", { NULL }, 1517, "udp" },
+ { "vpvd", { NULL }, 1518, "tcp" },
+ { "vpvd", { NULL }, 1518, "udp" },
+ { "vpvc", { NULL }, 1519, "tcp" },
+ { "vpvc", { NULL }, 1519, "udp" },
+ { "atm-zip-office", { NULL }, 1520, "tcp" },
+ { "atm-zip-office", { NULL }, 1520, "udp" },
+ { "ncube-lm", { NULL }, 1521, "tcp" },
+ { "ncube-lm", { NULL }, 1521, "udp" },
+ { "ricardo-lm", { NULL }, 1522, "tcp" },
+ { "ricardo-lm", { NULL }, 1522, "udp" },
+ { "cichild-lm", { NULL }, 1523, "tcp" },
+ { "cichild-lm", { NULL }, 1523, "udp" },
+ { "ingreslock", { NULL }, 1524, "tcp" },
+ { "ingreslock", { NULL }, 1524, "udp" },
+ { "orasrv", { NULL }, 1525, "tcp" },
+ { "orasrv", { NULL }, 1525, "udp" },
+ { "prospero-np", { NULL }, 1525, "tcp" },
+ { "prospero-np", { NULL }, 1525, "udp" },
+ { "pdap-np", { NULL }, 1526, "tcp" },
+ { "pdap-np", { NULL }, 1526, "udp" },
+ { "tlisrv", { NULL }, 1527, "tcp" },
+ { "tlisrv", { NULL }, 1527, "udp" },
+ { "coauthor", { NULL }, 1529, "tcp" },
+ { "coauthor", { NULL }, 1529, "udp" },
+ { "rap-service", { NULL }, 1530, "tcp" },
+ { "rap-service", { NULL }, 1530, "udp" },
+ { "rap-listen", { NULL }, 1531, "tcp" },
+ { "rap-listen", { NULL }, 1531, "udp" },
+ { "miroconnect", { NULL }, 1532, "tcp" },
+ { "miroconnect", { NULL }, 1532, "udp" },
+ { "virtual-places", { NULL }, 1533, "tcp" },
+ { "virtual-places", { NULL }, 1533, "udp" },
+ { "micromuse-lm", { NULL }, 1534, "tcp" },
+ { "micromuse-lm", { NULL }, 1534, "udp" },
+ { "ampr-info", { NULL }, 1535, "tcp" },
+ { "ampr-info", { NULL }, 1535, "udp" },
+ { "ampr-inter", { NULL }, 1536, "tcp" },
+ { "ampr-inter", { NULL }, 1536, "udp" },
+ { "sdsc-lm", { NULL }, 1537, "tcp" },
+ { "sdsc-lm", { NULL }, 1537, "udp" },
+ { "3ds-lm", { NULL }, 1538, "tcp" },
+ { "3ds-lm", { NULL }, 1538, "udp" },
+ { "intellistor-lm", { NULL }, 1539, "tcp" },
+ { "intellistor-lm", { NULL }, 1539, "udp" },
+ { "rds", { NULL }, 1540, "tcp" },
+ { "rds", { NULL }, 1540, "udp" },
+ { "rds2", { NULL }, 1541, "tcp" },
+ { "rds2", { NULL }, 1541, "udp" },
+ { "gridgen-elmd", { NULL }, 1542, "tcp" },
+ { "gridgen-elmd", { NULL }, 1542, "udp" },
+ { "simba-cs", { NULL }, 1543, "tcp" },
+ { "simba-cs", { NULL }, 1543, "udp" },
+ { "aspeclmd", { NULL }, 1544, "tcp" },
+ { "aspeclmd", { NULL }, 1544, "udp" },
+ { "vistium-share", { NULL }, 1545, "tcp" },
+ { "vistium-share", { NULL }, 1545, "udp" },
+ { "abbaccuray", { NULL }, 1546, "tcp" },
+ { "abbaccuray", { NULL }, 1546, "udp" },
+ { "laplink", { NULL }, 1547, "tcp" },
+ { "laplink", { NULL }, 1547, "udp" },
+ { "axon-lm", { NULL }, 1548, "tcp" },
+ { "axon-lm", { NULL }, 1548, "udp" },
+ { "shivahose", { NULL }, 1549, "tcp" },
+ { "shivasound", { NULL }, 1549, "udp" },
+ { "3m-image-lm", { NULL }, 1550, "tcp" },
+ { "3m-image-lm", { NULL }, 1550, "udp" },
+ { "hecmtl-db", { NULL }, 1551, "tcp" },
+ { "hecmtl-db", { NULL }, 1551, "udp" },
+ { "pciarray", { NULL }, 1552, "tcp" },
+ { "pciarray", { NULL }, 1552, "udp" },
+ { "sna-cs", { NULL }, 1553, "tcp" },
+ { "sna-cs", { NULL }, 1553, "udp" },
+ { "caci-lm", { NULL }, 1554, "tcp" },
+ { "caci-lm", { NULL }, 1554, "udp" },
+ { "livelan", { NULL }, 1555, "tcp" },
+ { "livelan", { NULL }, 1555, "udp" },
+ { "veritas_pbx", { NULL }, 1556, "tcp" },
+ { "veritas_pbx", { NULL }, 1556, "udp" },
+ { "arbortext-lm", { NULL }, 1557, "tcp" },
+ { "arbortext-lm", { NULL }, 1557, "udp" },
+ { "xingmpeg", { NULL }, 1558, "tcp" },
+ { "xingmpeg", { NULL }, 1558, "udp" },
+ { "web2host", { NULL }, 1559, "tcp" },
+ { "web2host", { NULL }, 1559, "udp" },
+ { "asci-val", { NULL }, 1560, "tcp" },
+ { "asci-val", { NULL }, 1560, "udp" },
+ { "facilityview", { NULL }, 1561, "tcp" },
+ { "facilityview", { NULL }, 1561, "udp" },
+ { "pconnectmgr", { NULL }, 1562, "tcp" },
+ { "pconnectmgr", { NULL }, 1562, "udp" },
+ { "cadabra-lm", { NULL }, 1563, "tcp" },
+ { "cadabra-lm", { NULL }, 1563, "udp" },
+ { "pay-per-view", { NULL }, 1564, "tcp" },
+ { "pay-per-view", { NULL }, 1564, "udp" },
+ { "winddlb", { NULL }, 1565, "tcp" },
+ { "winddlb", { NULL }, 1565, "udp" },
+ { "corelvideo", { NULL }, 1566, "tcp" },
+ { "corelvideo", { NULL }, 1566, "udp" },
+ { "jlicelmd", { NULL }, 1567, "tcp" },
+ { "jlicelmd", { NULL }, 1567, "udp" },
+ { "tsspmap", { NULL }, 1568, "tcp" },
+ { "tsspmap", { NULL }, 1568, "udp" },
+ { "ets", { NULL }, 1569, "tcp" },
+ { "ets", { NULL }, 1569, "udp" },
+ { "orbixd", { NULL }, 1570, "tcp" },
+ { "orbixd", { NULL }, 1570, "udp" },
+ { "rdb-dbs-disp", { NULL }, 1571, "tcp" },
+ { "rdb-dbs-disp", { NULL }, 1571, "udp" },
+ { "chip-lm", { NULL }, 1572, "tcp" },
+ { "chip-lm", { NULL }, 1572, "udp" },
+ { "itscomm-ns", { NULL }, 1573, "tcp" },
+ { "itscomm-ns", { NULL }, 1573, "udp" },
+ { "mvel-lm", { NULL }, 1574, "tcp" },
+ { "mvel-lm", { NULL }, 1574, "udp" },
+ { "oraclenames", { NULL }, 1575, "tcp" },
+ { "oraclenames", { NULL }, 1575, "udp" },
+ { "moldflow-lm", { NULL }, 1576, "tcp" },
+ { "moldflow-lm", { NULL }, 1576, "udp" },
+ { "hypercube-lm", { NULL }, 1577, "tcp" },
+ { "hypercube-lm", { NULL }, 1577, "udp" },
+ { "jacobus-lm", { NULL }, 1578, "tcp" },
+ { "jacobus-lm", { NULL }, 1578, "udp" },
+ { "ioc-sea-lm", { NULL }, 1579, "tcp" },
+ { "ioc-sea-lm", { NULL }, 1579, "udp" },
+ { "tn-tl-r1", { NULL }, 1580, "tcp" },
+ { "tn-tl-r2", { NULL }, 1580, "udp" },
+ { "mil-2045-47001", { NULL }, 1581, "tcp" },
+ { "mil-2045-47001", { NULL }, 1581, "udp" },
+ { "msims", { NULL }, 1582, "tcp" },
+ { "msims", { NULL }, 1582, "udp" },
+ { "simbaexpress", { NULL }, 1583, "tcp" },
+ { "simbaexpress", { NULL }, 1583, "udp" },
+ { "tn-tl-fd2", { NULL }, 1584, "tcp" },
+ { "tn-tl-fd2", { NULL }, 1584, "udp" },
+ { "intv", { NULL }, 1585, "tcp" },
+ { "intv", { NULL }, 1585, "udp" },
+ { "ibm-abtact", { NULL }, 1586, "tcp" },
+ { "ibm-abtact", { NULL }, 1586, "udp" },
+ { "pra_elmd", { NULL }, 1587, "tcp" },
+ { "pra_elmd", { NULL }, 1587, "udp" },
+ { "triquest-lm", { NULL }, 1588, "tcp" },
+ { "triquest-lm", { NULL }, 1588, "udp" },
+ { "vqp", { NULL }, 1589, "tcp" },
+ { "vqp", { NULL }, 1589, "udp" },
+ { "gemini-lm", { NULL }, 1590, "tcp" },
+ { "gemini-lm", { NULL }, 1590, "udp" },
+ { "ncpm-pm", { NULL }, 1591, "tcp" },
+ { "ncpm-pm", { NULL }, 1591, "udp" },
+ { "commonspace", { NULL }, 1592, "tcp" },
+ { "commonspace", { NULL }, 1592, "udp" },
+ { "mainsoft-lm", { NULL }, 1593, "tcp" },
+ { "mainsoft-lm", { NULL }, 1593, "udp" },
+ { "sixtrak", { NULL }, 1594, "tcp" },
+ { "sixtrak", { NULL }, 1594, "udp" },
+ { "radio", { NULL }, 1595, "tcp" },
+ { "radio", { NULL }, 1595, "udp" },
+ { "radio-sm", { NULL }, 1596, "tcp" },
+ { "radio-bc", { NULL }, 1596, "udp" },
+ { "orbplus-iiop", { NULL }, 1597, "tcp" },
+ { "orbplus-iiop", { NULL }, 1597, "udp" },
+ { "picknfs", { NULL }, 1598, "tcp" },
+ { "picknfs", { NULL }, 1598, "udp" },
+ { "simbaservices", { NULL }, 1599, "tcp" },
+ { "simbaservices", { NULL }, 1599, "udp" },
+ { "issd", { NULL }, 1600, "tcp" },
+ { "issd", { NULL }, 1600, "udp" },
+ { "aas", { NULL }, 1601, "tcp" },
+ { "aas", { NULL }, 1601, "udp" },
+ { "inspect", { NULL }, 1602, "tcp" },
+ { "inspect", { NULL }, 1602, "udp" },
+ { "picodbc", { NULL }, 1603, "tcp" },
+ { "picodbc", { NULL }, 1603, "udp" },
+ { "icabrowser", { NULL }, 1604, "tcp" },
+ { "icabrowser", { NULL }, 1604, "udp" },
+ { "slp", { NULL }, 1605, "tcp" },
+ { "slp", { NULL }, 1605, "udp" },
+ { "slm-api", { NULL }, 1606, "tcp" },
+ { "slm-api", { NULL }, 1606, "udp" },
+ { "stt", { NULL }, 1607, "tcp" },
+ { "stt", { NULL }, 1607, "udp" },
+ { "smart-lm", { NULL }, 1608, "tcp" },
+ { "smart-lm", { NULL }, 1608, "udp" },
+ { "isysg-lm", { NULL }, 1609, "tcp" },
+ { "isysg-lm", { NULL }, 1609, "udp" },
+ { "taurus-wh", { NULL }, 1610, "tcp" },
+ { "taurus-wh", { NULL }, 1610, "udp" },
+ { "ill", { NULL }, 1611, "tcp" },
+ { "ill", { NULL }, 1611, "udp" },
+ { "netbill-trans", { NULL }, 1612, "tcp" },
+ { "netbill-trans", { NULL }, 1612, "udp" },
+ { "netbill-keyrep", { NULL }, 1613, "tcp" },
+ { "netbill-keyrep", { NULL }, 1613, "udp" },
+ { "netbill-cred", { NULL }, 1614, "tcp" },
+ { "netbill-cred", { NULL }, 1614, "udp" },
+ { "netbill-auth", { NULL }, 1615, "tcp" },
+ { "netbill-auth", { NULL }, 1615, "udp" },
+ { "netbill-prod", { NULL }, 1616, "tcp" },
+ { "netbill-prod", { NULL }, 1616, "udp" },
+ { "nimrod-agent", { NULL }, 1617, "tcp" },
+ { "nimrod-agent", { NULL }, 1617, "udp" },
+ { "skytelnet", { NULL }, 1618, "tcp" },
+ { "skytelnet", { NULL }, 1618, "udp" },
+ { "xs-openstorage", { NULL }, 1619, "tcp" },
+ { "xs-openstorage", { NULL }, 1619, "udp" },
+ { "faxportwinport", { NULL }, 1620, "tcp" },
+ { "faxportwinport", { NULL }, 1620, "udp" },
+ { "softdataphone", { NULL }, 1621, "tcp" },
+ { "softdataphone", { NULL }, 1621, "udp" },
+ { "ontime", { NULL }, 1622, "tcp" },
+ { "ontime", { NULL }, 1622, "udp" },
+ { "jaleosnd", { NULL }, 1623, "tcp" },
+ { "jaleosnd", { NULL }, 1623, "udp" },
+ { "udp-sr-port", { NULL }, 1624, "tcp" },
+ { "udp-sr-port", { NULL }, 1624, "udp" },
+ { "svs-omagent", { NULL }, 1625, "tcp" },
+ { "svs-omagent", { NULL }, 1625, "udp" },
+ { "shockwave", { NULL }, 1626, "tcp" },
+ { "shockwave", { NULL }, 1626, "udp" },
+ { "t128-gateway", { NULL }, 1627, "tcp" },
+ { "t128-gateway", { NULL }, 1627, "udp" },
+ { "lontalk-norm", { NULL }, 1628, "tcp" },
+ { "lontalk-norm", { NULL }, 1628, "udp" },
+ { "lontalk-urgnt", { NULL }, 1629, "tcp" },
+ { "lontalk-urgnt", { NULL }, 1629, "udp" },
+ { "oraclenet8cman", { NULL }, 1630, "tcp" },
+ { "oraclenet8cman", { NULL }, 1630, "udp" },
+ { "visitview", { NULL }, 1631, "tcp" },
+ { "visitview", { NULL }, 1631, "udp" },
+ { "pammratc", { NULL }, 1632, "tcp" },
+ { "pammratc", { NULL }, 1632, "udp" },
+ { "pammrpc", { NULL }, 1633, "tcp" },
+ { "pammrpc", { NULL }, 1633, "udp" },
+ { "loaprobe", { NULL }, 1634, "tcp" },
+ { "loaprobe", { NULL }, 1634, "udp" },
+ { "edb-server1", { NULL }, 1635, "tcp" },
+ { "edb-server1", { NULL }, 1635, "udp" },
+ { "isdc", { NULL }, 1636, "tcp" },
+ { "isdc", { NULL }, 1636, "udp" },
+ { "islc", { NULL }, 1637, "tcp" },
+ { "islc", { NULL }, 1637, "udp" },
+ { "ismc", { NULL }, 1638, "tcp" },
+ { "ismc", { NULL }, 1638, "udp" },
+ { "cert-initiator", { NULL }, 1639, "tcp" },
+ { "cert-initiator", { NULL }, 1639, "udp" },
+ { "cert-responder", { NULL }, 1640, "tcp" },
+ { "cert-responder", { NULL }, 1640, "udp" },
+ { "invision", { NULL }, 1641, "tcp" },
+ { "invision", { NULL }, 1641, "udp" },
+ { "isis-am", { NULL }, 1642, "tcp" },
+ { "isis-am", { NULL }, 1642, "udp" },
+ { "isis-ambc", { NULL }, 1643, "tcp" },
+ { "isis-ambc", { NULL }, 1643, "udp" },
+ { "saiseh", { NULL }, 1644, "tcp" },
+ { "sightline", { NULL }, 1645, "tcp" },
+ { "sightline", { NULL }, 1645, "udp" },
+ { "sa-msg-port", { NULL }, 1646, "tcp" },
+ { "sa-msg-port", { NULL }, 1646, "udp" },
+ { "rsap", { NULL }, 1647, "tcp" },
+ { "rsap", { NULL }, 1647, "udp" },
+ { "concurrent-lm", { NULL }, 1648, "tcp" },
+ { "concurrent-lm", { NULL }, 1648, "udp" },
+ { "kermit", { NULL }, 1649, "tcp" },
+ { "kermit", { NULL }, 1649, "udp" },
+ { "nkd", { NULL }, 1650, "tcp" },
+ { "nkd", { NULL }, 1650, "udp" },
+ { "shiva_confsrvr", { NULL }, 1651, "tcp" },
+ { "shiva_confsrvr", { NULL }, 1651, "udp" },
+ { "xnmp", { NULL }, 1652, "tcp" },
+ { "xnmp", { NULL }, 1652, "udp" },
+ { "alphatech-lm", { NULL }, 1653, "tcp" },
+ { "alphatech-lm", { NULL }, 1653, "udp" },
+ { "stargatealerts", { NULL }, 1654, "tcp" },
+ { "stargatealerts", { NULL }, 1654, "udp" },
+ { "dec-mbadmin", { NULL }, 1655, "tcp" },
+ { "dec-mbadmin", { NULL }, 1655, "udp" },
+ { "dec-mbadmin-h", { NULL }, 1656, "tcp" },
+ { "dec-mbadmin-h", { NULL }, 1656, "udp" },
+ { "fujitsu-mmpdc", { NULL }, 1657, "tcp" },
+ { "fujitsu-mmpdc", { NULL }, 1657, "udp" },
+ { "sixnetudr", { NULL }, 1658, "tcp" },
+ { "sixnetudr", { NULL }, 1658, "udp" },
+ { "sg-lm", { NULL }, 1659, "tcp" },
+ { "sg-lm", { NULL }, 1659, "udp" },
+ { "skip-mc-gikreq", { NULL }, 1660, "tcp" },
+ { "skip-mc-gikreq", { NULL }, 1660, "udp" },
+ { "netview-aix-1", { NULL }, 1661, "tcp" },
+ { "netview-aix-1", { NULL }, 1661, "udp" },
+ { "netview-aix-2", { NULL }, 1662, "tcp" },
+ { "netview-aix-2", { NULL }, 1662, "udp" },
+ { "netview-aix-3", { NULL }, 1663, "tcp" },
+ { "netview-aix-3", { NULL }, 1663, "udp" },
+ { "netview-aix-4", { NULL }, 1664, "tcp" },
+ { "netview-aix-4", { NULL }, 1664, "udp" },
+ { "netview-aix-5", { NULL }, 1665, "tcp" },
+ { "netview-aix-5", { NULL }, 1665, "udp" },
+ { "netview-aix-6", { NULL }, 1666, "tcp" },
+ { "netview-aix-6", { NULL }, 1666, "udp" },
+ { "netview-aix-7", { NULL }, 1667, "tcp" },
+ { "netview-aix-7", { NULL }, 1667, "udp" },
+ { "netview-aix-8", { NULL }, 1668, "tcp" },
+ { "netview-aix-8", { NULL }, 1668, "udp" },
+ { "netview-aix-9", { NULL }, 1669, "tcp" },
+ { "netview-aix-9", { NULL }, 1669, "udp" },
+ { "netview-aix-10", { NULL }, 1670, "tcp" },
+ { "netview-aix-10", { NULL }, 1670, "udp" },
+ { "netview-aix-11", { NULL }, 1671, "tcp" },
+ { "netview-aix-11", { NULL }, 1671, "udp" },
+ { "netview-aix-12", { NULL }, 1672, "tcp" },
+ { "netview-aix-12", { NULL }, 1672, "udp" },
+ { "proshare-mc-1", { NULL }, 1673, "tcp" },
+ { "proshare-mc-1", { NULL }, 1673, "udp" },
+ { "proshare-mc-2", { NULL }, 1674, "tcp" },
+ { "proshare-mc-2", { NULL }, 1674, "udp" },
+ { "pdp", { NULL }, 1675, "tcp" },
+ { "pdp", { NULL }, 1675, "udp" },
+ { "netcomm1", { NULL }, 1676, "tcp" },
+ { "netcomm2", { NULL }, 1676, "udp" },
+ { "groupwise", { NULL }, 1677, "tcp" },
+ { "groupwise", { NULL }, 1677, "udp" },
+ { "prolink", { NULL }, 1678, "tcp" },
+ { "prolink", { NULL }, 1678, "udp" },
+ { "darcorp-lm", { NULL }, 1679, "tcp" },
+ { "darcorp-lm", { NULL }, 1679, "udp" },
+ { "microcom-sbp", { NULL }, 1680, "tcp" },
+ { "microcom-sbp", { NULL }, 1680, "udp" },
+ { "sd-elmd", { NULL }, 1681, "tcp" },
+ { "sd-elmd", { NULL }, 1681, "udp" },
+ { "lanyon-lantern", { NULL }, 1682, "tcp" },
+ { "lanyon-lantern", { NULL }, 1682, "udp" },
+ { "ncpm-hip", { NULL }, 1683, "tcp" },
+ { "ncpm-hip", { NULL }, 1683, "udp" },
+ { "snaresecure", { NULL }, 1684, "tcp" },
+ { "snaresecure", { NULL }, 1684, "udp" },
+ { "n2nremote", { NULL }, 1685, "tcp" },
+ { "n2nremote", { NULL }, 1685, "udp" },
+ { "cvmon", { NULL }, 1686, "tcp" },
+ { "cvmon", { NULL }, 1686, "udp" },
+ { "nsjtp-ctrl", { NULL }, 1687, "tcp" },
+ { "nsjtp-ctrl", { NULL }, 1687, "udp" },
+ { "nsjtp-data", { NULL }, 1688, "tcp" },
+ { "nsjtp-data", { NULL }, 1688, "udp" },
+ { "firefox", { NULL }, 1689, "tcp" },
+ { "firefox", { NULL }, 1689, "udp" },
+ { "ng-umds", { NULL }, 1690, "tcp" },
+ { "ng-umds", { NULL }, 1690, "udp" },
+ { "empire-empuma", { NULL }, 1691, "tcp" },
+ { "empire-empuma", { NULL }, 1691, "udp" },
+ { "sstsys-lm", { NULL }, 1692, "tcp" },
+ { "sstsys-lm", { NULL }, 1692, "udp" },
+ { "rrirtr", { NULL }, 1693, "tcp" },
+ { "rrirtr", { NULL }, 1693, "udp" },
+ { "rrimwm", { NULL }, 1694, "tcp" },
+ { "rrimwm", { NULL }, 1694, "udp" },
+ { "rrilwm", { NULL }, 1695, "tcp" },
+ { "rrilwm", { NULL }, 1695, "udp" },
+ { "rrifmm", { NULL }, 1696, "tcp" },
+ { "rrifmm", { NULL }, 1696, "udp" },
+ { "rrisat", { NULL }, 1697, "tcp" },
+ { "rrisat", { NULL }, 1697, "udp" },
+ { "rsvp-encap-1", { NULL }, 1698, "tcp" },
+ { "rsvp-encap-1", { NULL }, 1698, "udp" },
+ { "rsvp-encap-2", { NULL }, 1699, "tcp" },
+ { "rsvp-encap-2", { NULL }, 1699, "udp" },
+ { "mps-raft", { NULL }, 1700, "tcp" },
+ { "mps-raft", { NULL }, 1700, "udp" },
+ { "l2f", { NULL }, 1701, "tcp" },
+ { "l2f", { NULL }, 1701, "udp" },
+ { "l2tp", { NULL }, 1701, "tcp" },
+ { "l2tp", { NULL }, 1701, "udp" },
+ { "deskshare", { NULL }, 1702, "tcp" },
+ { "deskshare", { NULL }, 1702, "udp" },
+ { "hb-engine", { NULL }, 1703, "tcp" },
+ { "hb-engine", { NULL }, 1703, "udp" },
+ { "bcs-broker", { NULL }, 1704, "tcp" },
+ { "bcs-broker", { NULL }, 1704, "udp" },
+ { "slingshot", { NULL }, 1705, "tcp" },
+ { "slingshot", { NULL }, 1705, "udp" },
+ { "jetform", { NULL }, 1706, "tcp" },
+ { "jetform", { NULL }, 1706, "udp" },
+ { "vdmplay", { NULL }, 1707, "tcp" },
+ { "vdmplay", { NULL }, 1707, "udp" },
+ { "gat-lmd", { NULL }, 1708, "tcp" },
+ { "gat-lmd", { NULL }, 1708, "udp" },
+ { "centra", { NULL }, 1709, "tcp" },
+ { "centra", { NULL }, 1709, "udp" },
+ { "impera", { NULL }, 1710, "tcp" },
+ { "impera", { NULL }, 1710, "udp" },
+ { "pptconference", { NULL }, 1711, "tcp" },
+ { "pptconference", { NULL }, 1711, "udp" },
+ { "registrar", { NULL }, 1712, "tcp" },
+ { "registrar", { NULL }, 1712, "udp" },
+ { "conferencetalk", { NULL }, 1713, "tcp" },
+ { "conferencetalk", { NULL }, 1713, "udp" },
+ { "sesi-lm", { NULL }, 1714, "tcp" },
+ { "sesi-lm", { NULL }, 1714, "udp" },
+ { "houdini-lm", { NULL }, 1715, "tcp" },
+ { "houdini-lm", { NULL }, 1715, "udp" },
+ { "xmsg", { NULL }, 1716, "tcp" },
+ { "xmsg", { NULL }, 1716, "udp" },
+ { "fj-hdnet", { NULL }, 1717, "tcp" },
+ { "fj-hdnet", { NULL }, 1717, "udp" },
+ { "h323gatedisc", { NULL }, 1718, "tcp" },
+ { "h323gatedisc", { NULL }, 1718, "udp" },
+ { "h323gatestat", { NULL }, 1719, "tcp" },
+ { "h323gatestat", { NULL }, 1719, "udp" },
+ { "h323hostcall", { NULL }, 1720, "tcp" },
+ { "h323hostcall", { NULL }, 1720, "udp" },
+ { "caicci", { NULL }, 1721, "tcp" },
+ { "caicci", { NULL }, 1721, "udp" },
+ { "hks-lm", { NULL }, 1722, "tcp" },
+ { "hks-lm", { NULL }, 1722, "udp" },
+ { "pptp", { NULL }, 1723, "tcp" },
+ { "pptp", { NULL }, 1723, "udp" },
+ { "csbphonemaster", { NULL }, 1724, "tcp" },
+ { "csbphonemaster", { NULL }, 1724, "udp" },
+ { "iden-ralp", { NULL }, 1725, "tcp" },
+ { "iden-ralp", { NULL }, 1725, "udp" },
+ { "iberiagames", { NULL }, 1726, "tcp" },
+ { "iberiagames", { NULL }, 1726, "udp" },
+ { "winddx", { NULL }, 1727, "tcp" },
+ { "winddx", { NULL }, 1727, "udp" },
+ { "telindus", { NULL }, 1728, "tcp" },
+ { "telindus", { NULL }, 1728, "udp" },
+ { "citynl", { NULL }, 1729, "tcp" },
+ { "citynl", { NULL }, 1729, "udp" },
+ { "roketz", { NULL }, 1730, "tcp" },
+ { "roketz", { NULL }, 1730, "udp" },
+ { "msiccp", { NULL }, 1731, "tcp" },
+ { "msiccp", { NULL }, 1731, "udp" },
+ { "proxim", { NULL }, 1732, "tcp" },
+ { "proxim", { NULL }, 1732, "udp" },
+ { "siipat", { NULL }, 1733, "tcp" },
+ { "siipat", { NULL }, 1733, "udp" },
+ { "cambertx-lm", { NULL }, 1734, "tcp" },
+ { "cambertx-lm", { NULL }, 1734, "udp" },
+ { "privatechat", { NULL }, 1735, "tcp" },
+ { "privatechat", { NULL }, 1735, "udp" },
+ { "street-stream", { NULL }, 1736, "tcp" },
+ { "street-stream", { NULL }, 1736, "udp" },
+ { "ultimad", { NULL }, 1737, "tcp" },
+ { "ultimad", { NULL }, 1737, "udp" },
+ { "gamegen1", { NULL }, 1738, "tcp" },
+ { "gamegen1", { NULL }, 1738, "udp" },
+ { "webaccess", { NULL }, 1739, "tcp" },
+ { "webaccess", { NULL }, 1739, "udp" },
+ { "encore", { NULL }, 1740, "tcp" },
+ { "encore", { NULL }, 1740, "udp" },
+ { "cisco-net-mgmt", { NULL }, 1741, "tcp" },
+ { "cisco-net-mgmt", { NULL }, 1741, "udp" },
+ { "3Com-nsd", { NULL }, 1742, "tcp" },
+ { "3Com-nsd", { NULL }, 1742, "udp" },
+ { "cinegrfx-lm", { NULL }, 1743, "tcp" },
+ { "cinegrfx-lm", { NULL }, 1743, "udp" },
+ { "ncpm-ft", { NULL }, 1744, "tcp" },
+ { "ncpm-ft", { NULL }, 1744, "udp" },
+ { "remote-winsock", { NULL }, 1745, "tcp" },
+ { "remote-winsock", { NULL }, 1745, "udp" },
+ { "ftrapid-1", { NULL }, 1746, "tcp" },
+ { "ftrapid-1", { NULL }, 1746, "udp" },
+ { "ftrapid-2", { NULL }, 1747, "tcp" },
+ { "ftrapid-2", { NULL }, 1747, "udp" },
+ { "oracle-em1", { NULL }, 1748, "tcp" },
+ { "oracle-em1", { NULL }, 1748, "udp" },
+ { "aspen-services", { NULL }, 1749, "tcp" },
+ { "aspen-services", { NULL }, 1749, "udp" },
+ { "sslp", { NULL }, 1750, "tcp" },
+ { "sslp", { NULL }, 1750, "udp" },
+ { "swiftnet", { NULL }, 1751, "tcp" },
+ { "swiftnet", { NULL }, 1751, "udp" },
+ { "lofr-lm", { NULL }, 1752, "tcp" },
+ { "lofr-lm", { NULL }, 1752, "udp" },
+ { "oracle-em2", { NULL }, 1754, "tcp" },
+ { "oracle-em2", { NULL }, 1754, "udp" },
+ { "ms-streaming", { NULL }, 1755, "tcp" },
+ { "ms-streaming", { NULL }, 1755, "udp" },
+ { "capfast-lmd", { NULL }, 1756, "tcp" },
+ { "capfast-lmd", { NULL }, 1756, "udp" },
+ { "cnhrp", { NULL }, 1757, "tcp" },
+ { "cnhrp", { NULL }, 1757, "udp" },
+ { "tftp-mcast", { NULL }, 1758, "tcp" },
+ { "tftp-mcast", { NULL }, 1758, "udp" },
+ { "spss-lm", { NULL }, 1759, "tcp" },
+ { "spss-lm", { NULL }, 1759, "udp" },
+ { "www-ldap-gw", { NULL }, 1760, "tcp" },
+ { "www-ldap-gw", { NULL }, 1760, "udp" },
+ { "cft-0", { NULL }, 1761, "tcp" },
+ { "cft-0", { NULL }, 1761, "udp" },
+ { "cft-1", { NULL }, 1762, "tcp" },
+ { "cft-1", { NULL }, 1762, "udp" },
+ { "cft-2", { NULL }, 1763, "tcp" },
+ { "cft-2", { NULL }, 1763, "udp" },
+ { "cft-3", { NULL }, 1764, "tcp" },
+ { "cft-3", { NULL }, 1764, "udp" },
+ { "cft-4", { NULL }, 1765, "tcp" },
+ { "cft-4", { NULL }, 1765, "udp" },
+ { "cft-5", { NULL }, 1766, "tcp" },
+ { "cft-5", { NULL }, 1766, "udp" },
+ { "cft-6", { NULL }, 1767, "tcp" },
+ { "cft-6", { NULL }, 1767, "udp" },
+ { "cft-7", { NULL }, 1768, "tcp" },
+ { "cft-7", { NULL }, 1768, "udp" },
+ { "bmc-net-adm", { NULL }, 1769, "tcp" },
+ { "bmc-net-adm", { NULL }, 1769, "udp" },
+ { "bmc-net-svc", { NULL }, 1770, "tcp" },
+ { "bmc-net-svc", { NULL }, 1770, "udp" },
+ { "vaultbase", { NULL }, 1771, "tcp" },
+ { "vaultbase", { NULL }, 1771, "udp" },
+ { "essweb-gw", { NULL }, 1772, "tcp" },
+ { "essweb-gw", { NULL }, 1772, "udp" },
+ { "kmscontrol", { NULL }, 1773, "tcp" },
+ { "kmscontrol", { NULL }, 1773, "udp" },
+ { "global-dtserv", { NULL }, 1774, "tcp" },
+ { "global-dtserv", { NULL }, 1774, "udp" },
+ { "femis", { NULL }, 1776, "tcp" },
+ { "femis", { NULL }, 1776, "udp" },
+ { "powerguardian", { NULL }, 1777, "tcp" },
+ { "powerguardian", { NULL }, 1777, "udp" },
+ { "prodigy-intrnet", { NULL }, 1778, "tcp" },
+ { "prodigy-intrnet", { NULL }, 1778, "udp" },
+ { "pharmasoft", { NULL }, 1779, "tcp" },
+ { "pharmasoft", { NULL }, 1779, "udp" },
+ { "dpkeyserv", { NULL }, 1780, "tcp" },
+ { "dpkeyserv", { NULL }, 1780, "udp" },
+ { "answersoft-lm", { NULL }, 1781, "tcp" },
+ { "answersoft-lm", { NULL }, 1781, "udp" },
+ { "hp-hcip", { NULL }, 1782, "tcp" },
+ { "hp-hcip", { NULL }, 1782, "udp" },
+ { "finle-lm", { NULL }, 1784, "tcp" },
+ { "finle-lm", { NULL }, 1784, "udp" },
+ { "windlm", { NULL }, 1785, "tcp" },
+ { "windlm", { NULL }, 1785, "udp" },
+ { "funk-logger", { NULL }, 1786, "tcp" },
+ { "funk-logger", { NULL }, 1786, "udp" },
+ { "funk-license", { NULL }, 1787, "tcp" },
+ { "funk-license", { NULL }, 1787, "udp" },
+ { "psmond", { NULL }, 1788, "tcp" },
+ { "psmond", { NULL }, 1788, "udp" },
+ { "hello", { NULL }, 1789, "tcp" },
+ { "hello", { NULL }, 1789, "udp" },
+ { "nmsp", { NULL }, 1790, "tcp" },
+ { "nmsp", { NULL }, 1790, "udp" },
+ { "ea1", { NULL }, 1791, "tcp" },
+ { "ea1", { NULL }, 1791, "udp" },
+ { "ibm-dt-2", { NULL }, 1792, "tcp" },
+ { "ibm-dt-2", { NULL }, 1792, "udp" },
+ { "rsc-robot", { NULL }, 1793, "tcp" },
+ { "rsc-robot", { NULL }, 1793, "udp" },
+ { "cera-bcm", { NULL }, 1794, "tcp" },
+ { "cera-bcm", { NULL }, 1794, "udp" },
+ { "dpi-proxy", { NULL }, 1795, "tcp" },
+ { "dpi-proxy", { NULL }, 1795, "udp" },
+ { "vocaltec-admin", { NULL }, 1796, "tcp" },
+ { "vocaltec-admin", { NULL }, 1796, "udp" },
+ { "uma", { NULL }, 1797, "tcp" },
+ { "uma", { NULL }, 1797, "udp" },
+ { "etp", { NULL }, 1798, "tcp" },
+ { "etp", { NULL }, 1798, "udp" },
+ { "netrisk", { NULL }, 1799, "tcp" },
+ { "netrisk", { NULL }, 1799, "udp" },
+ { "ansys-lm", { NULL }, 1800, "tcp" },
+ { "ansys-lm", { NULL }, 1800, "udp" },
+ { "msmq", { NULL }, 1801, "tcp" },
+ { "msmq", { NULL }, 1801, "udp" },
+ { "concomp1", { NULL }, 1802, "tcp" },
+ { "concomp1", { NULL }, 1802, "udp" },
+ { "hp-hcip-gwy", { NULL }, 1803, "tcp" },
+ { "hp-hcip-gwy", { NULL }, 1803, "udp" },
+ { "enl", { NULL }, 1804, "tcp" },
+ { "enl", { NULL }, 1804, "udp" },
+ { "enl-name", { NULL }, 1805, "tcp" },
+ { "enl-name", { NULL }, 1805, "udp" },
+ { "musiconline", { NULL }, 1806, "tcp" },
+ { "musiconline", { NULL }, 1806, "udp" },
+ { "fhsp", { NULL }, 1807, "tcp" },
+ { "fhsp", { NULL }, 1807, "udp" },
+ { "oracle-vp2", { NULL }, 1808, "tcp" },
+ { "oracle-vp2", { NULL }, 1808, "udp" },
+ { "oracle-vp1", { NULL }, 1809, "tcp" },
+ { "oracle-vp1", { NULL }, 1809, "udp" },
+ { "jerand-lm", { NULL }, 1810, "tcp" },
+ { "jerand-lm", { NULL }, 1810, "udp" },
+ { "scientia-sdb", { NULL }, 1811, "tcp" },
+ { "scientia-sdb", { NULL }, 1811, "udp" },
+ { "radius", { NULL }, 1812, "tcp" },
+ { "radius", { NULL }, 1812, "udp" },
+ { "radius-acct", { NULL }, 1813, "tcp" },
+ { "radius-acct", { NULL }, 1813, "udp" },
+ { "tdp-suite", { NULL }, 1814, "tcp" },
+ { "tdp-suite", { NULL }, 1814, "udp" },
+ { "mmpft", { NULL }, 1815, "tcp" },
+ { "mmpft", { NULL }, 1815, "udp" },
+ { "harp", { NULL }, 1816, "tcp" },
+ { "harp", { NULL }, 1816, "udp" },
+ { "rkb-oscs", { NULL }, 1817, "tcp" },
+ { "rkb-oscs", { NULL }, 1817, "udp" },
+ { "etftp", { NULL }, 1818, "tcp" },
+ { "etftp", { NULL }, 1818, "udp" },
+ { "plato-lm", { NULL }, 1819, "tcp" },
+ { "plato-lm", { NULL }, 1819, "udp" },
+ { "mcagent", { NULL }, 1820, "tcp" },
+ { "mcagent", { NULL }, 1820, "udp" },
+ { "donnyworld", { NULL }, 1821, "tcp" },
+ { "donnyworld", { NULL }, 1821, "udp" },
+ { "es-elmd", { NULL }, 1822, "tcp" },
+ { "es-elmd", { NULL }, 1822, "udp" },
+ { "unisys-lm", { NULL }, 1823, "tcp" },
+ { "unisys-lm", { NULL }, 1823, "udp" },
+ { "metrics-pas", { NULL }, 1824, "tcp" },
+ { "metrics-pas", { NULL }, 1824, "udp" },
+ { "direcpc-video", { NULL }, 1825, "tcp" },
+ { "direcpc-video", { NULL }, 1825, "udp" },
+ { "ardt", { NULL }, 1826, "tcp" },
+ { "ardt", { NULL }, 1826, "udp" },
+ { "asi", { NULL }, 1827, "tcp" },
+ { "asi", { NULL }, 1827, "udp" },
+ { "itm-mcell-u", { NULL }, 1828, "tcp" },
+ { "itm-mcell-u", { NULL }, 1828, "udp" },
+ { "optika-emedia", { NULL }, 1829, "tcp" },
+ { "optika-emedia", { NULL }, 1829, "udp" },
+ { "net8-cman", { NULL }, 1830, "tcp" },
+ { "net8-cman", { NULL }, 1830, "udp" },
+ { "myrtle", { NULL }, 1831, "tcp" },
+ { "myrtle", { NULL }, 1831, "udp" },
+ { "tht-treasure", { NULL }, 1832, "tcp" },
+ { "tht-treasure", { NULL }, 1832, "udp" },
+ { "udpradio", { NULL }, 1833, "tcp" },
+ { "udpradio", { NULL }, 1833, "udp" },
+ { "ardusuni", { NULL }, 1834, "tcp" },
+ { "ardusuni", { NULL }, 1834, "udp" },
+ { "ardusmul", { NULL }, 1835, "tcp" },
+ { "ardusmul", { NULL }, 1835, "udp" },
+ { "ste-smsc", { NULL }, 1836, "tcp" },
+ { "ste-smsc", { NULL }, 1836, "udp" },
+ { "csoft1", { NULL }, 1837, "tcp" },
+ { "csoft1", { NULL }, 1837, "udp" },
+ { "talnet", { NULL }, 1838, "tcp" },
+ { "talnet", { NULL }, 1838, "udp" },
+ { "netopia-vo1", { NULL }, 1839, "tcp" },
+ { "netopia-vo1", { NULL }, 1839, "udp" },
+ { "netopia-vo2", { NULL }, 1840, "tcp" },
+ { "netopia-vo2", { NULL }, 1840, "udp" },
+ { "netopia-vo3", { NULL }, 1841, "tcp" },
+ { "netopia-vo3", { NULL }, 1841, "udp" },
+ { "netopia-vo4", { NULL }, 1842, "tcp" },
+ { "netopia-vo4", { NULL }, 1842, "udp" },
+ { "netopia-vo5", { NULL }, 1843, "tcp" },
+ { "netopia-vo5", { NULL }, 1843, "udp" },
+ { "direcpc-dll", { NULL }, 1844, "tcp" },
+ { "direcpc-dll", { NULL }, 1844, "udp" },
+ { "altalink", { NULL }, 1845, "tcp" },
+ { "altalink", { NULL }, 1845, "udp" },
+ { "tunstall-pnc", { NULL }, 1846, "tcp" },
+ { "tunstall-pnc", { NULL }, 1846, "udp" },
+ { "slp-notify", { NULL }, 1847, "tcp" },
+ { "slp-notify", { NULL }, 1847, "udp" },
+ { "fjdocdist", { NULL }, 1848, "tcp" },
+ { "fjdocdist", { NULL }, 1848, "udp" },
+ { "alpha-sms", { NULL }, 1849, "tcp" },
+ { "alpha-sms", { NULL }, 1849, "udp" },
+ { "gsi", { NULL }, 1850, "tcp" },
+ { "gsi", { NULL }, 1850, "udp" },
+ { "ctcd", { NULL }, 1851, "tcp" },
+ { "ctcd", { NULL }, 1851, "udp" },
+ { "virtual-time", { NULL }, 1852, "tcp" },
+ { "virtual-time", { NULL }, 1852, "udp" },
+ { "vids-avtp", { NULL }, 1853, "tcp" },
+ { "vids-avtp", { NULL }, 1853, "udp" },
+ { "buddy-draw", { NULL }, 1854, "tcp" },
+ { "buddy-draw", { NULL }, 1854, "udp" },
+ { "fiorano-rtrsvc", { NULL }, 1855, "tcp" },
+ { "fiorano-rtrsvc", { NULL }, 1855, "udp" },
+ { "fiorano-msgsvc", { NULL }, 1856, "tcp" },
+ { "fiorano-msgsvc", { NULL }, 1856, "udp" },
+ { "datacaptor", { NULL }, 1857, "tcp" },
+ { "datacaptor", { NULL }, 1857, "udp" },
+ { "privateark", { NULL }, 1858, "tcp" },
+ { "privateark", { NULL }, 1858, "udp" },
+ { "gammafetchsvr", { NULL }, 1859, "tcp" },
+ { "gammafetchsvr", { NULL }, 1859, "udp" },
+ { "sunscalar-svc", { NULL }, 1860, "tcp" },
+ { "sunscalar-svc", { NULL }, 1860, "udp" },
+ { "lecroy-vicp", { NULL }, 1861, "tcp" },
+ { "lecroy-vicp", { NULL }, 1861, "udp" },
+ { "mysql-cm-agent", { NULL }, 1862, "tcp" },
+ { "mysql-cm-agent", { NULL }, 1862, "udp" },
+ { "msnp", { NULL }, 1863, "tcp" },
+ { "msnp", { NULL }, 1863, "udp" },
+ { "paradym-31port", { NULL }, 1864, "tcp" },
+ { "paradym-31port", { NULL }, 1864, "udp" },
+ { "entp", { NULL }, 1865, "tcp" },
+ { "entp", { NULL }, 1865, "udp" },
+ { "swrmi", { NULL }, 1866, "tcp" },
+ { "swrmi", { NULL }, 1866, "udp" },
+ { "udrive", { NULL }, 1867, "tcp" },
+ { "udrive", { NULL }, 1867, "udp" },
+ { "viziblebrowser", { NULL }, 1868, "tcp" },
+ { "viziblebrowser", { NULL }, 1868, "udp" },
+ { "transact", { NULL }, 1869, "tcp" },
+ { "transact", { NULL }, 1869, "udp" },
+ { "sunscalar-dns", { NULL }, 1870, "tcp" },
+ { "sunscalar-dns", { NULL }, 1870, "udp" },
+ { "canocentral0", { NULL }, 1871, "tcp" },
+ { "canocentral0", { NULL }, 1871, "udp" },
+ { "canocentral1", { NULL }, 1872, "tcp" },
+ { "canocentral1", { NULL }, 1872, "udp" },
+ { "fjmpjps", { NULL }, 1873, "tcp" },
+ { "fjmpjps", { NULL }, 1873, "udp" },
+ { "fjswapsnp", { NULL }, 1874, "tcp" },
+ { "fjswapsnp", { NULL }, 1874, "udp" },
+ { "westell-stats", { NULL }, 1875, "tcp" },
+ { "westell-stats", { NULL }, 1875, "udp" },
+ { "ewcappsrv", { NULL }, 1876, "tcp" },
+ { "ewcappsrv", { NULL }, 1876, "udp" },
+ { "hp-webqosdb", { NULL }, 1877, "tcp" },
+ { "hp-webqosdb", { NULL }, 1877, "udp" },
+ { "drmsmc", { NULL }, 1878, "tcp" },
+ { "drmsmc", { NULL }, 1878, "udp" },
+ { "nettgain-nms", { NULL }, 1879, "tcp" },
+ { "nettgain-nms", { NULL }, 1879, "udp" },
+ { "vsat-control", { NULL }, 1880, "tcp" },
+ { "vsat-control", { NULL }, 1880, "udp" },
+ { "ibm-mqseries2", { NULL }, 1881, "tcp" },
+ { "ibm-mqseries2", { NULL }, 1881, "udp" },
+ { "ecsqdmn", { NULL }, 1882, "tcp" },
+ { "ecsqdmn", { NULL }, 1882, "udp" },
+ { "ibm-mqisdp", { NULL }, 1883, "tcp" },
+ { "ibm-mqisdp", { NULL }, 1883, "udp" },
+ { "idmaps", { NULL }, 1884, "tcp" },
+ { "idmaps", { NULL }, 1884, "udp" },
+ { "vrtstrapserver", { NULL }, 1885, "tcp" },
+ { "vrtstrapserver", { NULL }, 1885, "udp" },
+ { "leoip", { NULL }, 1886, "tcp" },
+ { "leoip", { NULL }, 1886, "udp" },
+ { "filex-lport", { NULL }, 1887, "tcp" },
+ { "filex-lport", { NULL }, 1887, "udp" },
+ { "ncconfig", { NULL }, 1888, "tcp" },
+ { "ncconfig", { NULL }, 1888, "udp" },
+ { "unify-adapter", { NULL }, 1889, "tcp" },
+ { "unify-adapter", { NULL }, 1889, "udp" },
+ { "wilkenlistener", { NULL }, 1890, "tcp" },
+ { "wilkenlistener", { NULL }, 1890, "udp" },
+ { "childkey-notif", { NULL }, 1891, "tcp" },
+ { "childkey-notif", { NULL }, 1891, "udp" },
+ { "childkey-ctrl", { NULL }, 1892, "tcp" },
+ { "childkey-ctrl", { NULL }, 1892, "udp" },
+ { "elad", { NULL }, 1893, "tcp" },
+ { "elad", { NULL }, 1893, "udp" },
+ { "o2server-port", { NULL }, 1894, "tcp" },
+ { "o2server-port", { NULL }, 1894, "udp" },
+ { "b-novative-ls", { NULL }, 1896, "tcp" },
+ { "b-novative-ls", { NULL }, 1896, "udp" },
+ { "metaagent", { NULL }, 1897, "tcp" },
+ { "metaagent", { NULL }, 1897, "udp" },
+ { "cymtec-port", { NULL }, 1898, "tcp" },
+ { "cymtec-port", { NULL }, 1898, "udp" },
+ { "mc2studios", { NULL }, 1899, "tcp" },
+ { "mc2studios", { NULL }, 1899, "udp" },
+ { "ssdp", { NULL }, 1900, "tcp" },
+ { "ssdp", { NULL }, 1900, "udp" },
+ { "fjicl-tep-a", { NULL }, 1901, "tcp" },
+ { "fjicl-tep-a", { NULL }, 1901, "udp" },
+ { "fjicl-tep-b", { NULL }, 1902, "tcp" },
+ { "fjicl-tep-b", { NULL }, 1902, "udp" },
+ { "linkname", { NULL }, 1903, "tcp" },
+ { "linkname", { NULL }, 1903, "udp" },
+ { "fjicl-tep-c", { NULL }, 1904, "tcp" },
+ { "fjicl-tep-c", { NULL }, 1904, "udp" },
+ { "sugp", { NULL }, 1905, "tcp" },
+ { "sugp", { NULL }, 1905, "udp" },
+ { "tpmd", { NULL }, 1906, "tcp" },
+ { "tpmd", { NULL }, 1906, "udp" },
+ { "intrastar", { NULL }, 1907, "tcp" },
+ { "intrastar", { NULL }, 1907, "udp" },
+ { "dawn", { NULL }, 1908, "tcp" },
+ { "dawn", { NULL }, 1908, "udp" },
+ { "global-wlink", { NULL }, 1909, "tcp" },
+ { "global-wlink", { NULL }, 1909, "udp" },
+ { "ultrabac", { NULL }, 1910, "tcp" },
+ { "ultrabac", { NULL }, 1910, "udp" },
+ { "mtp", { NULL }, 1911, "tcp" },
+ { "mtp", { NULL }, 1911, "udp" },
+ { "rhp-iibp", { NULL }, 1912, "tcp" },
+ { "rhp-iibp", { NULL }, 1912, "udp" },
+ { "armadp", { NULL }, 1913, "tcp" },
+ { "armadp", { NULL }, 1913, "udp" },
+ { "elm-momentum", { NULL }, 1914, "tcp" },
+ { "elm-momentum", { NULL }, 1914, "udp" },
+ { "facelink", { NULL }, 1915, "tcp" },
+ { "facelink", { NULL }, 1915, "udp" },
+ { "persona", { NULL }, 1916, "tcp" },
+ { "persona", { NULL }, 1916, "udp" },
+ { "noagent", { NULL }, 1917, "tcp" },
+ { "noagent", { NULL }, 1917, "udp" },
+ { "can-nds", { NULL }, 1918, "tcp" },
+ { "can-nds", { NULL }, 1918, "udp" },
+ { "can-dch", { NULL }, 1919, "tcp" },
+ { "can-dch", { NULL }, 1919, "udp" },
+ { "can-ferret", { NULL }, 1920, "tcp" },
+ { "can-ferret", { NULL }, 1920, "udp" },
+ { "noadmin", { NULL }, 1921, "tcp" },
+ { "noadmin", { NULL }, 1921, "udp" },
+ { "tapestry", { NULL }, 1922, "tcp" },
+ { "tapestry", { NULL }, 1922, "udp" },
+ { "spice", { NULL }, 1923, "tcp" },
+ { "spice", { NULL }, 1923, "udp" },
+ { "xiip", { NULL }, 1924, "tcp" },
+ { "xiip", { NULL }, 1924, "udp" },
+ { "discovery-port", { NULL }, 1925, "tcp" },
+ { "discovery-port", { NULL }, 1925, "udp" },
+ { "egs", { NULL }, 1926, "tcp" },
+ { "egs", { NULL }, 1926, "udp" },
+ { "videte-cipc", { NULL }, 1927, "tcp" },
+ { "videte-cipc", { NULL }, 1927, "udp" },
+ { "emsd-port", { NULL }, 1928, "tcp" },
+ { "emsd-port", { NULL }, 1928, "udp" },
+ { "bandwiz-system", { NULL }, 1929, "tcp" },
+ { "bandwiz-system", { NULL }, 1929, "udp" },
+ { "driveappserver", { NULL }, 1930, "tcp" },
+ { "driveappserver", { NULL }, 1930, "udp" },
+ { "amdsched", { NULL }, 1931, "tcp" },
+ { "amdsched", { NULL }, 1931, "udp" },
+ { "ctt-broker", { NULL }, 1932, "tcp" },
+ { "ctt-broker", { NULL }, 1932, "udp" },
+ { "xmapi", { NULL }, 1933, "tcp" },
+ { "xmapi", { NULL }, 1933, "udp" },
+ { "xaapi", { NULL }, 1934, "tcp" },
+ { "xaapi", { NULL }, 1934, "udp" },
+ { "macromedia-fcs", { NULL }, 1935, "tcp" },
+ { "macromedia-fcs", { NULL }, 1935, "udp" },
+ { "jetcmeserver", { NULL }, 1936, "tcp" },
+ { "jetcmeserver", { NULL }, 1936, "udp" },
+ { "jwserver", { NULL }, 1937, "tcp" },
+ { "jwserver", { NULL }, 1937, "udp" },
+ { "jwclient", { NULL }, 1938, "tcp" },
+ { "jwclient", { NULL }, 1938, "udp" },
+ { "jvserver", { NULL }, 1939, "tcp" },
+ { "jvserver", { NULL }, 1939, "udp" },
+ { "jvclient", { NULL }, 1940, "tcp" },
+ { "jvclient", { NULL }, 1940, "udp" },
+ { "dic-aida", { NULL }, 1941, "tcp" },
+ { "dic-aida", { NULL }, 1941, "udp" },
+ { "res", { NULL }, 1942, "tcp" },
+ { "res", { NULL }, 1942, "udp" },
+ { "beeyond-media", { NULL }, 1943, "tcp" },
+ { "beeyond-media", { NULL }, 1943, "udp" },
+ { "close-combat", { NULL }, 1944, "tcp" },
+ { "close-combat", { NULL }, 1944, "udp" },
+ { "dialogic-elmd", { NULL }, 1945, "tcp" },
+ { "dialogic-elmd", { NULL }, 1945, "udp" },
+ { "tekpls", { NULL }, 1946, "tcp" },
+ { "tekpls", { NULL }, 1946, "udp" },
+ { "sentinelsrm", { NULL }, 1947, "tcp" },
+ { "sentinelsrm", { NULL }, 1947, "udp" },
+ { "eye2eye", { NULL }, 1948, "tcp" },
+ { "eye2eye", { NULL }, 1948, "udp" },
+ { "ismaeasdaqlive", { NULL }, 1949, "tcp" },
+ { "ismaeasdaqlive", { NULL }, 1949, "udp" },
+ { "ismaeasdaqtest", { NULL }, 1950, "tcp" },
+ { "ismaeasdaqtest", { NULL }, 1950, "udp" },
+ { "bcs-lmserver", { NULL }, 1951, "tcp" },
+ { "bcs-lmserver", { NULL }, 1951, "udp" },
+ { "mpnjsc", { NULL }, 1952, "tcp" },
+ { "mpnjsc", { NULL }, 1952, "udp" },
+ { "rapidbase", { NULL }, 1953, "tcp" },
+ { "rapidbase", { NULL }, 1953, "udp" },
+ { "abr-api", { NULL }, 1954, "tcp" },
+ { "abr-api", { NULL }, 1954, "udp" },
+ { "abr-secure", { NULL }, 1955, "tcp" },
+ { "abr-secure", { NULL }, 1955, "udp" },
+ { "vrtl-vmf-ds", { NULL }, 1956, "tcp" },
+ { "vrtl-vmf-ds", { NULL }, 1956, "udp" },
+ { "unix-status", { NULL }, 1957, "tcp" },
+ { "unix-status", { NULL }, 1957, "udp" },
+ { "dxadmind", { NULL }, 1958, "tcp" },
+ { "dxadmind", { NULL }, 1958, "udp" },
+ { "simp-all", { NULL }, 1959, "tcp" },
+ { "simp-all", { NULL }, 1959, "udp" },
+ { "nasmanager", { NULL }, 1960, "tcp" },
+ { "nasmanager", { NULL }, 1960, "udp" },
+ { "bts-appserver", { NULL }, 1961, "tcp" },
+ { "bts-appserver", { NULL }, 1961, "udp" },
+ { "biap-mp", { NULL }, 1962, "tcp" },
+ { "biap-mp", { NULL }, 1962, "udp" },
+ { "webmachine", { NULL }, 1963, "tcp" },
+ { "webmachine", { NULL }, 1963, "udp" },
+ { "solid-e-engine", { NULL }, 1964, "tcp" },
+ { "solid-e-engine", { NULL }, 1964, "udp" },
+ { "tivoli-npm", { NULL }, 1965, "tcp" },
+ { "tivoli-npm", { NULL }, 1965, "udp" },
+ { "slush", { NULL }, 1966, "tcp" },
+ { "slush", { NULL }, 1966, "udp" },
+ { "sns-quote", { NULL }, 1967, "tcp" },
+ { "sns-quote", { NULL }, 1967, "udp" },
+ { "lipsinc", { NULL }, 1968, "tcp" },
+ { "lipsinc", { NULL }, 1968, "udp" },
+ { "lipsinc1", { NULL }, 1969, "tcp" },
+ { "lipsinc1", { NULL }, 1969, "udp" },
+ { "netop-rc", { NULL }, 1970, "tcp" },
+ { "netop-rc", { NULL }, 1970, "udp" },
+ { "netop-school", { NULL }, 1971, "tcp" },
+ { "netop-school", { NULL }, 1971, "udp" },
+ { "intersys-cache", { NULL }, 1972, "tcp" },
+ { "intersys-cache", { NULL }, 1972, "udp" },
+ { "dlsrap", { NULL }, 1973, "tcp" },
+ { "dlsrap", { NULL }, 1973, "udp" },
+ { "drp", { NULL }, 1974, "tcp" },
+ { "drp", { NULL }, 1974, "udp" },
+ { "tcoflashagent", { NULL }, 1975, "tcp" },
+ { "tcoflashagent", { NULL }, 1975, "udp" },
+ { "tcoregagent", { NULL }, 1976, "tcp" },
+ { "tcoregagent", { NULL }, 1976, "udp" },
+ { "tcoaddressbook", { NULL }, 1977, "tcp" },
+ { "tcoaddressbook", { NULL }, 1977, "udp" },
+ { "unisql", { NULL }, 1978, "tcp" },
+ { "unisql", { NULL }, 1978, "udp" },
+ { "unisql-java", { NULL }, 1979, "tcp" },
+ { "unisql-java", { NULL }, 1979, "udp" },
+ { "pearldoc-xact", { NULL }, 1980, "tcp" },
+ { "pearldoc-xact", { NULL }, 1980, "udp" },
+ { "p2pq", { NULL }, 1981, "tcp" },
+ { "p2pq", { NULL }, 1981, "udp" },
+ { "estamp", { NULL }, 1982, "tcp" },
+ { "estamp", { NULL }, 1982, "udp" },
+ { "lhtp", { NULL }, 1983, "tcp" },
+ { "lhtp", { NULL }, 1983, "udp" },
+ { "bb", { NULL }, 1984, "tcp" },
+ { "bb", { NULL }, 1984, "udp" },
+ { "hsrp", { NULL }, 1985, "tcp" },
+ { "hsrp", { NULL }, 1985, "udp" },
+ { "licensedaemon", { NULL }, 1986, "tcp" },
+ { "licensedaemon", { NULL }, 1986, "udp" },
+ { "tr-rsrb-p1", { NULL }, 1987, "tcp" },
+ { "tr-rsrb-p1", { NULL }, 1987, "udp" },
+ { "tr-rsrb-p2", { NULL }, 1988, "tcp" },
+ { "tr-rsrb-p2", { NULL }, 1988, "udp" },
+ { "tr-rsrb-p3", { NULL }, 1989, "tcp" },
+ { "tr-rsrb-p3", { NULL }, 1989, "udp" },
+ { "mshnet", { NULL }, 1989, "tcp" },
+ { "mshnet", { NULL }, 1989, "udp" },
+ { "stun-p1", { NULL }, 1990, "tcp" },
+ { "stun-p1", { NULL }, 1990, "udp" },
+ { "stun-p2", { NULL }, 1991, "tcp" },
+ { "stun-p2", { NULL }, 1991, "udp" },
+ { "stun-p3", { NULL }, 1992, "tcp" },
+ { "stun-p3", { NULL }, 1992, "udp" },
+ { "ipsendmsg", { NULL }, 1992, "tcp" },
+ { "ipsendmsg", { NULL }, 1992, "udp" },
+ { "snmp-tcp-port", { NULL }, 1993, "tcp" },
+ { "snmp-tcp-port", { NULL }, 1993, "udp" },
+ { "stun-port", { NULL }, 1994, "tcp" },
+ { "stun-port", { NULL }, 1994, "udp" },
+ { "perf-port", { NULL }, 1995, "tcp" },
+ { "perf-port", { NULL }, 1995, "udp" },
+ { "tr-rsrb-port", { NULL }, 1996, "tcp" },
+ { "tr-rsrb-port", { NULL }, 1996, "udp" },
+ { "gdp-port", { NULL }, 1997, "tcp" },
+ { "gdp-port", { NULL }, 1997, "udp" },
+ { "x25-svc-port", { NULL }, 1998, "tcp" },
+ { "x25-svc-port", { NULL }, 1998, "udp" },
+ { "tcp-id-port", { NULL }, 1999, "tcp" },
+ { "tcp-id-port", { NULL }, 1999, "udp" },
+ { "cisco-sccp", { NULL }, 2000, "tcp" },
+ { "cisco-sccp", { NULL }, 2000, "udp" },
+ { "dc", { NULL }, 2001, "tcp" },
+ { "wizard", { NULL }, 2001, "udp" },
+ { "globe", { NULL }, 2002, "tcp" },
+ { "globe", { NULL }, 2002, "udp" },
+ { "brutus", { NULL }, 2003, "tcp" },
+ { "brutus", { NULL }, 2003, "udp" },
+ { "mailbox", { NULL }, 2004, "tcp" },
+ { "emce", { NULL }, 2004, "udp" },
+ { "berknet", { NULL }, 2005, "tcp" },
+ { "oracle", { NULL }, 2005, "udp" },
+ { "invokator", { NULL }, 2006, "tcp" },
+ { "raid-cd", { NULL }, 2006, "udp" },
+ { "dectalk", { NULL }, 2007, "tcp" },
+ { "raid-am", { NULL }, 2007, "udp" },
+ { "conf", { NULL }, 2008, "tcp" },
+ { "terminaldb", { NULL }, 2008, "udp" },
+ { "news", { NULL }, 2009, "tcp" },
+ { "whosockami", { NULL }, 2009, "udp" },
+ { "search", { NULL }, 2010, "tcp" },
+ { "pipe_server", { NULL }, 2010, "udp" },
+ { "raid-cc", { NULL }, 2011, "tcp" },
+ { "servserv", { NULL }, 2011, "udp" },
+ { "ttyinfo", { NULL }, 2012, "tcp" },
+ { "raid-ac", { NULL }, 2012, "udp" },
+ { "raid-am", { NULL }, 2013, "tcp" },
+ { "raid-cd", { NULL }, 2013, "udp" },
+ { "troff", { NULL }, 2014, "tcp" },
+ { "raid-sf", { NULL }, 2014, "udp" },
+ { "cypress", { NULL }, 2015, "tcp" },
+ { "raid-cs", { NULL }, 2015, "udp" },
+ { "bootserver", { NULL }, 2016, "tcp" },
+ { "bootserver", { NULL }, 2016, "udp" },
+ { "cypress-stat", { NULL }, 2017, "tcp" },
+ { "bootclient", { NULL }, 2017, "udp" },
+ { "terminaldb", { NULL }, 2018, "tcp" },
+ { "rellpack", { NULL }, 2018, "udp" },
+ { "whosockami", { NULL }, 2019, "tcp" },
+ { "about", { NULL }, 2019, "udp" },
+ { "xinupageserver", { NULL }, 2020, "tcp" },
+ { "xinupageserver", { NULL }, 2020, "udp" },
+ { "servexec", { NULL }, 2021, "tcp" },
+ { "xinuexpansion1", { NULL }, 2021, "udp" },
+ { "down", { NULL }, 2022, "tcp" },
+ { "xinuexpansion2", { NULL }, 2022, "udp" },
+ { "xinuexpansion3", { NULL }, 2023, "tcp" },
+ { "xinuexpansion3", { NULL }, 2023, "udp" },
+ { "xinuexpansion4", { NULL }, 2024, "tcp" },
+ { "xinuexpansion4", { NULL }, 2024, "udp" },
+ { "ellpack", { NULL }, 2025, "tcp" },
+ { "xribs", { NULL }, 2025, "udp" },
+ { "scrabble", { NULL }, 2026, "tcp" },
+ { "scrabble", { NULL }, 2026, "udp" },
+ { "shadowserver", { NULL }, 2027, "tcp" },
+ { "shadowserver", { NULL }, 2027, "udp" },
+ { "submitserver", { NULL }, 2028, "tcp" },
+ { "submitserver", { NULL }, 2028, "udp" },
+ { "hsrpv6", { NULL }, 2029, "tcp" },
+ { "hsrpv6", { NULL }, 2029, "udp" },
+ { "device2", { NULL }, 2030, "tcp" },
+ { "device2", { NULL }, 2030, "udp" },
+ { "mobrien-chat", { NULL }, 2031, "tcp" },
+ { "mobrien-chat", { NULL }, 2031, "udp" },
+ { "blackboard", { NULL }, 2032, "tcp" },
+ { "blackboard", { NULL }, 2032, "udp" },
+ { "glogger", { NULL }, 2033, "tcp" },
+ { "glogger", { NULL }, 2033, "udp" },
+ { "scoremgr", { NULL }, 2034, "tcp" },
+ { "scoremgr", { NULL }, 2034, "udp" },
+ { "imsldoc", { NULL }, 2035, "tcp" },
+ { "imsldoc", { NULL }, 2035, "udp" },
+ { "e-dpnet", { NULL }, 2036, "tcp" },
+ { "e-dpnet", { NULL }, 2036, "udp" },
+ { "applus", { NULL }, 2037, "tcp" },
+ { "applus", { NULL }, 2037, "udp" },
+ { "objectmanager", { NULL }, 2038, "tcp" },
+ { "objectmanager", { NULL }, 2038, "udp" },
+ { "prizma", { NULL }, 2039, "tcp" },
+ { "prizma", { NULL }, 2039, "udp" },
+ { "lam", { NULL }, 2040, "tcp" },
+ { "lam", { NULL }, 2040, "udp" },
+ { "interbase", { NULL }, 2041, "tcp" },
+ { "interbase", { NULL }, 2041, "udp" },
+ { "isis", { NULL }, 2042, "tcp" },
+ { "isis", { NULL }, 2042, "udp" },
+ { "isis-bcast", { NULL }, 2043, "tcp" },
+ { "isis-bcast", { NULL }, 2043, "udp" },
+ { "rimsl", { NULL }, 2044, "tcp" },
+ { "rimsl", { NULL }, 2044, "udp" },
+ { "cdfunc", { NULL }, 2045, "tcp" },
+ { "cdfunc", { NULL }, 2045, "udp" },
+ { "sdfunc", { NULL }, 2046, "tcp" },
+ { "sdfunc", { NULL }, 2046, "udp" },
+ { "dls", { NULL }, 2047, "tcp" },
+ { "dls", { NULL }, 2047, "udp" },
+ { "dls-monitor", { NULL }, 2048, "tcp" },
+ { "dls-monitor", { NULL }, 2048, "udp" },
+ { "shilp", { NULL }, 2049, "tcp" },
+ { "shilp", { NULL }, 2049, "udp" },
+ { "nfs", { NULL }, 2049, "tcp" },
+ { "nfs", { NULL }, 2049, "udp" },
+ { "nfs", { NULL }, 2049, "sctp"},
+ { "av-emb-config", { NULL }, 2050, "tcp" },
+ { "av-emb-config", { NULL }, 2050, "udp" },
+ { "epnsdp", { NULL }, 2051, "tcp" },
+ { "epnsdp", { NULL }, 2051, "udp" },
+ { "clearvisn", { NULL }, 2052, "tcp" },
+ { "clearvisn", { NULL }, 2052, "udp" },
+ { "lot105-ds-upd", { NULL }, 2053, "tcp" },
+ { "lot105-ds-upd", { NULL }, 2053, "udp" },
+ { "weblogin", { NULL }, 2054, "tcp" },
+ { "weblogin", { NULL }, 2054, "udp" },
+ { "iop", { NULL }, 2055, "tcp" },
+ { "iop", { NULL }, 2055, "udp" },
+ { "omnisky", { NULL }, 2056, "tcp" },
+ { "omnisky", { NULL }, 2056, "udp" },
+ { "rich-cp", { NULL }, 2057, "tcp" },
+ { "rich-cp", { NULL }, 2057, "udp" },
+ { "newwavesearch", { NULL }, 2058, "tcp" },
+ { "newwavesearch", { NULL }, 2058, "udp" },
+ { "bmc-messaging", { NULL }, 2059, "tcp" },
+ { "bmc-messaging", { NULL }, 2059, "udp" },
+ { "teleniumdaemon", { NULL }, 2060, "tcp" },
+ { "teleniumdaemon", { NULL }, 2060, "udp" },
+ { "netmount", { NULL }, 2061, "tcp" },
+ { "netmount", { NULL }, 2061, "udp" },
+ { "icg-swp", { NULL }, 2062, "tcp" },
+ { "icg-swp", { NULL }, 2062, "udp" },
+ { "icg-bridge", { NULL }, 2063, "tcp" },
+ { "icg-bridge", { NULL }, 2063, "udp" },
+ { "icg-iprelay", { NULL }, 2064, "tcp" },
+ { "icg-iprelay", { NULL }, 2064, "udp" },
+ { "dlsrpn", { NULL }, 2065, "tcp" },
+ { "dlsrpn", { NULL }, 2065, "udp" },
+ { "aura", { NULL }, 2066, "tcp" },
+ { "aura", { NULL }, 2066, "udp" },
+ { "dlswpn", { NULL }, 2067, "tcp" },
+ { "dlswpn", { NULL }, 2067, "udp" },
+ { "avauthsrvprtcl", { NULL }, 2068, "tcp" },
+ { "avauthsrvprtcl", { NULL }, 2068, "udp" },
+ { "event-port", { NULL }, 2069, "tcp" },
+ { "event-port", { NULL }, 2069, "udp" },
+ { "ah-esp-encap", { NULL }, 2070, "tcp" },
+ { "ah-esp-encap", { NULL }, 2070, "udp" },
+ { "acp-port", { NULL }, 2071, "tcp" },
+ { "acp-port", { NULL }, 2071, "udp" },
+ { "msync", { NULL }, 2072, "tcp" },
+ { "msync", { NULL }, 2072, "udp" },
+ { "gxs-data-port", { NULL }, 2073, "tcp" },
+ { "gxs-data-port", { NULL }, 2073, "udp" },
+ { "vrtl-vmf-sa", { NULL }, 2074, "tcp" },
+ { "vrtl-vmf-sa", { NULL }, 2074, "udp" },
+ { "newlixengine", { NULL }, 2075, "tcp" },
+ { "newlixengine", { NULL }, 2075, "udp" },
+ { "newlixconfig", { NULL }, 2076, "tcp" },
+ { "newlixconfig", { NULL }, 2076, "udp" },
+ { "tsrmagt", { NULL }, 2077, "tcp" },
+ { "tsrmagt", { NULL }, 2077, "udp" },
+ { "tpcsrvr", { NULL }, 2078, "tcp" },
+ { "tpcsrvr", { NULL }, 2078, "udp" },
+ { "idware-router", { NULL }, 2079, "tcp" },
+ { "idware-router", { NULL }, 2079, "udp" },
+ { "autodesk-nlm", { NULL }, 2080, "tcp" },
+ { "autodesk-nlm", { NULL }, 2080, "udp" },
+ { "kme-trap-port", { NULL }, 2081, "tcp" },
+ { "kme-trap-port", { NULL }, 2081, "udp" },
+ { "infowave", { NULL }, 2082, "tcp" },
+ { "infowave", { NULL }, 2082, "udp" },
+ { "radsec", { NULL }, 2083, "tcp" },
+ { "radsec", { NULL }, 2083, "udp" },
+ { "sunclustergeo", { NULL }, 2084, "tcp" },
+ { "sunclustergeo", { NULL }, 2084, "udp" },
+ { "ada-cip", { NULL }, 2085, "tcp" },
+ { "ada-cip", { NULL }, 2085, "udp" },
+ { "gnunet", { NULL }, 2086, "tcp" },
+ { "gnunet", { NULL }, 2086, "udp" },
+ { "eli", { NULL }, 2087, "tcp" },
+ { "eli", { NULL }, 2087, "udp" },
+ { "ip-blf", { NULL }, 2088, "tcp" },
+ { "ip-blf", { NULL }, 2088, "udp" },
+ { "sep", { NULL }, 2089, "tcp" },
+ { "sep", { NULL }, 2089, "udp" },
+ { "lrp", { NULL }, 2090, "tcp" },
+ { "lrp", { NULL }, 2090, "udp" },
+ { "prp", { NULL }, 2091, "tcp" },
+ { "prp", { NULL }, 2091, "udp" },
+ { "descent3", { NULL }, 2092, "tcp" },
+ { "descent3", { NULL }, 2092, "udp" },
+ { "nbx-cc", { NULL }, 2093, "tcp" },
+ { "nbx-cc", { NULL }, 2093, "udp" },
+ { "nbx-au", { NULL }, 2094, "tcp" },
+ { "nbx-au", { NULL }, 2094, "udp" },
+ { "nbx-ser", { NULL }, 2095, "tcp" },
+ { "nbx-ser", { NULL }, 2095, "udp" },
+ { "nbx-dir", { NULL }, 2096, "tcp" },
+ { "nbx-dir", { NULL }, 2096, "udp" },
+ { "jetformpreview", { NULL }, 2097, "tcp" },
+ { "jetformpreview", { NULL }, 2097, "udp" },
+ { "dialog-port", { NULL }, 2098, "tcp" },
+ { "dialog-port", { NULL }, 2098, "udp" },
+ { "h2250-annex-g", { NULL }, 2099, "tcp" },
+ { "h2250-annex-g", { NULL }, 2099, "udp" },
+ { "amiganetfs", { NULL }, 2100, "tcp" },
+ { "amiganetfs", { NULL }, 2100, "udp" },
+ { "rtcm-sc104", { NULL }, 2101, "tcp" },
+ { "rtcm-sc104", { NULL }, 2101, "udp" },
+ { "zephyr-srv", { NULL }, 2102, "tcp" },
+ { "zephyr-srv", { NULL }, 2102, "udp" },
+ { "zephyr-clt", { NULL }, 2103, "tcp" },
+ { "zephyr-clt", { NULL }, 2103, "udp" },
+ { "zephyr-hm", { NULL }, 2104, "tcp" },
+ { "zephyr-hm", { NULL }, 2104, "udp" },
+ { "minipay", { NULL }, 2105, "tcp" },
+ { "minipay", { NULL }, 2105, "udp" },
+ { "mzap", { NULL }, 2106, "tcp" },
+ { "mzap", { NULL }, 2106, "udp" },
+ { "bintec-admin", { NULL }, 2107, "tcp" },
+ { "bintec-admin", { NULL }, 2107, "udp" },
+ { "comcam", { NULL }, 2108, "tcp" },
+ { "comcam", { NULL }, 2108, "udp" },
+ { "ergolight", { NULL }, 2109, "tcp" },
+ { "ergolight", { NULL }, 2109, "udp" },
+ { "umsp", { NULL }, 2110, "tcp" },
+ { "umsp", { NULL }, 2110, "udp" },
+ { "dsatp", { NULL }, 2111, "tcp" },
+ { "dsatp", { NULL }, 2111, "udp" },
+ { "idonix-metanet", { NULL }, 2112, "tcp" },
+ { "idonix-metanet", { NULL }, 2112, "udp" },
+ { "hsl-storm", { NULL }, 2113, "tcp" },
+ { "hsl-storm", { NULL }, 2113, "udp" },
+ { "newheights", { NULL }, 2114, "tcp" },
+ { "newheights", { NULL }, 2114, "udp" },
+ { "kdm", { NULL }, 2115, "tcp" },
+ { "kdm", { NULL }, 2115, "udp" },
+ { "ccowcmr", { NULL }, 2116, "tcp" },
+ { "ccowcmr", { NULL }, 2116, "udp" },
+ { "mentaclient", { NULL }, 2117, "tcp" },
+ { "mentaclient", { NULL }, 2117, "udp" },
+ { "mentaserver", { NULL }, 2118, "tcp" },
+ { "mentaserver", { NULL }, 2118, "udp" },
+ { "gsigatekeeper", { NULL }, 2119, "tcp" },
+ { "gsigatekeeper", { NULL }, 2119, "udp" },
+ { "qencp", { NULL }, 2120, "tcp" },
+ { "qencp", { NULL }, 2120, "udp" },
+ { "scientia-ssdb", { NULL }, 2121, "tcp" },
+ { "scientia-ssdb", { NULL }, 2121, "udp" },
+ { "caupc-remote", { NULL }, 2122, "tcp" },
+ { "caupc-remote", { NULL }, 2122, "udp" },
+ { "gtp-control", { NULL }, 2123, "tcp" },
+ { "gtp-control", { NULL }, 2123, "udp" },
+ { "elatelink", { NULL }, 2124, "tcp" },
+ { "elatelink", { NULL }, 2124, "udp" },
+ { "lockstep", { NULL }, 2125, "tcp" },
+ { "lockstep", { NULL }, 2125, "udp" },
+ { "pktcable-cops", { NULL }, 2126, "tcp" },
+ { "pktcable-cops", { NULL }, 2126, "udp" },
+ { "index-pc-wb", { NULL }, 2127, "tcp" },
+ { "index-pc-wb", { NULL }, 2127, "udp" },
+ { "net-steward", { NULL }, 2128, "tcp" },
+ { "net-steward", { NULL }, 2128, "udp" },
+ { "cs-live", { NULL }, 2129, "tcp" },
+ { "cs-live", { NULL }, 2129, "udp" },
+ { "xds", { NULL }, 2130, "tcp" },
+ { "xds", { NULL }, 2130, "udp" },
+ { "avantageb2b", { NULL }, 2131, "tcp" },
+ { "avantageb2b", { NULL }, 2131, "udp" },
+ { "solera-epmap", { NULL }, 2132, "tcp" },
+ { "solera-epmap", { NULL }, 2132, "udp" },
+ { "zymed-zpp", { NULL }, 2133, "tcp" },
+ { "zymed-zpp", { NULL }, 2133, "udp" },
+ { "avenue", { NULL }, 2134, "tcp" },
+ { "avenue", { NULL }, 2134, "udp" },
+ { "gris", { NULL }, 2135, "tcp" },
+ { "gris", { NULL }, 2135, "udp" },
+ { "appworxsrv", { NULL }, 2136, "tcp" },
+ { "appworxsrv", { NULL }, 2136, "udp" },
+ { "connect", { NULL }, 2137, "tcp" },
+ { "connect", { NULL }, 2137, "udp" },
+ { "unbind-cluster", { NULL }, 2138, "tcp" },
+ { "unbind-cluster", { NULL }, 2138, "udp" },
+ { "ias-auth", { NULL }, 2139, "tcp" },
+ { "ias-auth", { NULL }, 2139, "udp" },
+ { "ias-reg", { NULL }, 2140, "tcp" },
+ { "ias-reg", { NULL }, 2140, "udp" },
+ { "ias-admind", { NULL }, 2141, "tcp" },
+ { "ias-admind", { NULL }, 2141, "udp" },
+ { "tdmoip", { NULL }, 2142, "tcp" },
+ { "tdmoip", { NULL }, 2142, "udp" },
+ { "lv-jc", { NULL }, 2143, "tcp" },
+ { "lv-jc", { NULL }, 2143, "udp" },
+ { "lv-ffx", { NULL }, 2144, "tcp" },
+ { "lv-ffx", { NULL }, 2144, "udp" },
+ { "lv-pici", { NULL }, 2145, "tcp" },
+ { "lv-pici", { NULL }, 2145, "udp" },
+ { "lv-not", { NULL }, 2146, "tcp" },
+ { "lv-not", { NULL }, 2146, "udp" },
+ { "lv-auth", { NULL }, 2147, "tcp" },
+ { "lv-auth", { NULL }, 2147, "udp" },
+ { "veritas-ucl", { NULL }, 2148, "tcp" },
+ { "veritas-ucl", { NULL }, 2148, "udp" },
+ { "acptsys", { NULL }, 2149, "tcp" },
+ { "acptsys", { NULL }, 2149, "udp" },
+ { "dynamic3d", { NULL }, 2150, "tcp" },
+ { "dynamic3d", { NULL }, 2150, "udp" },
+ { "docent", { NULL }, 2151, "tcp" },
+ { "docent", { NULL }, 2151, "udp" },
+ { "gtp-user", { NULL }, 2152, "tcp" },
+ { "gtp-user", { NULL }, 2152, "udp" },
+ { "ctlptc", { NULL }, 2153, "tcp" },
+ { "ctlptc", { NULL }, 2153, "udp" },
+ { "stdptc", { NULL }, 2154, "tcp" },
+ { "stdptc", { NULL }, 2154, "udp" },
+ { "brdptc", { NULL }, 2155, "tcp" },
+ { "brdptc", { NULL }, 2155, "udp" },
+ { "trp", { NULL }, 2156, "tcp" },
+ { "trp", { NULL }, 2156, "udp" },
+ { "xnds", { NULL }, 2157, "tcp" },
+ { "xnds", { NULL }, 2157, "udp" },
+ { "touchnetplus", { NULL }, 2158, "tcp" },
+ { "touchnetplus", { NULL }, 2158, "udp" },
+ { "gdbremote", { NULL }, 2159, "tcp" },
+ { "gdbremote", { NULL }, 2159, "udp" },
+ { "apc-2160", { NULL }, 2160, "tcp" },
+ { "apc-2160", { NULL }, 2160, "udp" },
+ { "apc-2161", { NULL }, 2161, "tcp" },
+ { "apc-2161", { NULL }, 2161, "udp" },
+ { "navisphere", { NULL }, 2162, "tcp" },
+ { "navisphere", { NULL }, 2162, "udp" },
+ { "navisphere-sec", { NULL }, 2163, "tcp" },
+ { "navisphere-sec", { NULL }, 2163, "udp" },
+ { "ddns-v3", { NULL }, 2164, "tcp" },
+ { "ddns-v3", { NULL }, 2164, "udp" },
+ { "x-bone-api", { NULL }, 2165, "tcp" },
+ { "x-bone-api", { NULL }, 2165, "udp" },
+ { "iwserver", { NULL }, 2166, "tcp" },
+ { "iwserver", { NULL }, 2166, "udp" },
+ { "raw-serial", { NULL }, 2167, "tcp" },
+ { "raw-serial", { NULL }, 2167, "udp" },
+ { "easy-soft-mux", { NULL }, 2168, "tcp" },
+ { "easy-soft-mux", { NULL }, 2168, "udp" },
+ { "brain", { NULL }, 2169, "tcp" },
+ { "brain", { NULL }, 2169, "udp" },
+ { "eyetv", { NULL }, 2170, "tcp" },
+ { "eyetv", { NULL }, 2170, "udp" },
+ { "msfw-storage", { NULL }, 2171, "tcp" },
+ { "msfw-storage", { NULL }, 2171, "udp" },
+ { "msfw-s-storage", { NULL }, 2172, "tcp" },
+ { "msfw-s-storage", { NULL }, 2172, "udp" },
+ { "msfw-replica", { NULL }, 2173, "tcp" },
+ { "msfw-replica", { NULL }, 2173, "udp" },
+ { "msfw-array", { NULL }, 2174, "tcp" },
+ { "msfw-array", { NULL }, 2174, "udp" },
+ { "airsync", { NULL }, 2175, "tcp" },
+ { "airsync", { NULL }, 2175, "udp" },
+ { "rapi", { NULL }, 2176, "tcp" },
+ { "rapi", { NULL }, 2176, "udp" },
+ { "qwave", { NULL }, 2177, "tcp" },
+ { "qwave", { NULL }, 2177, "udp" },
+ { "bitspeer", { NULL }, 2178, "tcp" },
+ { "bitspeer", { NULL }, 2178, "udp" },
+ { "vmrdp", { NULL }, 2179, "tcp" },
+ { "vmrdp", { NULL }, 2179, "udp" },
+ { "mc-gt-srv", { NULL }, 2180, "tcp" },
+ { "mc-gt-srv", { NULL }, 2180, "udp" },
+ { "eforward", { NULL }, 2181, "tcp" },
+ { "eforward", { NULL }, 2181, "udp" },
+ { "cgn-stat", { NULL }, 2182, "tcp" },
+ { "cgn-stat", { NULL }, 2182, "udp" },
+ { "cgn-config", { NULL }, 2183, "tcp" },
+ { "cgn-config", { NULL }, 2183, "udp" },
+ { "nvd", { NULL }, 2184, "tcp" },
+ { "nvd", { NULL }, 2184, "udp" },
+ { "onbase-dds", { NULL }, 2185, "tcp" },
+ { "onbase-dds", { NULL }, 2185, "udp" },
+ { "gtaua", { NULL }, 2186, "tcp" },
+ { "gtaua", { NULL }, 2186, "udp" },
+ { "ssmc", { NULL }, 2187, "tcp" },
+ { "ssmd", { NULL }, 2187, "udp" },
+ { "tivoconnect", { NULL }, 2190, "tcp" },
+ { "tivoconnect", { NULL }, 2190, "udp" },
+ { "tvbus", { NULL }, 2191, "tcp" },
+ { "tvbus", { NULL }, 2191, "udp" },
+ { "asdis", { NULL }, 2192, "tcp" },
+ { "asdis", { NULL }, 2192, "udp" },
+ { "drwcs", { NULL }, 2193, "tcp" },
+ { "drwcs", { NULL }, 2193, "udp" },
+ { "mnp-exchange", { NULL }, 2197, "tcp" },
+ { "mnp-exchange", { NULL }, 2197, "udp" },
+ { "onehome-remote", { NULL }, 2198, "tcp" },
+ { "onehome-remote", { NULL }, 2198, "udp" },
+ { "onehome-help", { NULL }, 2199, "tcp" },
+ { "onehome-help", { NULL }, 2199, "udp" },
+ { "ici", { NULL }, 2200, "tcp" },
+ { "ici", { NULL }, 2200, "udp" },
+ { "ats", { NULL }, 2201, "tcp" },
+ { "ats", { NULL }, 2201, "udp" },
+ { "imtc-map", { NULL }, 2202, "tcp" },
+ { "imtc-map", { NULL }, 2202, "udp" },
+ { "b2-runtime", { NULL }, 2203, "tcp" },
+ { "b2-runtime", { NULL }, 2203, "udp" },
+ { "b2-license", { NULL }, 2204, "tcp" },
+ { "b2-license", { NULL }, 2204, "udp" },
+ { "jps", { NULL }, 2205, "tcp" },
+ { "jps", { NULL }, 2205, "udp" },
+ { "hpocbus", { NULL }, 2206, "tcp" },
+ { "hpocbus", { NULL }, 2206, "udp" },
+ { "hpssd", { NULL }, 2207, "tcp" },
+ { "hpssd", { NULL }, 2207, "udp" },
+ { "hpiod", { NULL }, 2208, "tcp" },
+ { "hpiod", { NULL }, 2208, "udp" },
+ { "rimf-ps", { NULL }, 2209, "tcp" },
+ { "rimf-ps", { NULL }, 2209, "udp" },
+ { "noaaport", { NULL }, 2210, "tcp" },
+ { "noaaport", { NULL }, 2210, "udp" },
+ { "emwin", { NULL }, 2211, "tcp" },
+ { "emwin", { NULL }, 2211, "udp" },
+ { "leecoposserver", { NULL }, 2212, "tcp" },
+ { "leecoposserver", { NULL }, 2212, "udp" },
+ { "kali", { NULL }, 2213, "tcp" },
+ { "kali", { NULL }, 2213, "udp" },
+ { "rpi", { NULL }, 2214, "tcp" },
+ { "rpi", { NULL }, 2214, "udp" },
+ { "ipcore", { NULL }, 2215, "tcp" },
+ { "ipcore", { NULL }, 2215, "udp" },
+ { "vtu-comms", { NULL }, 2216, "tcp" },
+ { "vtu-comms", { NULL }, 2216, "udp" },
+ { "gotodevice", { NULL }, 2217, "tcp" },
+ { "gotodevice", { NULL }, 2217, "udp" },
+ { "bounzza", { NULL }, 2218, "tcp" },
+ { "bounzza", { NULL }, 2218, "udp" },
+ { "netiq-ncap", { NULL }, 2219, "tcp" },
+ { "netiq-ncap", { NULL }, 2219, "udp" },
+ { "netiq", { NULL }, 2220, "tcp" },
+ { "netiq", { NULL }, 2220, "udp" },
+ { "rockwell-csp1", { NULL }, 2221, "tcp" },
+ { "rockwell-csp1", { NULL }, 2221, "udp" },
+ { "EtherNet/IP-1", { NULL }, 2222, "tcp" },
+ { "EtherNet/IP-1", { NULL }, 2222, "udp" },
+ { "rockwell-csp2", { NULL }, 2223, "tcp" },
+ { "rockwell-csp2", { NULL }, 2223, "udp" },
+ { "efi-mg", { NULL }, 2224, "tcp" },
+ { "efi-mg", { NULL }, 2224, "udp" },
+ { "rcip-itu", { NULL }, 2225, "tcp" },
+ { "rcip-itu", { NULL }, 2225, "sctp"},
+ { "di-drm", { NULL }, 2226, "tcp" },
+ { "di-drm", { NULL }, 2226, "udp" },
+ { "di-msg", { NULL }, 2227, "tcp" },
+ { "di-msg", { NULL }, 2227, "udp" },
+ { "ehome-ms", { NULL }, 2228, "tcp" },
+ { "ehome-ms", { NULL }, 2228, "udp" },
+ { "datalens", { NULL }, 2229, "tcp" },
+ { "datalens", { NULL }, 2229, "udp" },
+ { "queueadm", { NULL }, 2230, "tcp" },
+ { "queueadm", { NULL }, 2230, "udp" },
+ { "wimaxasncp", { NULL }, 2231, "tcp" },
+ { "wimaxasncp", { NULL }, 2231, "udp" },
+ { "ivs-video", { NULL }, 2232, "tcp" },
+ { "ivs-video", { NULL }, 2232, "udp" },
+ { "infocrypt", { NULL }, 2233, "tcp" },
+ { "infocrypt", { NULL }, 2233, "udp" },
+ { "directplay", { NULL }, 2234, "tcp" },
+ { "directplay", { NULL }, 2234, "udp" },
+ { "sercomm-wlink", { NULL }, 2235, "tcp" },
+ { "sercomm-wlink", { NULL }, 2235, "udp" },
+ { "nani", { NULL }, 2236, "tcp" },
+ { "nani", { NULL }, 2236, "udp" },
+ { "optech-port1-lm", { NULL }, 2237, "tcp" },
+ { "optech-port1-lm", { NULL }, 2237, "udp" },
+ { "aviva-sna", { NULL }, 2238, "tcp" },
+ { "aviva-sna", { NULL }, 2238, "udp" },
+ { "imagequery", { NULL }, 2239, "tcp" },
+ { "imagequery", { NULL }, 2239, "udp" },
+ { "recipe", { NULL }, 2240, "tcp" },
+ { "recipe", { NULL }, 2240, "udp" },
+ { "ivsd", { NULL }, 2241, "tcp" },
+ { "ivsd", { NULL }, 2241, "udp" },
+ { "foliocorp", { NULL }, 2242, "tcp" },
+ { "foliocorp", { NULL }, 2242, "udp" },
+ { "magicom", { NULL }, 2243, "tcp" },
+ { "magicom", { NULL }, 2243, "udp" },
+ { "nmsserver", { NULL }, 2244, "tcp" },
+ { "nmsserver", { NULL }, 2244, "udp" },
+ { "hao", { NULL }, 2245, "tcp" },
+ { "hao", { NULL }, 2245, "udp" },
+ { "pc-mta-addrmap", { NULL }, 2246, "tcp" },
+ { "pc-mta-addrmap", { NULL }, 2246, "udp" },
+ { "antidotemgrsvr", { NULL }, 2247, "tcp" },
+ { "antidotemgrsvr", { NULL }, 2247, "udp" },
+ { "ums", { NULL }, 2248, "tcp" },
+ { "ums", { NULL }, 2248, "udp" },
+ { "rfmp", { NULL }, 2249, "tcp" },
+ { "rfmp", { NULL }, 2249, "udp" },
+ { "remote-collab", { NULL }, 2250, "tcp" },
+ { "remote-collab", { NULL }, 2250, "udp" },
+ { "dif-port", { NULL }, 2251, "tcp" },
+ { "dif-port", { NULL }, 2251, "udp" },
+ { "njenet-ssl", { NULL }, 2252, "tcp" },
+ { "njenet-ssl", { NULL }, 2252, "udp" },
+ { "dtv-chan-req", { NULL }, 2253, "tcp" },
+ { "dtv-chan-req", { NULL }, 2253, "udp" },
+ { "seispoc", { NULL }, 2254, "tcp" },
+ { "seispoc", { NULL }, 2254, "udp" },
+ { "vrtp", { NULL }, 2255, "tcp" },
+ { "vrtp", { NULL }, 2255, "udp" },
+ { "pcc-mfp", { NULL }, 2256, "tcp" },
+ { "pcc-mfp", { NULL }, 2256, "udp" },
+ { "simple-tx-rx", { NULL }, 2257, "tcp" },
+ { "simple-tx-rx", { NULL }, 2257, "udp" },
+ { "rcts", { NULL }, 2258, "tcp" },
+ { "rcts", { NULL }, 2258, "udp" },
+ { "acd-pm", { NULL }, 2259, "tcp" },
+ { "acd-pm", { NULL }, 2259, "udp" },
+ { "apc-2260", { NULL }, 2260, "tcp" },
+ { "apc-2260", { NULL }, 2260, "udp" },
+ { "comotionmaster", { NULL }, 2261, "tcp" },
+ { "comotionmaster", { NULL }, 2261, "udp" },
+ { "comotionback", { NULL }, 2262, "tcp" },
+ { "comotionback", { NULL }, 2262, "udp" },
+ { "ecwcfg", { NULL }, 2263, "tcp" },
+ { "ecwcfg", { NULL }, 2263, "udp" },
+ { "apx500api-1", { NULL }, 2264, "tcp" },
+ { "apx500api-1", { NULL }, 2264, "udp" },
+ { "apx500api-2", { NULL }, 2265, "tcp" },
+ { "apx500api-2", { NULL }, 2265, "udp" },
+ { "mfserver", { NULL }, 2266, "tcp" },
+ { "mfserver", { NULL }, 2266, "udp" },
+ { "ontobroker", { NULL }, 2267, "tcp" },
+ { "ontobroker", { NULL }, 2267, "udp" },
+ { "amt", { NULL }, 2268, "tcp" },
+ { "amt", { NULL }, 2268, "udp" },
+ { "mikey", { NULL }, 2269, "tcp" },
+ { "mikey", { NULL }, 2269, "udp" },
+ { "starschool", { NULL }, 2270, "tcp" },
+ { "starschool", { NULL }, 2270, "udp" },
+ { "mmcals", { NULL }, 2271, "tcp" },
+ { "mmcals", { NULL }, 2271, "udp" },
+ { "mmcal", { NULL }, 2272, "tcp" },
+ { "mmcal", { NULL }, 2272, "udp" },
+ { "mysql-im", { NULL }, 2273, "tcp" },
+ { "mysql-im", { NULL }, 2273, "udp" },
+ { "pcttunnell", { NULL }, 2274, "tcp" },
+ { "pcttunnell", { NULL }, 2274, "udp" },
+ { "ibridge-data", { NULL }, 2275, "tcp" },
+ { "ibridge-data", { NULL }, 2275, "udp" },
+ { "ibridge-mgmt", { NULL }, 2276, "tcp" },
+ { "ibridge-mgmt", { NULL }, 2276, "udp" },
+ { "bluectrlproxy", { NULL }, 2277, "tcp" },
+ { "bluectrlproxy", { NULL }, 2277, "udp" },
+ { "s3db", { NULL }, 2278, "tcp" },
+ { "s3db", { NULL }, 2278, "udp" },
+ { "xmquery", { NULL }, 2279, "tcp" },
+ { "xmquery", { NULL }, 2279, "udp" },
+ { "lnvpoller", { NULL }, 2280, "tcp" },
+ { "lnvpoller", { NULL }, 2280, "udp" },
+ { "lnvconsole", { NULL }, 2281, "tcp" },
+ { "lnvconsole", { NULL }, 2281, "udp" },
+ { "lnvalarm", { NULL }, 2282, "tcp" },
+ { "lnvalarm", { NULL }, 2282, "udp" },
+ { "lnvstatus", { NULL }, 2283, "tcp" },
+ { "lnvstatus", { NULL }, 2283, "udp" },
+ { "lnvmaps", { NULL }, 2284, "tcp" },
+ { "lnvmaps", { NULL }, 2284, "udp" },
+ { "lnvmailmon", { NULL }, 2285, "tcp" },
+ { "lnvmailmon", { NULL }, 2285, "udp" },
+ { "nas-metering", { NULL }, 2286, "tcp" },
+ { "nas-metering", { NULL }, 2286, "udp" },
+ { "dna", { NULL }, 2287, "tcp" },
+ { "dna", { NULL }, 2287, "udp" },
+ { "netml", { NULL }, 2288, "tcp" },
+ { "netml", { NULL }, 2288, "udp" },
+ { "dict-lookup", { NULL }, 2289, "tcp" },
+ { "dict-lookup", { NULL }, 2289, "udp" },
+ { "sonus-logging", { NULL }, 2290, "tcp" },
+ { "sonus-logging", { NULL }, 2290, "udp" },
+ { "eapsp", { NULL }, 2291, "tcp" },
+ { "eapsp", { NULL }, 2291, "udp" },
+ { "mib-streaming", { NULL }, 2292, "tcp" },
+ { "mib-streaming", { NULL }, 2292, "udp" },
+ { "npdbgmngr", { NULL }, 2293, "tcp" },
+ { "npdbgmngr", { NULL }, 2293, "udp" },
+ { "konshus-lm", { NULL }, 2294, "tcp" },
+ { "konshus-lm", { NULL }, 2294, "udp" },
+ { "advant-lm", { NULL }, 2295, "tcp" },
+ { "advant-lm", { NULL }, 2295, "udp" },
+ { "theta-lm", { NULL }, 2296, "tcp" },
+ { "theta-lm", { NULL }, 2296, "udp" },
+ { "d2k-datamover1", { NULL }, 2297, "tcp" },
+ { "d2k-datamover1", { NULL }, 2297, "udp" },
+ { "d2k-datamover2", { NULL }, 2298, "tcp" },
+ { "d2k-datamover2", { NULL }, 2298, "udp" },
+ { "pc-telecommute", { NULL }, 2299, "tcp" },
+ { "pc-telecommute", { NULL }, 2299, "udp" },
+ { "cvmmon", { NULL }, 2300, "tcp" },
+ { "cvmmon", { NULL }, 2300, "udp" },
+ { "cpq-wbem", { NULL }, 2301, "tcp" },
+ { "cpq-wbem", { NULL }, 2301, "udp" },
+ { "binderysupport", { NULL }, 2302, "tcp" },
+ { "binderysupport", { NULL }, 2302, "udp" },
+ { "proxy-gateway", { NULL }, 2303, "tcp" },
+ { "proxy-gateway", { NULL }, 2303, "udp" },
+ { "attachmate-uts", { NULL }, 2304, "tcp" },
+ { "attachmate-uts", { NULL }, 2304, "udp" },
+ { "mt-scaleserver", { NULL }, 2305, "tcp" },
+ { "mt-scaleserver", { NULL }, 2305, "udp" },
+ { "tappi-boxnet", { NULL }, 2306, "tcp" },
+ { "tappi-boxnet", { NULL }, 2306, "udp" },
+ { "pehelp", { NULL }, 2307, "tcp" },
+ { "pehelp", { NULL }, 2307, "udp" },
+ { "sdhelp", { NULL }, 2308, "tcp" },
+ { "sdhelp", { NULL }, 2308, "udp" },
+ { "sdserver", { NULL }, 2309, "tcp" },
+ { "sdserver", { NULL }, 2309, "udp" },
+ { "sdclient", { NULL }, 2310, "tcp" },
+ { "sdclient", { NULL }, 2310, "udp" },
+ { "messageservice", { NULL }, 2311, "tcp" },
+ { "messageservice", { NULL }, 2311, "udp" },
+ { "wanscaler", { NULL }, 2312, "tcp" },
+ { "wanscaler", { NULL }, 2312, "udp" },
+ { "iapp", { NULL }, 2313, "tcp" },
+ { "iapp", { NULL }, 2313, "udp" },
+ { "cr-websystems", { NULL }, 2314, "tcp" },
+ { "cr-websystems", { NULL }, 2314, "udp" },
+ { "precise-sft", { NULL }, 2315, "tcp" },
+ { "precise-sft", { NULL }, 2315, "udp" },
+ { "sent-lm", { NULL }, 2316, "tcp" },
+ { "sent-lm", { NULL }, 2316, "udp" },
+ { "attachmate-g32", { NULL }, 2317, "tcp" },
+ { "attachmate-g32", { NULL }, 2317, "udp" },
+ { "cadencecontrol", { NULL }, 2318, "tcp" },
+ { "cadencecontrol", { NULL }, 2318, "udp" },
+ { "infolibria", { NULL }, 2319, "tcp" },
+ { "infolibria", { NULL }, 2319, "udp" },
+ { "siebel-ns", { NULL }, 2320, "tcp" },
+ { "siebel-ns", { NULL }, 2320, "udp" },
+ { "rdlap", { NULL }, 2321, "tcp" },
+ { "rdlap", { NULL }, 2321, "udp" },
+ { "ofsd", { NULL }, 2322, "tcp" },
+ { "ofsd", { NULL }, 2322, "udp" },
+ { "3d-nfsd", { NULL }, 2323, "tcp" },
+ { "3d-nfsd", { NULL }, 2323, "udp" },
+ { "cosmocall", { NULL }, 2324, "tcp" },
+ { "cosmocall", { NULL }, 2324, "udp" },
+ { "ansysli", { NULL }, 2325, "tcp" },
+ { "ansysli", { NULL }, 2325, "udp" },
+ { "idcp", { NULL }, 2326, "tcp" },
+ { "idcp", { NULL }, 2326, "udp" },
+ { "xingcsm", { NULL }, 2327, "tcp" },
+ { "xingcsm", { NULL }, 2327, "udp" },
+ { "netrix-sftm", { NULL }, 2328, "tcp" },
+ { "netrix-sftm", { NULL }, 2328, "udp" },
+ { "nvd", { NULL }, 2329, "tcp" },
+ { "nvd", { NULL }, 2329, "udp" },
+ { "tscchat", { NULL }, 2330, "tcp" },
+ { "tscchat", { NULL }, 2330, "udp" },
+ { "agentview", { NULL }, 2331, "tcp" },
+ { "agentview", { NULL }, 2331, "udp" },
+ { "rcc-host", { NULL }, 2332, "tcp" },
+ { "rcc-host", { NULL }, 2332, "udp" },
+ { "snapp", { NULL }, 2333, "tcp" },
+ { "snapp", { NULL }, 2333, "udp" },
+ { "ace-client", { NULL }, 2334, "tcp" },
+ { "ace-client", { NULL }, 2334, "udp" },
+ { "ace-proxy", { NULL }, 2335, "tcp" },
+ { "ace-proxy", { NULL }, 2335, "udp" },
+ { "appleugcontrol", { NULL }, 2336, "tcp" },
+ { "appleugcontrol", { NULL }, 2336, "udp" },
+ { "ideesrv", { NULL }, 2337, "tcp" },
+ { "ideesrv", { NULL }, 2337, "udp" },
+ { "norton-lambert", { NULL }, 2338, "tcp" },
+ { "norton-lambert", { NULL }, 2338, "udp" },
+ { "3com-webview", { NULL }, 2339, "tcp" },
+ { "3com-webview", { NULL }, 2339, "udp" },
+ { "wrs_registry", { NULL }, 2340, "tcp" },
+ { "wrs_registry", { NULL }, 2340, "udp" },
+ { "xiostatus", { NULL }, 2341, "tcp" },
+ { "xiostatus", { NULL }, 2341, "udp" },
+ { "manage-exec", { NULL }, 2342, "tcp" },
+ { "manage-exec", { NULL }, 2342, "udp" },
+ { "nati-logos", { NULL }, 2343, "tcp" },
+ { "nati-logos", { NULL }, 2343, "udp" },
+ { "fcmsys", { NULL }, 2344, "tcp" },
+ { "fcmsys", { NULL }, 2344, "udp" },
+ { "dbm", { NULL }, 2345, "tcp" },
+ { "dbm", { NULL }, 2345, "udp" },
+ { "redstorm_join", { NULL }, 2346, "tcp" },
+ { "redstorm_join", { NULL }, 2346, "udp" },
+ { "redstorm_find", { NULL }, 2347, "tcp" },
+ { "redstorm_find", { NULL }, 2347, "udp" },
+ { "redstorm_info", { NULL }, 2348, "tcp" },
+ { "redstorm_info", { NULL }, 2348, "udp" },
+ { "redstorm_diag", { NULL }, 2349, "tcp" },
+ { "redstorm_diag", { NULL }, 2349, "udp" },
+ { "psbserver", { NULL }, 2350, "tcp" },
+ { "psbserver", { NULL }, 2350, "udp" },
+ { "psrserver", { NULL }, 2351, "tcp" },
+ { "psrserver", { NULL }, 2351, "udp" },
+ { "pslserver", { NULL }, 2352, "tcp" },
+ { "pslserver", { NULL }, 2352, "udp" },
+ { "pspserver", { NULL }, 2353, "tcp" },
+ { "pspserver", { NULL }, 2353, "udp" },
+ { "psprserver", { NULL }, 2354, "tcp" },
+ { "psprserver", { NULL }, 2354, "udp" },
+ { "psdbserver", { NULL }, 2355, "tcp" },
+ { "psdbserver", { NULL }, 2355, "udp" },
+ { "gxtelmd", { NULL }, 2356, "tcp" },
+ { "gxtelmd", { NULL }, 2356, "udp" },
+ { "unihub-server", { NULL }, 2357, "tcp" },
+ { "unihub-server", { NULL }, 2357, "udp" },
+ { "futrix", { NULL }, 2358, "tcp" },
+ { "futrix", { NULL }, 2358, "udp" },
+ { "flukeserver", { NULL }, 2359, "tcp" },
+ { "flukeserver", { NULL }, 2359, "udp" },
+ { "nexstorindltd", { NULL }, 2360, "tcp" },
+ { "nexstorindltd", { NULL }, 2360, "udp" },
+ { "tl1", { NULL }, 2361, "tcp" },
+ { "tl1", { NULL }, 2361, "udp" },
+ { "digiman", { NULL }, 2362, "tcp" },
+ { "digiman", { NULL }, 2362, "udp" },
+ { "mediacntrlnfsd", { NULL }, 2363, "tcp" },
+ { "mediacntrlnfsd", { NULL }, 2363, "udp" },
+ { "oi-2000", { NULL }, 2364, "tcp" },
+ { "oi-2000", { NULL }, 2364, "udp" },
+ { "dbref", { NULL }, 2365, "tcp" },
+ { "dbref", { NULL }, 2365, "udp" },
+ { "qip-login", { NULL }, 2366, "tcp" },
+ { "qip-login", { NULL }, 2366, "udp" },
+ { "service-ctrl", { NULL }, 2367, "tcp" },
+ { "service-ctrl", { NULL }, 2367, "udp" },
+ { "opentable", { NULL }, 2368, "tcp" },
+ { "opentable", { NULL }, 2368, "udp" },
+ { "l3-hbmon", { NULL }, 2370, "tcp" },
+ { "l3-hbmon", { NULL }, 2370, "udp" },
+ { "worldwire", { NULL }, 2371, "tcp" },
+ { "worldwire", { NULL }, 2371, "udp" },
+ { "lanmessenger", { NULL }, 2372, "tcp" },
+ { "lanmessenger", { NULL }, 2372, "udp" },
+ { "remographlm", { NULL }, 2373, "tcp" },
+ { "hydra", { NULL }, 2374, "tcp" },
+ { "compaq-https", { NULL }, 2381, "tcp" },
+ { "compaq-https", { NULL }, 2381, "udp" },
+ { "ms-olap3", { NULL }, 2382, "tcp" },
+ { "ms-olap3", { NULL }, 2382, "udp" },
+ { "ms-olap4", { NULL }, 2383, "tcp" },
+ { "ms-olap4", { NULL }, 2383, "udp" },
+ { "sd-request", { NULL }, 2384, "tcp" },
+ { "sd-capacity", { NULL }, 2384, "udp" },
+ { "sd-data", { NULL }, 2385, "tcp" },
+ { "sd-data", { NULL }, 2385, "udp" },
+ { "virtualtape", { NULL }, 2386, "tcp" },
+ { "virtualtape", { NULL }, 2386, "udp" },
+ { "vsamredirector", { NULL }, 2387, "tcp" },
+ { "vsamredirector", { NULL }, 2387, "udp" },
+ { "mynahautostart", { NULL }, 2388, "tcp" },
+ { "mynahautostart", { NULL }, 2388, "udp" },
+ { "ovsessionmgr", { NULL }, 2389, "tcp" },
+ { "ovsessionmgr", { NULL }, 2389, "udp" },
+ { "rsmtp", { NULL }, 2390, "tcp" },
+ { "rsmtp", { NULL }, 2390, "udp" },
+ { "3com-net-mgmt", { NULL }, 2391, "tcp" },
+ { "3com-net-mgmt", { NULL }, 2391, "udp" },
+ { "tacticalauth", { NULL }, 2392, "tcp" },
+ { "tacticalauth", { NULL }, 2392, "udp" },
+ { "ms-olap1", { NULL }, 2393, "tcp" },
+ { "ms-olap1", { NULL }, 2393, "udp" },
+ { "ms-olap2", { NULL }, 2394, "tcp" },
+ { "ms-olap2", { NULL }, 2394, "udp" },
+ { "lan900_remote", { NULL }, 2395, "tcp" },
+ { "lan900_remote", { NULL }, 2395, "udp" },
+ { "wusage", { NULL }, 2396, "tcp" },
+ { "wusage", { NULL }, 2396, "udp" },
+ { "ncl", { NULL }, 2397, "tcp" },
+ { "ncl", { NULL }, 2397, "udp" },
+ { "orbiter", { NULL }, 2398, "tcp" },
+ { "orbiter", { NULL }, 2398, "udp" },
+ { "fmpro-fdal", { NULL }, 2399, "tcp" },
+ { "fmpro-fdal", { NULL }, 2399, "udp" },
+ { "opequus-server", { NULL }, 2400, "tcp" },
+ { "opequus-server", { NULL }, 2400, "udp" },
+ { "cvspserver", { NULL }, 2401, "tcp" },
+ { "cvspserver", { NULL }, 2401, "udp" },
+ { "taskmaster2000", { NULL }, 2402, "tcp" },
+ { "taskmaster2000", { NULL }, 2402, "udp" },
+ { "taskmaster2000", { NULL }, 2403, "tcp" },
+ { "taskmaster2000", { NULL }, 2403, "udp" },
+ { "iec-104", { NULL }, 2404, "tcp" },
+ { "iec-104", { NULL }, 2404, "udp" },
+ { "trc-netpoll", { NULL }, 2405, "tcp" },
+ { "trc-netpoll", { NULL }, 2405, "udp" },
+ { "jediserver", { NULL }, 2406, "tcp" },
+ { "jediserver", { NULL }, 2406, "udp" },
+ { "orion", { NULL }, 2407, "tcp" },
+ { "orion", { NULL }, 2407, "udp" },
+ { "optimanet", { NULL }, 2408, "tcp" },
+ { "optimanet", { NULL }, 2408, "udp" },
+ { "sns-protocol", { NULL }, 2409, "tcp" },
+ { "sns-protocol", { NULL }, 2409, "udp" },
+ { "vrts-registry", { NULL }, 2410, "tcp" },
+ { "vrts-registry", { NULL }, 2410, "udp" },
+ { "netwave-ap-mgmt", { NULL }, 2411, "tcp" },
+ { "netwave-ap-mgmt", { NULL }, 2411, "udp" },
+ { "cdn", { NULL }, 2412, "tcp" },
+ { "cdn", { NULL }, 2412, "udp" },
+ { "orion-rmi-reg", { NULL }, 2413, "tcp" },
+ { "orion-rmi-reg", { NULL }, 2413, "udp" },
+ { "beeyond", { NULL }, 2414, "tcp" },
+ { "beeyond", { NULL }, 2414, "udp" },
+ { "codima-rtp", { NULL }, 2415, "tcp" },
+ { "codima-rtp", { NULL }, 2415, "udp" },
+ { "rmtserver", { NULL }, 2416, "tcp" },
+ { "rmtserver", { NULL }, 2416, "udp" },
+ { "composit-server", { NULL }, 2417, "tcp" },
+ { "composit-server", { NULL }, 2417, "udp" },
+ { "cas", { NULL }, 2418, "tcp" },
+ { "cas", { NULL }, 2418, "udp" },
+ { "attachmate-s2s", { NULL }, 2419, "tcp" },
+ { "attachmate-s2s", { NULL }, 2419, "udp" },
+ { "dslremote-mgmt", { NULL }, 2420, "tcp" },
+ { "dslremote-mgmt", { NULL }, 2420, "udp" },
+ { "g-talk", { NULL }, 2421, "tcp" },
+ { "g-talk", { NULL }, 2421, "udp" },
+ { "crmsbits", { NULL }, 2422, "tcp" },
+ { "crmsbits", { NULL }, 2422, "udp" },
+ { "rnrp", { NULL }, 2423, "tcp" },
+ { "rnrp", { NULL }, 2423, "udp" },
+ { "kofax-svr", { NULL }, 2424, "tcp" },
+ { "kofax-svr", { NULL }, 2424, "udp" },
+ { "fjitsuappmgr", { NULL }, 2425, "tcp" },
+ { "fjitsuappmgr", { NULL }, 2425, "udp" },
+ { "mgcp-gateway", { NULL }, 2427, "tcp" },
+ { "mgcp-gateway", { NULL }, 2427, "udp" },
+ { "ott", { NULL }, 2428, "tcp" },
+ { "ott", { NULL }, 2428, "udp" },
+ { "ft-role", { NULL }, 2429, "tcp" },
+ { "ft-role", { NULL }, 2429, "udp" },
+ { "venus", { NULL }, 2430, "tcp" },
+ { "venus", { NULL }, 2430, "udp" },
+ { "venus-se", { NULL }, 2431, "tcp" },
+ { "venus-se", { NULL }, 2431, "udp" },
+ { "codasrv", { NULL }, 2432, "tcp" },
+ { "codasrv", { NULL }, 2432, "udp" },
+ { "codasrv-se", { NULL }, 2433, "tcp" },
+ { "codasrv-se", { NULL }, 2433, "udp" },
+ { "pxc-epmap", { NULL }, 2434, "tcp" },
+ { "pxc-epmap", { NULL }, 2434, "udp" },
+ { "optilogic", { NULL }, 2435, "tcp" },
+ { "optilogic", { NULL }, 2435, "udp" },
+ { "topx", { NULL }, 2436, "tcp" },
+ { "topx", { NULL }, 2436, "udp" },
+ { "unicontrol", { NULL }, 2437, "tcp" },
+ { "unicontrol", { NULL }, 2437, "udp" },
+ { "msp", { NULL }, 2438, "tcp" },
+ { "msp", { NULL }, 2438, "udp" },
+ { "sybasedbsynch", { NULL }, 2439, "tcp" },
+ { "sybasedbsynch", { NULL }, 2439, "udp" },
+ { "spearway", { NULL }, 2440, "tcp" },
+ { "spearway", { NULL }, 2440, "udp" },
+ { "pvsw-inet", { NULL }, 2441, "tcp" },
+ { "pvsw-inet", { NULL }, 2441, "udp" },
+ { "netangel", { NULL }, 2442, "tcp" },
+ { "netangel", { NULL }, 2442, "udp" },
+ { "powerclientcsf", { NULL }, 2443, "tcp" },
+ { "powerclientcsf", { NULL }, 2443, "udp" },
+ { "btpp2sectrans", { NULL }, 2444, "tcp" },
+ { "btpp2sectrans", { NULL }, 2444, "udp" },
+ { "dtn1", { NULL }, 2445, "tcp" },
+ { "dtn1", { NULL }, 2445, "udp" },
+ { "bues_service", { NULL }, 2446, "tcp" },
+ { "bues_service", { NULL }, 2446, "udp" },
+ { "ovwdb", { NULL }, 2447, "tcp" },
+ { "ovwdb", { NULL }, 2447, "udp" },
+ { "hpppssvr", { NULL }, 2448, "tcp" },
+ { "hpppssvr", { NULL }, 2448, "udp" },
+ { "ratl", { NULL }, 2449, "tcp" },
+ { "ratl", { NULL }, 2449, "udp" },
+ { "netadmin", { NULL }, 2450, "tcp" },
+ { "netadmin", { NULL }, 2450, "udp" },
+ { "netchat", { NULL }, 2451, "tcp" },
+ { "netchat", { NULL }, 2451, "udp" },
+ { "snifferclient", { NULL }, 2452, "tcp" },
+ { "snifferclient", { NULL }, 2452, "udp" },
+ { "madge-ltd", { NULL }, 2453, "tcp" },
+ { "madge-ltd", { NULL }, 2453, "udp" },
+ { "indx-dds", { NULL }, 2454, "tcp" },
+ { "indx-dds", { NULL }, 2454, "udp" },
+ { "wago-io-system", { NULL }, 2455, "tcp" },
+ { "wago-io-system", { NULL }, 2455, "udp" },
+ { "altav-remmgt", { NULL }, 2456, "tcp" },
+ { "altav-remmgt", { NULL }, 2456, "udp" },
+ { "rapido-ip", { NULL }, 2457, "tcp" },
+ { "rapido-ip", { NULL }, 2457, "udp" },
+ { "griffin", { NULL }, 2458, "tcp" },
+ { "griffin", { NULL }, 2458, "udp" },
+ { "community", { NULL }, 2459, "tcp" },
+ { "community", { NULL }, 2459, "udp" },
+ { "ms-theater", { NULL }, 2460, "tcp" },
+ { "ms-theater", { NULL }, 2460, "udp" },
+ { "qadmifoper", { NULL }, 2461, "tcp" },
+ { "qadmifoper", { NULL }, 2461, "udp" },
+ { "qadmifevent", { NULL }, 2462, "tcp" },
+ { "qadmifevent", { NULL }, 2462, "udp" },
+ { "lsi-raid-mgmt", { NULL }, 2463, "tcp" },
+ { "lsi-raid-mgmt", { NULL }, 2463, "udp" },
+ { "direcpc-si", { NULL }, 2464, "tcp" },
+ { "direcpc-si", { NULL }, 2464, "udp" },
+ { "lbm", { NULL }, 2465, "tcp" },
+ { "lbm", { NULL }, 2465, "udp" },
+ { "lbf", { NULL }, 2466, "tcp" },
+ { "lbf", { NULL }, 2466, "udp" },
+ { "high-criteria", { NULL }, 2467, "tcp" },
+ { "high-criteria", { NULL }, 2467, "udp" },
+ { "qip-msgd", { NULL }, 2468, "tcp" },
+ { "qip-msgd", { NULL }, 2468, "udp" },
+ { "mti-tcs-comm", { NULL }, 2469, "tcp" },
+ { "mti-tcs-comm", { NULL }, 2469, "udp" },
+ { "taskman-port", { NULL }, 2470, "tcp" },
+ { "taskman-port", { NULL }, 2470, "udp" },
+ { "seaodbc", { NULL }, 2471, "tcp" },
+ { "seaodbc", { NULL }, 2471, "udp" },
+ { "c3", { NULL }, 2472, "tcp" },
+ { "c3", { NULL }, 2472, "udp" },
+ { "aker-cdp", { NULL }, 2473, "tcp" },
+ { "aker-cdp", { NULL }, 2473, "udp" },
+ { "vitalanalysis", { NULL }, 2474, "tcp" },
+ { "vitalanalysis", { NULL }, 2474, "udp" },
+ { "ace-server", { NULL }, 2475, "tcp" },
+ { "ace-server", { NULL }, 2475, "udp" },
+ { "ace-svr-prop", { NULL }, 2476, "tcp" },
+ { "ace-svr-prop", { NULL }, 2476, "udp" },
+ { "ssm-cvs", { NULL }, 2477, "tcp" },
+ { "ssm-cvs", { NULL }, 2477, "udp" },
+ { "ssm-cssps", { NULL }, 2478, "tcp" },
+ { "ssm-cssps", { NULL }, 2478, "udp" },
+ { "ssm-els", { NULL }, 2479, "tcp" },
+ { "ssm-els", { NULL }, 2479, "udp" },
+ { "powerexchange", { NULL }, 2480, "tcp" },
+ { "powerexchange", { NULL }, 2480, "udp" },
+ { "giop", { NULL }, 2481, "tcp" },
+ { "giop", { NULL }, 2481, "udp" },
+ { "giop-ssl", { NULL }, 2482, "tcp" },
+ { "giop-ssl", { NULL }, 2482, "udp" },
+ { "ttc", { NULL }, 2483, "tcp" },
+ { "ttc", { NULL }, 2483, "udp" },
+ { "ttc-ssl", { NULL }, 2484, "tcp" },
+ { "ttc-ssl", { NULL }, 2484, "udp" },
+ { "netobjects1", { NULL }, 2485, "tcp" },
+ { "netobjects1", { NULL }, 2485, "udp" },
+ { "netobjects2", { NULL }, 2486, "tcp" },
+ { "netobjects2", { NULL }, 2486, "udp" },
+ { "pns", { NULL }, 2487, "tcp" },
+ { "pns", { NULL }, 2487, "udp" },
+ { "moy-corp", { NULL }, 2488, "tcp" },
+ { "moy-corp", { NULL }, 2488, "udp" },
+ { "tsilb", { NULL }, 2489, "tcp" },
+ { "tsilb", { NULL }, 2489, "udp" },
+ { "qip-qdhcp", { NULL }, 2490, "tcp" },
+ { "qip-qdhcp", { NULL }, 2490, "udp" },
+ { "conclave-cpp", { NULL }, 2491, "tcp" },
+ { "conclave-cpp", { NULL }, 2491, "udp" },
+ { "groove", { NULL }, 2492, "tcp" },
+ { "groove", { NULL }, 2492, "udp" },
+ { "talarian-mqs", { NULL }, 2493, "tcp" },
+ { "talarian-mqs", { NULL }, 2493, "udp" },
+ { "bmc-ar", { NULL }, 2494, "tcp" },
+ { "bmc-ar", { NULL }, 2494, "udp" },
+ { "fast-rem-serv", { NULL }, 2495, "tcp" },
+ { "fast-rem-serv", { NULL }, 2495, "udp" },
+ { "dirgis", { NULL }, 2496, "tcp" },
+ { "dirgis", { NULL }, 2496, "udp" },
+ { "quaddb", { NULL }, 2497, "tcp" },
+ { "quaddb", { NULL }, 2497, "udp" },
+ { "odn-castraq", { NULL }, 2498, "tcp" },
+ { "odn-castraq", { NULL }, 2498, "udp" },
+ { "unicontrol", { NULL }, 2499, "tcp" },
+ { "unicontrol", { NULL }, 2499, "udp" },
+ { "rtsserv", { NULL }, 2500, "tcp" },
+ { "rtsserv", { NULL }, 2500, "udp" },
+ { "rtsclient", { NULL }, 2501, "tcp" },
+ { "rtsclient", { NULL }, 2501, "udp" },
+ { "kentrox-prot", { NULL }, 2502, "tcp" },
+ { "kentrox-prot", { NULL }, 2502, "udp" },
+ { "nms-dpnss", { NULL }, 2503, "tcp" },
+ { "nms-dpnss", { NULL }, 2503, "udp" },
+ { "wlbs", { NULL }, 2504, "tcp" },
+ { "wlbs", { NULL }, 2504, "udp" },
+ { "ppcontrol", { NULL }, 2505, "tcp" },
+ { "ppcontrol", { NULL }, 2505, "udp" },
+ { "jbroker", { NULL }, 2506, "tcp" },
+ { "jbroker", { NULL }, 2506, "udp" },
+ { "spock", { NULL }, 2507, "tcp" },
+ { "spock", { NULL }, 2507, "udp" },
+ { "jdatastore", { NULL }, 2508, "tcp" },
+ { "jdatastore", { NULL }, 2508, "udp" },
+ { "fjmpss", { NULL }, 2509, "tcp" },
+ { "fjmpss", { NULL }, 2509, "udp" },
+ { "fjappmgrbulk", { NULL }, 2510, "tcp" },
+ { "fjappmgrbulk", { NULL }, 2510, "udp" },
+ { "metastorm", { NULL }, 2511, "tcp" },
+ { "metastorm", { NULL }, 2511, "udp" },
+ { "citrixima", { NULL }, 2512, "tcp" },
+ { "citrixima", { NULL }, 2512, "udp" },
+ { "citrixadmin", { NULL }, 2513, "tcp" },
+ { "citrixadmin", { NULL }, 2513, "udp" },
+ { "facsys-ntp", { NULL }, 2514, "tcp" },
+ { "facsys-ntp", { NULL }, 2514, "udp" },
+ { "facsys-router", { NULL }, 2515, "tcp" },
+ { "facsys-router", { NULL }, 2515, "udp" },
+ { "maincontrol", { NULL }, 2516, "tcp" },
+ { "maincontrol", { NULL }, 2516, "udp" },
+ { "call-sig-trans", { NULL }, 2517, "tcp" },
+ { "call-sig-trans", { NULL }, 2517, "udp" },
+ { "willy", { NULL }, 2518, "tcp" },
+ { "willy", { NULL }, 2518, "udp" },
+ { "globmsgsvc", { NULL }, 2519, "tcp" },
+ { "globmsgsvc", { NULL }, 2519, "udp" },
+ { "pvsw", { NULL }, 2520, "tcp" },
+ { "pvsw", { NULL }, 2520, "udp" },
+ { "adaptecmgr", { NULL }, 2521, "tcp" },
+ { "adaptecmgr", { NULL }, 2521, "udp" },
+ { "windb", { NULL }, 2522, "tcp" },
+ { "windb", { NULL }, 2522, "udp" },
+ { "qke-llc-v3", { NULL }, 2523, "tcp" },
+ { "qke-llc-v3", { NULL }, 2523, "udp" },
+ { "optiwave-lm", { NULL }, 2524, "tcp" },
+ { "optiwave-lm", { NULL }, 2524, "udp" },
+ { "ms-v-worlds", { NULL }, 2525, "tcp" },
+ { "ms-v-worlds", { NULL }, 2525, "udp" },
+ { "ema-sent-lm", { NULL }, 2526, "tcp" },
+ { "ema-sent-lm", { NULL }, 2526, "udp" },
+ { "iqserver", { NULL }, 2527, "tcp" },
+ { "iqserver", { NULL }, 2527, "udp" },
+ { "ncr_ccl", { NULL }, 2528, "tcp" },
+ { "ncr_ccl", { NULL }, 2528, "udp" },
+ { "utsftp", { NULL }, 2529, "tcp" },
+ { "utsftp", { NULL }, 2529, "udp" },
+ { "vrcommerce", { NULL }, 2530, "tcp" },
+ { "vrcommerce", { NULL }, 2530, "udp" },
+ { "ito-e-gui", { NULL }, 2531, "tcp" },
+ { "ito-e-gui", { NULL }, 2531, "udp" },
+ { "ovtopmd", { NULL }, 2532, "tcp" },
+ { "ovtopmd", { NULL }, 2532, "udp" },
+ { "snifferserver", { NULL }, 2533, "tcp" },
+ { "snifferserver", { NULL }, 2533, "udp" },
+ { "combox-web-acc", { NULL }, 2534, "tcp" },
+ { "combox-web-acc", { NULL }, 2534, "udp" },
+ { "madcap", { NULL }, 2535, "tcp" },
+ { "madcap", { NULL }, 2535, "udp" },
+ { "btpp2audctr1", { NULL }, 2536, "tcp" },
+ { "btpp2audctr1", { NULL }, 2536, "udp" },
+ { "upgrade", { NULL }, 2537, "tcp" },
+ { "upgrade", { NULL }, 2537, "udp" },
+ { "vnwk-prapi", { NULL }, 2538, "tcp" },
+ { "vnwk-prapi", { NULL }, 2538, "udp" },
+ { "vsiadmin", { NULL }, 2539, "tcp" },
+ { "vsiadmin", { NULL }, 2539, "udp" },
+ { "lonworks", { NULL }, 2540, "tcp" },
+ { "lonworks", { NULL }, 2540, "udp" },
+ { "lonworks2", { NULL }, 2541, "tcp" },
+ { "lonworks2", { NULL }, 2541, "udp" },
+ { "udrawgraph", { NULL }, 2542, "tcp" },
+ { "udrawgraph", { NULL }, 2542, "udp" },
+ { "reftek", { NULL }, 2543, "tcp" },
+ { "reftek", { NULL }, 2543, "udp" },
+ { "novell-zen", { NULL }, 2544, "tcp" },
+ { "novell-zen", { NULL }, 2544, "udp" },
+ { "sis-emt", { NULL }, 2545, "tcp" },
+ { "sis-emt", { NULL }, 2545, "udp" },
+ { "vytalvaultbrtp", { NULL }, 2546, "tcp" },
+ { "vytalvaultbrtp", { NULL }, 2546, "udp" },
+ { "vytalvaultvsmp", { NULL }, 2547, "tcp" },
+ { "vytalvaultvsmp", { NULL }, 2547, "udp" },
+ { "vytalvaultpipe", { NULL }, 2548, "tcp" },
+ { "vytalvaultpipe", { NULL }, 2548, "udp" },
+ { "ipass", { NULL }, 2549, "tcp" },
+ { "ipass", { NULL }, 2549, "udp" },
+ { "ads", { NULL }, 2550, "tcp" },
+ { "ads", { NULL }, 2550, "udp" },
+ { "isg-uda-server", { NULL }, 2551, "tcp" },
+ { "isg-uda-server", { NULL }, 2551, "udp" },
+ { "call-logging", { NULL }, 2552, "tcp" },
+ { "call-logging", { NULL }, 2552, "udp" },
+ { "efidiningport", { NULL }, 2553, "tcp" },
+ { "efidiningport", { NULL }, 2553, "udp" },
+ { "vcnet-link-v10", { NULL }, 2554, "tcp" },
+ { "vcnet-link-v10", { NULL }, 2554, "udp" },
+ { "compaq-wcp", { NULL }, 2555, "tcp" },
+ { "compaq-wcp", { NULL }, 2555, "udp" },
+ { "nicetec-nmsvc", { NULL }, 2556, "tcp" },
+ { "nicetec-nmsvc", { NULL }, 2556, "udp" },
+ { "nicetec-mgmt", { NULL }, 2557, "tcp" },
+ { "nicetec-mgmt", { NULL }, 2557, "udp" },
+ { "pclemultimedia", { NULL }, 2558, "tcp" },
+ { "pclemultimedia", { NULL }, 2558, "udp" },
+ { "lstp", { NULL }, 2559, "tcp" },
+ { "lstp", { NULL }, 2559, "udp" },
+ { "labrat", { NULL }, 2560, "tcp" },
+ { "labrat", { NULL }, 2560, "udp" },
+ { "mosaixcc", { NULL }, 2561, "tcp" },
+ { "mosaixcc", { NULL }, 2561, "udp" },
+ { "delibo", { NULL }, 2562, "tcp" },
+ { "delibo", { NULL }, 2562, "udp" },
+ { "cti-redwood", { NULL }, 2563, "tcp" },
+ { "cti-redwood", { NULL }, 2563, "udp" },
+ { "hp-3000-telnet", { NULL }, 2564, "tcp" },
+ { "coord-svr", { NULL }, 2565, "tcp" },
+ { "coord-svr", { NULL }, 2565, "udp" },
+ { "pcs-pcw", { NULL }, 2566, "tcp" },
+ { "pcs-pcw", { NULL }, 2566, "udp" },
+ { "clp", { NULL }, 2567, "tcp" },
+ { "clp", { NULL }, 2567, "udp" },
+ { "spamtrap", { NULL }, 2568, "tcp" },
+ { "spamtrap", { NULL }, 2568, "udp" },
+ { "sonuscallsig", { NULL }, 2569, "tcp" },
+ { "sonuscallsig", { NULL }, 2569, "udp" },
+ { "hs-port", { NULL }, 2570, "tcp" },
+ { "hs-port", { NULL }, 2570, "udp" },
+ { "cecsvc", { NULL }, 2571, "tcp" },
+ { "cecsvc", { NULL }, 2571, "udp" },
+ { "ibp", { NULL }, 2572, "tcp" },
+ { "ibp", { NULL }, 2572, "udp" },
+ { "trustestablish", { NULL }, 2573, "tcp" },
+ { "trustestablish", { NULL }, 2573, "udp" },
+ { "blockade-bpsp", { NULL }, 2574, "tcp" },
+ { "blockade-bpsp", { NULL }, 2574, "udp" },
+ { "hl7", { NULL }, 2575, "tcp" },
+ { "hl7", { NULL }, 2575, "udp" },
+ { "tclprodebugger", { NULL }, 2576, "tcp" },
+ { "tclprodebugger", { NULL }, 2576, "udp" },
+ { "scipticslsrvr", { NULL }, 2577, "tcp" },
+ { "scipticslsrvr", { NULL }, 2577, "udp" },
+ { "rvs-isdn-dcp", { NULL }, 2578, "tcp" },
+ { "rvs-isdn-dcp", { NULL }, 2578, "udp" },
+ { "mpfoncl", { NULL }, 2579, "tcp" },
+ { "mpfoncl", { NULL }, 2579, "udp" },
+ { "tributary", { NULL }, 2580, "tcp" },
+ { "tributary", { NULL }, 2580, "udp" },
+ { "argis-te", { NULL }, 2581, "tcp" },
+ { "argis-te", { NULL }, 2581, "udp" },
+ { "argis-ds", { NULL }, 2582, "tcp" },
+ { "argis-ds", { NULL }, 2582, "udp" },
+ { "mon", { NULL }, 2583, "tcp" },
+ { "mon", { NULL }, 2583, "udp" },
+ { "cyaserv", { NULL }, 2584, "tcp" },
+ { "cyaserv", { NULL }, 2584, "udp" },
+ { "netx-server", { NULL }, 2585, "tcp" },
+ { "netx-server", { NULL }, 2585, "udp" },
+ { "netx-agent", { NULL }, 2586, "tcp" },
+ { "netx-agent", { NULL }, 2586, "udp" },
+ { "masc", { NULL }, 2587, "tcp" },
+ { "masc", { NULL }, 2587, "udp" },
+ { "privilege", { NULL }, 2588, "tcp" },
+ { "privilege", { NULL }, 2588, "udp" },
+ { "quartus-tcl", { NULL }, 2589, "tcp" },
+ { "quartus-tcl", { NULL }, 2589, "udp" },
+ { "idotdist", { NULL }, 2590, "tcp" },
+ { "idotdist", { NULL }, 2590, "udp" },
+ { "maytagshuffle", { NULL }, 2591, "tcp" },
+ { "maytagshuffle", { NULL }, 2591, "udp" },
+ { "netrek", { NULL }, 2592, "tcp" },
+ { "netrek", { NULL }, 2592, "udp" },
+ { "mns-mail", { NULL }, 2593, "tcp" },
+ { "mns-mail", { NULL }, 2593, "udp" },
+ { "dts", { NULL }, 2594, "tcp" },
+ { "dts", { NULL }, 2594, "udp" },
+ { "worldfusion1", { NULL }, 2595, "tcp" },
+ { "worldfusion1", { NULL }, 2595, "udp" },
+ { "worldfusion2", { NULL }, 2596, "tcp" },
+ { "worldfusion2", { NULL }, 2596, "udp" },
+ { "homesteadglory", { NULL }, 2597, "tcp" },
+ { "homesteadglory", { NULL }, 2597, "udp" },
+ { "citriximaclient", { NULL }, 2598, "tcp" },
+ { "citriximaclient", { NULL }, 2598, "udp" },
+ { "snapd", { NULL }, 2599, "tcp" },
+ { "snapd", { NULL }, 2599, "udp" },
+ { "hpstgmgr", { NULL }, 2600, "tcp" },
+ { "hpstgmgr", { NULL }, 2600, "udp" },
+ { "discp-client", { NULL }, 2601, "tcp" },
+ { "discp-client", { NULL }, 2601, "udp" },
+ { "discp-server", { NULL }, 2602, "tcp" },
+ { "discp-server", { NULL }, 2602, "udp" },
+ { "servicemeter", { NULL }, 2603, "tcp" },
+ { "servicemeter", { NULL }, 2603, "udp" },
+ { "nsc-ccs", { NULL }, 2604, "tcp" },
+ { "nsc-ccs", { NULL }, 2604, "udp" },
+ { "nsc-posa", { NULL }, 2605, "tcp" },
+ { "nsc-posa", { NULL }, 2605, "udp" },
+ { "netmon", { NULL }, 2606, "tcp" },
+ { "netmon", { NULL }, 2606, "udp" },
+ { "connection", { NULL }, 2607, "tcp" },
+ { "connection", { NULL }, 2607, "udp" },
+ { "wag-service", { NULL }, 2608, "tcp" },
+ { "wag-service", { NULL }, 2608, "udp" },
+ { "system-monitor", { NULL }, 2609, "tcp" },
+ { "system-monitor", { NULL }, 2609, "udp" },
+ { "versa-tek", { NULL }, 2610, "tcp" },
+ { "versa-tek", { NULL }, 2610, "udp" },
+ { "lionhead", { NULL }, 2611, "tcp" },
+ { "lionhead", { NULL }, 2611, "udp" },
+ { "qpasa-agent", { NULL }, 2612, "tcp" },
+ { "qpasa-agent", { NULL }, 2612, "udp" },
+ { "smntubootstrap", { NULL }, 2613, "tcp" },
+ { "smntubootstrap", { NULL }, 2613, "udp" },
+ { "neveroffline", { NULL }, 2614, "tcp" },
+ { "neveroffline", { NULL }, 2614, "udp" },
+ { "firepower", { NULL }, 2615, "tcp" },
+ { "firepower", { NULL }, 2615, "udp" },
+ { "appswitch-emp", { NULL }, 2616, "tcp" },
+ { "appswitch-emp", { NULL }, 2616, "udp" },
+ { "cmadmin", { NULL }, 2617, "tcp" },
+ { "cmadmin", { NULL }, 2617, "udp" },
+ { "priority-e-com", { NULL }, 2618, "tcp" },
+ { "priority-e-com", { NULL }, 2618, "udp" },
+ { "bruce", { NULL }, 2619, "tcp" },
+ { "bruce", { NULL }, 2619, "udp" },
+ { "lpsrecommender", { NULL }, 2620, "tcp" },
+ { "lpsrecommender", { NULL }, 2620, "udp" },
+ { "miles-apart", { NULL }, 2621, "tcp" },
+ { "miles-apart", { NULL }, 2621, "udp" },
+ { "metricadbc", { NULL }, 2622, "tcp" },
+ { "metricadbc", { NULL }, 2622, "udp" },
+ { "lmdp", { NULL }, 2623, "tcp" },
+ { "lmdp", { NULL }, 2623, "udp" },
+ { "aria", { NULL }, 2624, "tcp" },
+ { "aria", { NULL }, 2624, "udp" },
+ { "blwnkl-port", { NULL }, 2625, "tcp" },
+ { "blwnkl-port", { NULL }, 2625, "udp" },
+ { "gbjd816", { NULL }, 2626, "tcp" },
+ { "gbjd816", { NULL }, 2626, "udp" },
+ { "moshebeeri", { NULL }, 2627, "tcp" },
+ { "moshebeeri", { NULL }, 2627, "udp" },
+ { "dict", { NULL }, 2628, "tcp" },
+ { "dict", { NULL }, 2628, "udp" },
+ { "sitaraserver", { NULL }, 2629, "tcp" },
+ { "sitaraserver", { NULL }, 2629, "udp" },
+ { "sitaramgmt", { NULL }, 2630, "tcp" },
+ { "sitaramgmt", { NULL }, 2630, "udp" },
+ { "sitaradir", { NULL }, 2631, "tcp" },
+ { "sitaradir", { NULL }, 2631, "udp" },
+ { "irdg-post", { NULL }, 2632, "tcp" },
+ { "irdg-post", { NULL }, 2632, "udp" },
+ { "interintelli", { NULL }, 2633, "tcp" },
+ { "interintelli", { NULL }, 2633, "udp" },
+ { "pk-electronics", { NULL }, 2634, "tcp" },
+ { "pk-electronics", { NULL }, 2634, "udp" },
+ { "backburner", { NULL }, 2635, "tcp" },
+ { "backburner", { NULL }, 2635, "udp" },
+ { "solve", { NULL }, 2636, "tcp" },
+ { "solve", { NULL }, 2636, "udp" },
+ { "imdocsvc", { NULL }, 2637, "tcp" },
+ { "imdocsvc", { NULL }, 2637, "udp" },
+ { "sybaseanywhere", { NULL }, 2638, "tcp" },
+ { "sybaseanywhere", { NULL }, 2638, "udp" },
+ { "aminet", { NULL }, 2639, "tcp" },
+ { "aminet", { NULL }, 2639, "udp" },
+ { "sai_sentlm", { NULL }, 2640, "tcp" },
+ { "sai_sentlm", { NULL }, 2640, "udp" },
+ { "hdl-srv", { NULL }, 2641, "tcp" },
+ { "hdl-srv", { NULL }, 2641, "udp" },
+ { "tragic", { NULL }, 2642, "tcp" },
+ { "tragic", { NULL }, 2642, "udp" },
+ { "gte-samp", { NULL }, 2643, "tcp" },
+ { "gte-samp", { NULL }, 2643, "udp" },
+ { "travsoft-ipx-t", { NULL }, 2644, "tcp" },
+ { "travsoft-ipx-t", { NULL }, 2644, "udp" },
+ { "novell-ipx-cmd", { NULL }, 2645, "tcp" },
+ { "novell-ipx-cmd", { NULL }, 2645, "udp" },
+ { "and-lm", { NULL }, 2646, "tcp" },
+ { "and-lm", { NULL }, 2646, "udp" },
+ { "syncserver", { NULL }, 2647, "tcp" },
+ { "syncserver", { NULL }, 2647, "udp" },
+ { "upsnotifyprot", { NULL }, 2648, "tcp" },
+ { "upsnotifyprot", { NULL }, 2648, "udp" },
+ { "vpsipport", { NULL }, 2649, "tcp" },
+ { "vpsipport", { NULL }, 2649, "udp" },
+ { "eristwoguns", { NULL }, 2650, "tcp" },
+ { "eristwoguns", { NULL }, 2650, "udp" },
+ { "ebinsite", { NULL }, 2651, "tcp" },
+ { "ebinsite", { NULL }, 2651, "udp" },
+ { "interpathpanel", { NULL }, 2652, "tcp" },
+ { "interpathpanel", { NULL }, 2652, "udp" },
+ { "sonus", { NULL }, 2653, "tcp" },
+ { "sonus", { NULL }, 2653, "udp" },
+ { "corel_vncadmin", { NULL }, 2654, "tcp" },
+ { "corel_vncadmin", { NULL }, 2654, "udp" },
+ { "unglue", { NULL }, 2655, "tcp" },
+ { "unglue", { NULL }, 2655, "udp" },
+ { "kana", { NULL }, 2656, "tcp" },
+ { "kana", { NULL }, 2656, "udp" },
+ { "sns-dispatcher", { NULL }, 2657, "tcp" },
+ { "sns-dispatcher", { NULL }, 2657, "udp" },
+ { "sns-admin", { NULL }, 2658, "tcp" },
+ { "sns-admin", { NULL }, 2658, "udp" },
+ { "sns-query", { NULL }, 2659, "tcp" },
+ { "sns-query", { NULL }, 2659, "udp" },
+ { "gcmonitor", { NULL }, 2660, "tcp" },
+ { "gcmonitor", { NULL }, 2660, "udp" },
+ { "olhost", { NULL }, 2661, "tcp" },
+ { "olhost", { NULL }, 2661, "udp" },
+ { "bintec-capi", { NULL }, 2662, "tcp" },
+ { "bintec-capi", { NULL }, 2662, "udp" },
+ { "bintec-tapi", { NULL }, 2663, "tcp" },
+ { "bintec-tapi", { NULL }, 2663, "udp" },
+ { "patrol-mq-gm", { NULL }, 2664, "tcp" },
+ { "patrol-mq-gm", { NULL }, 2664, "udp" },
+ { "patrol-mq-nm", { NULL }, 2665, "tcp" },
+ { "patrol-mq-nm", { NULL }, 2665, "udp" },
+ { "extensis", { NULL }, 2666, "tcp" },
+ { "extensis", { NULL }, 2666, "udp" },
+ { "alarm-clock-s", { NULL }, 2667, "tcp" },
+ { "alarm-clock-s", { NULL }, 2667, "udp" },
+ { "alarm-clock-c", { NULL }, 2668, "tcp" },
+ { "alarm-clock-c", { NULL }, 2668, "udp" },
+ { "toad", { NULL }, 2669, "tcp" },
+ { "toad", { NULL }, 2669, "udp" },
+ { "tve-announce", { NULL }, 2670, "tcp" },
+ { "tve-announce", { NULL }, 2670, "udp" },
+ { "newlixreg", { NULL }, 2671, "tcp" },
+ { "newlixreg", { NULL }, 2671, "udp" },
+ { "nhserver", { NULL }, 2672, "tcp" },
+ { "nhserver", { NULL }, 2672, "udp" },
+ { "firstcall42", { NULL }, 2673, "tcp" },
+ { "firstcall42", { NULL }, 2673, "udp" },
+ { "ewnn", { NULL }, 2674, "tcp" },
+ { "ewnn", { NULL }, 2674, "udp" },
+ { "ttc-etap", { NULL }, 2675, "tcp" },
+ { "ttc-etap", { NULL }, 2675, "udp" },
+ { "simslink", { NULL }, 2676, "tcp" },
+ { "simslink", { NULL }, 2676, "udp" },
+ { "gadgetgate1way", { NULL }, 2677, "tcp" },
+ { "gadgetgate1way", { NULL }, 2677, "udp" },
+ { "gadgetgate2way", { NULL }, 2678, "tcp" },
+ { "gadgetgate2way", { NULL }, 2678, "udp" },
+ { "syncserverssl", { NULL }, 2679, "tcp" },
+ { "syncserverssl", { NULL }, 2679, "udp" },
+ { "pxc-sapxom", { NULL }, 2680, "tcp" },
+ { "pxc-sapxom", { NULL }, 2680, "udp" },
+ { "mpnjsomb", { NULL }, 2681, "tcp" },
+ { "mpnjsomb", { NULL }, 2681, "udp" },
+ { "ncdloadbalance", { NULL }, 2683, "tcp" },
+ { "ncdloadbalance", { NULL }, 2683, "udp" },
+ { "mpnjsosv", { NULL }, 2684, "tcp" },
+ { "mpnjsosv", { NULL }, 2684, "udp" },
+ { "mpnjsocl", { NULL }, 2685, "tcp" },
+ { "mpnjsocl", { NULL }, 2685, "udp" },
+ { "mpnjsomg", { NULL }, 2686, "tcp" },
+ { "mpnjsomg", { NULL }, 2686, "udp" },
+ { "pq-lic-mgmt", { NULL }, 2687, "tcp" },
+ { "pq-lic-mgmt", { NULL }, 2687, "udp" },
+ { "md-cg-http", { NULL }, 2688, "tcp" },
+ { "md-cg-http", { NULL }, 2688, "udp" },
+ { "fastlynx", { NULL }, 2689, "tcp" },
+ { "fastlynx", { NULL }, 2689, "udp" },
+ { "hp-nnm-data", { NULL }, 2690, "tcp" },
+ { "hp-nnm-data", { NULL }, 2690, "udp" },
+ { "itinternet", { NULL }, 2691, "tcp" },
+ { "itinternet", { NULL }, 2691, "udp" },
+ { "admins-lms", { NULL }, 2692, "tcp" },
+ { "admins-lms", { NULL }, 2692, "udp" },
+ { "pwrsevent", { NULL }, 2694, "tcp" },
+ { "pwrsevent", { NULL }, 2694, "udp" },
+ { "vspread", { NULL }, 2695, "tcp" },
+ { "vspread", { NULL }, 2695, "udp" },
+ { "unifyadmin", { NULL }, 2696, "tcp" },
+ { "unifyadmin", { NULL }, 2696, "udp" },
+ { "oce-snmp-trap", { NULL }, 2697, "tcp" },
+ { "oce-snmp-trap", { NULL }, 2697, "udp" },
+ { "mck-ivpip", { NULL }, 2698, "tcp" },
+ { "mck-ivpip", { NULL }, 2698, "udp" },
+ { "csoft-plusclnt", { NULL }, 2699, "tcp" },
+ { "csoft-plusclnt", { NULL }, 2699, "udp" },
+ { "tqdata", { NULL }, 2700, "tcp" },
+ { "tqdata", { NULL }, 2700, "udp" },
+ { "sms-rcinfo", { NULL }, 2701, "tcp" },
+ { "sms-rcinfo", { NULL }, 2701, "udp" },
+ { "sms-xfer", { NULL }, 2702, "tcp" },
+ { "sms-xfer", { NULL }, 2702, "udp" },
+ { "sms-chat", { NULL }, 2703, "tcp" },
+ { "sms-chat", { NULL }, 2703, "udp" },
+ { "sms-remctrl", { NULL }, 2704, "tcp" },
+ { "sms-remctrl", { NULL }, 2704, "udp" },
+ { "sds-admin", { NULL }, 2705, "tcp" },
+ { "sds-admin", { NULL }, 2705, "udp" },
+ { "ncdmirroring", { NULL }, 2706, "tcp" },
+ { "ncdmirroring", { NULL }, 2706, "udp" },
+ { "emcsymapiport", { NULL }, 2707, "tcp" },
+ { "emcsymapiport", { NULL }, 2707, "udp" },
+ { "banyan-net", { NULL }, 2708, "tcp" },
+ { "banyan-net", { NULL }, 2708, "udp" },
+ { "supermon", { NULL }, 2709, "tcp" },
+ { "supermon", { NULL }, 2709, "udp" },
+ { "sso-service", { NULL }, 2710, "tcp" },
+ { "sso-service", { NULL }, 2710, "udp" },
+ { "sso-control", { NULL }, 2711, "tcp" },
+ { "sso-control", { NULL }, 2711, "udp" },
+ { "aocp", { NULL }, 2712, "tcp" },
+ { "aocp", { NULL }, 2712, "udp" },
+ { "raventbs", { NULL }, 2713, "tcp" },
+ { "raventbs", { NULL }, 2713, "udp" },
+ { "raventdm", { NULL }, 2714, "tcp" },
+ { "raventdm", { NULL }, 2714, "udp" },
+ { "hpstgmgr2", { NULL }, 2715, "tcp" },
+ { "hpstgmgr2", { NULL }, 2715, "udp" },
+ { "inova-ip-disco", { NULL }, 2716, "tcp" },
+ { "inova-ip-disco", { NULL }, 2716, "udp" },
+ { "pn-requester", { NULL }, 2717, "tcp" },
+ { "pn-requester", { NULL }, 2717, "udp" },
+ { "pn-requester2", { NULL }, 2718, "tcp" },
+ { "pn-requester2", { NULL }, 2718, "udp" },
+ { "scan-change", { NULL }, 2719, "tcp" },
+ { "scan-change", { NULL }, 2719, "udp" },
+ { "wkars", { NULL }, 2720, "tcp" },
+ { "wkars", { NULL }, 2720, "udp" },
+ { "smart-diagnose", { NULL }, 2721, "tcp" },
+ { "smart-diagnose", { NULL }, 2721, "udp" },
+ { "proactivesrvr", { NULL }, 2722, "tcp" },
+ { "proactivesrvr", { NULL }, 2722, "udp" },
+ { "watchdog-nt", { NULL }, 2723, "tcp" },
+ { "watchdog-nt", { NULL }, 2723, "udp" },
+ { "qotps", { NULL }, 2724, "tcp" },
+ { "qotps", { NULL }, 2724, "udp" },
+ { "msolap-ptp2", { NULL }, 2725, "tcp" },
+ { "msolap-ptp2", { NULL }, 2725, "udp" },
+ { "tams", { NULL }, 2726, "tcp" },
+ { "tams", { NULL }, 2726, "udp" },
+ { "mgcp-callagent", { NULL }, 2727, "tcp" },
+ { "mgcp-callagent", { NULL }, 2727, "udp" },
+ { "sqdr", { NULL }, 2728, "tcp" },
+ { "sqdr", { NULL }, 2728, "udp" },
+ { "tcim-control", { NULL }, 2729, "tcp" },
+ { "tcim-control", { NULL }, 2729, "udp" },
+ { "nec-raidplus", { NULL }, 2730, "tcp" },
+ { "nec-raidplus", { NULL }, 2730, "udp" },
+ { "fyre-messanger", { NULL }, 2731, "tcp" },
+ { "fyre-messanger", { NULL }, 2731, "udp" },
+ { "g5m", { NULL }, 2732, "tcp" },
+ { "g5m", { NULL }, 2732, "udp" },
+ { "signet-ctf", { NULL }, 2733, "tcp" },
+ { "signet-ctf", { NULL }, 2733, "udp" },
+ { "ccs-software", { NULL }, 2734, "tcp" },
+ { "ccs-software", { NULL }, 2734, "udp" },
+ { "netiq-mc", { NULL }, 2735, "tcp" },
+ { "netiq-mc", { NULL }, 2735, "udp" },
+ { "radwiz-nms-srv", { NULL }, 2736, "tcp" },
+ { "radwiz-nms-srv", { NULL }, 2736, "udp" },
+ { "srp-feedback", { NULL }, 2737, "tcp" },
+ { "srp-feedback", { NULL }, 2737, "udp" },
+ { "ndl-tcp-ois-gw", { NULL }, 2738, "tcp" },
+ { "ndl-tcp-ois-gw", { NULL }, 2738, "udp" },
+ { "tn-timing", { NULL }, 2739, "tcp" },
+ { "tn-timing", { NULL }, 2739, "udp" },
+ { "alarm", { NULL }, 2740, "tcp" },
+ { "alarm", { NULL }, 2740, "udp" },
+ { "tsb", { NULL }, 2741, "tcp" },
+ { "tsb", { NULL }, 2741, "udp" },
+ { "tsb2", { NULL }, 2742, "tcp" },
+ { "tsb2", { NULL }, 2742, "udp" },
+ { "murx", { NULL }, 2743, "tcp" },
+ { "murx", { NULL }, 2743, "udp" },
+ { "honyaku", { NULL }, 2744, "tcp" },
+ { "honyaku", { NULL }, 2744, "udp" },
+ { "urbisnet", { NULL }, 2745, "tcp" },
+ { "urbisnet", { NULL }, 2745, "udp" },
+ { "cpudpencap", { NULL }, 2746, "tcp" },
+ { "cpudpencap", { NULL }, 2746, "udp" },
+ { "fjippol-swrly", { NULL }, 2747, "tcp" },
+ { "fjippol-swrly", { NULL }, 2747, "udp" },
+ { "fjippol-polsvr", { NULL }, 2748, "tcp" },
+ { "fjippol-polsvr", { NULL }, 2748, "udp" },
+ { "fjippol-cnsl", { NULL }, 2749, "tcp" },
+ { "fjippol-cnsl", { NULL }, 2749, "udp" },
+ { "fjippol-port1", { NULL }, 2750, "tcp" },
+ { "fjippol-port1", { NULL }, 2750, "udp" },
+ { "fjippol-port2", { NULL }, 2751, "tcp" },
+ { "fjippol-port2", { NULL }, 2751, "udp" },
+ { "rsisysaccess", { NULL }, 2752, "tcp" },
+ { "rsisysaccess", { NULL }, 2752, "udp" },
+ { "de-spot", { NULL }, 2753, "tcp" },
+ { "de-spot", { NULL }, 2753, "udp" },
+ { "apollo-cc", { NULL }, 2754, "tcp" },
+ { "apollo-cc", { NULL }, 2754, "udp" },
+ { "expresspay", { NULL }, 2755, "tcp" },
+ { "expresspay", { NULL }, 2755, "udp" },
+ { "simplement-tie", { NULL }, 2756, "tcp" },
+ { "simplement-tie", { NULL }, 2756, "udp" },
+ { "cnrp", { NULL }, 2757, "tcp" },
+ { "cnrp", { NULL }, 2757, "udp" },
+ { "apollo-status", { NULL }, 2758, "tcp" },
+ { "apollo-status", { NULL }, 2758, "udp" },
+ { "apollo-gms", { NULL }, 2759, "tcp" },
+ { "apollo-gms", { NULL }, 2759, "udp" },
+ { "sabams", { NULL }, 2760, "tcp" },
+ { "sabams", { NULL }, 2760, "udp" },
+ { "dicom-iscl", { NULL }, 2761, "tcp" },
+ { "dicom-iscl", { NULL }, 2761, "udp" },
+ { "dicom-tls", { NULL }, 2762, "tcp" },
+ { "dicom-tls", { NULL }, 2762, "udp" },
+ { "desktop-dna", { NULL }, 2763, "tcp" },
+ { "desktop-dna", { NULL }, 2763, "udp" },
+ { "data-insurance", { NULL }, 2764, "tcp" },
+ { "data-insurance", { NULL }, 2764, "udp" },
+ { "qip-audup", { NULL }, 2765, "tcp" },
+ { "qip-audup", { NULL }, 2765, "udp" },
+ { "compaq-scp", { NULL }, 2766, "tcp" },
+ { "compaq-scp", { NULL }, 2766, "udp" },
+ { "uadtc", { NULL }, 2767, "tcp" },
+ { "uadtc", { NULL }, 2767, "udp" },
+ { "uacs", { NULL }, 2768, "tcp" },
+ { "uacs", { NULL }, 2768, "udp" },
+ { "exce", { NULL }, 2769, "tcp" },
+ { "exce", { NULL }, 2769, "udp" },
+ { "veronica", { NULL }, 2770, "tcp" },
+ { "veronica", { NULL }, 2770, "udp" },
+ { "vergencecm", { NULL }, 2771, "tcp" },
+ { "vergencecm", { NULL }, 2771, "udp" },
+ { "auris", { NULL }, 2772, "tcp" },
+ { "auris", { NULL }, 2772, "udp" },
+ { "rbakcup1", { NULL }, 2773, "tcp" },
+ { "rbakcup1", { NULL }, 2773, "udp" },
+ { "rbakcup2", { NULL }, 2774, "tcp" },
+ { "rbakcup2", { NULL }, 2774, "udp" },
+ { "smpp", { NULL }, 2775, "tcp" },
+ { "smpp", { NULL }, 2775, "udp" },
+ { "ridgeway1", { NULL }, 2776, "tcp" },
+ { "ridgeway1", { NULL }, 2776, "udp" },
+ { "ridgeway2", { NULL }, 2777, "tcp" },
+ { "ridgeway2", { NULL }, 2777, "udp" },
+ { "gwen-sonya", { NULL }, 2778, "tcp" },
+ { "gwen-sonya", { NULL }, 2778, "udp" },
+ { "lbc-sync", { NULL }, 2779, "tcp" },
+ { "lbc-sync", { NULL }, 2779, "udp" },
+ { "lbc-control", { NULL }, 2780, "tcp" },
+ { "lbc-control", { NULL }, 2780, "udp" },
+ { "whosells", { NULL }, 2781, "tcp" },
+ { "whosells", { NULL }, 2781, "udp" },
+ { "everydayrc", { NULL }, 2782, "tcp" },
+ { "everydayrc", { NULL }, 2782, "udp" },
+ { "aises", { NULL }, 2783, "tcp" },
+ { "aises", { NULL }, 2783, "udp" },
+ { "www-dev", { NULL }, 2784, "tcp" },
+ { "www-dev", { NULL }, 2784, "udp" },
+ { "aic-np", { NULL }, 2785, "tcp" },
+ { "aic-np", { NULL }, 2785, "udp" },
+ { "aic-oncrpc", { NULL }, 2786, "tcp" },
+ { "aic-oncrpc", { NULL }, 2786, "udp" },
+ { "piccolo", { NULL }, 2787, "tcp" },
+ { "piccolo", { NULL }, 2787, "udp" },
+ { "fryeserv", { NULL }, 2788, "tcp" },
+ { "fryeserv", { NULL }, 2788, "udp" },
+ { "media-agent", { NULL }, 2789, "tcp" },
+ { "media-agent", { NULL }, 2789, "udp" },
+ { "plgproxy", { NULL }, 2790, "tcp" },
+ { "plgproxy", { NULL }, 2790, "udp" },
+ { "mtport-regist", { NULL }, 2791, "tcp" },
+ { "mtport-regist", { NULL }, 2791, "udp" },
+ { "f5-globalsite", { NULL }, 2792, "tcp" },
+ { "f5-globalsite", { NULL }, 2792, "udp" },
+ { "initlsmsad", { NULL }, 2793, "tcp" },
+ { "initlsmsad", { NULL }, 2793, "udp" },
+ { "livestats", { NULL }, 2795, "tcp" },
+ { "livestats", { NULL }, 2795, "udp" },
+ { "ac-tech", { NULL }, 2796, "tcp" },
+ { "ac-tech", { NULL }, 2796, "udp" },
+ { "esp-encap", { NULL }, 2797, "tcp" },
+ { "esp-encap", { NULL }, 2797, "udp" },
+ { "tmesis-upshot", { NULL }, 2798, "tcp" },
+ { "tmesis-upshot", { NULL }, 2798, "udp" },
+ { "icon-discover", { NULL }, 2799, "tcp" },
+ { "icon-discover", { NULL }, 2799, "udp" },
+ { "acc-raid", { NULL }, 2800, "tcp" },
+ { "acc-raid", { NULL }, 2800, "udp" },
+ { "igcp", { NULL }, 2801, "tcp" },
+ { "igcp", { NULL }, 2801, "udp" },
+ { "veritas-tcp1", { NULL }, 2802, "tcp" },
+ { "veritas-udp1", { NULL }, 2802, "udp" },
+ { "btprjctrl", { NULL }, 2803, "tcp" },
+ { "btprjctrl", { NULL }, 2803, "udp" },
+ { "dvr-esm", { NULL }, 2804, "tcp" },
+ { "dvr-esm", { NULL }, 2804, "udp" },
+ { "wta-wsp-s", { NULL }, 2805, "tcp" },
+ { "wta-wsp-s", { NULL }, 2805, "udp" },
+ { "cspuni", { NULL }, 2806, "tcp" },
+ { "cspuni", { NULL }, 2806, "udp" },
+ { "cspmulti", { NULL }, 2807, "tcp" },
+ { "cspmulti", { NULL }, 2807, "udp" },
+ { "j-lan-p", { NULL }, 2808, "tcp" },
+ { "j-lan-p", { NULL }, 2808, "udp" },
+ { "corbaloc", { NULL }, 2809, "tcp" },
+ { "corbaloc", { NULL }, 2809, "udp" },
+ { "netsteward", { NULL }, 2810, "tcp" },
+ { "netsteward", { NULL }, 2810, "udp" },
+ { "gsiftp", { NULL }, 2811, "tcp" },
+ { "gsiftp", { NULL }, 2811, "udp" },
+ { "atmtcp", { NULL }, 2812, "tcp" },
+ { "atmtcp", { NULL }, 2812, "udp" },
+ { "llm-pass", { NULL }, 2813, "tcp" },
+ { "llm-pass", { NULL }, 2813, "udp" },
+ { "llm-csv", { NULL }, 2814, "tcp" },
+ { "llm-csv", { NULL }, 2814, "udp" },
+ { "lbc-measure", { NULL }, 2815, "tcp" },
+ { "lbc-measure", { NULL }, 2815, "udp" },
+ { "lbc-watchdog", { NULL }, 2816, "tcp" },
+ { "lbc-watchdog", { NULL }, 2816, "udp" },
+ { "nmsigport", { NULL }, 2817, "tcp" },
+ { "nmsigport", { NULL }, 2817, "udp" },
+ { "rmlnk", { NULL }, 2818, "tcp" },
+ { "rmlnk", { NULL }, 2818, "udp" },
+ { "fc-faultnotify", { NULL }, 2819, "tcp" },
+ { "fc-faultnotify", { NULL }, 2819, "udp" },
+ { "univision", { NULL }, 2820, "tcp" },
+ { "univision", { NULL }, 2820, "udp" },
+ { "vrts-at-port", { NULL }, 2821, "tcp" },
+ { "vrts-at-port", { NULL }, 2821, "udp" },
+ { "ka0wuc", { NULL }, 2822, "tcp" },
+ { "ka0wuc", { NULL }, 2822, "udp" },
+ { "cqg-netlan", { NULL }, 2823, "tcp" },
+ { "cqg-netlan", { NULL }, 2823, "udp" },
+ { "cqg-netlan-1", { NULL }, 2824, "tcp" },
+ { "cqg-netlan-1", { NULL }, 2824, "udp" },
+ { "slc-systemlog", { NULL }, 2826, "tcp" },
+ { "slc-systemlog", { NULL }, 2826, "udp" },
+ { "slc-ctrlrloops", { NULL }, 2827, "tcp" },
+ { "slc-ctrlrloops", { NULL }, 2827, "udp" },
+ { "itm-lm", { NULL }, 2828, "tcp" },
+ { "itm-lm", { NULL }, 2828, "udp" },
+ { "silkp1", { NULL }, 2829, "tcp" },
+ { "silkp1", { NULL }, 2829, "udp" },
+ { "silkp2", { NULL }, 2830, "tcp" },
+ { "silkp2", { NULL }, 2830, "udp" },
+ { "silkp3", { NULL }, 2831, "tcp" },
+ { "silkp3", { NULL }, 2831, "udp" },
+ { "silkp4", { NULL }, 2832, "tcp" },
+ { "silkp4", { NULL }, 2832, "udp" },
+ { "glishd", { NULL }, 2833, "tcp" },
+ { "glishd", { NULL }, 2833, "udp" },
+ { "evtp", { NULL }, 2834, "tcp" },
+ { "evtp", { NULL }, 2834, "udp" },
+ { "evtp-data", { NULL }, 2835, "tcp" },
+ { "evtp-data", { NULL }, 2835, "udp" },
+ { "catalyst", { NULL }, 2836, "tcp" },
+ { "catalyst", { NULL }, 2836, "udp" },
+ { "repliweb", { NULL }, 2837, "tcp" },
+ { "repliweb", { NULL }, 2837, "udp" },
+ { "starbot", { NULL }, 2838, "tcp" },
+ { "starbot", { NULL }, 2838, "udp" },
+ { "nmsigport", { NULL }, 2839, "tcp" },
+ { "nmsigport", { NULL }, 2839, "udp" },
+ { "l3-exprt", { NULL }, 2840, "tcp" },
+ { "l3-exprt", { NULL }, 2840, "udp" },
+ { "l3-ranger", { NULL }, 2841, "tcp" },
+ { "l3-ranger", { NULL }, 2841, "udp" },
+ { "l3-hawk", { NULL }, 2842, "tcp" },
+ { "l3-hawk", { NULL }, 2842, "udp" },
+ { "pdnet", { NULL }, 2843, "tcp" },
+ { "pdnet", { NULL }, 2843, "udp" },
+ { "bpcp-poll", { NULL }, 2844, "tcp" },
+ { "bpcp-poll", { NULL }, 2844, "udp" },
+ { "bpcp-trap", { NULL }, 2845, "tcp" },
+ { "bpcp-trap", { NULL }, 2845, "udp" },
+ { "aimpp-hello", { NULL }, 2846, "tcp" },
+ { "aimpp-hello", { NULL }, 2846, "udp" },
+ { "aimpp-port-req", { NULL }, 2847, "tcp" },
+ { "aimpp-port-req", { NULL }, 2847, "udp" },
+ { "amt-blc-port", { NULL }, 2848, "tcp" },
+ { "amt-blc-port", { NULL }, 2848, "udp" },
+ { "fxp", { NULL }, 2849, "tcp" },
+ { "fxp", { NULL }, 2849, "udp" },
+ { "metaconsole", { NULL }, 2850, "tcp" },
+ { "metaconsole", { NULL }, 2850, "udp" },
+ { "webemshttp", { NULL }, 2851, "tcp" },
+ { "webemshttp", { NULL }, 2851, "udp" },
+ { "bears-01", { NULL }, 2852, "tcp" },
+ { "bears-01", { NULL }, 2852, "udp" },
+ { "ispipes", { NULL }, 2853, "tcp" },
+ { "ispipes", { NULL }, 2853, "udp" },
+ { "infomover", { NULL }, 2854, "tcp" },
+ { "infomover", { NULL }, 2854, "udp" },
+ { "msrp", { NULL }, 2855, "tcp" },
+ { "msrp", { NULL }, 2855, "udp" },
+ { "cesdinv", { NULL }, 2856, "tcp" },
+ { "cesdinv", { NULL }, 2856, "udp" },
+ { "simctlp", { NULL }, 2857, "tcp" },
+ { "simctlp", { NULL }, 2857, "udp" },
+ { "ecnp", { NULL }, 2858, "tcp" },
+ { "ecnp", { NULL }, 2858, "udp" },
+ { "activememory", { NULL }, 2859, "tcp" },
+ { "activememory", { NULL }, 2859, "udp" },
+ { "dialpad-voice1", { NULL }, 2860, "tcp" },
+ { "dialpad-voice1", { NULL }, 2860, "udp" },
+ { "dialpad-voice2", { NULL }, 2861, "tcp" },
+ { "dialpad-voice2", { NULL }, 2861, "udp" },
+ { "ttg-protocol", { NULL }, 2862, "tcp" },
+ { "ttg-protocol", { NULL }, 2862, "udp" },
+ { "sonardata", { NULL }, 2863, "tcp" },
+ { "sonardata", { NULL }, 2863, "udp" },
+ { "astromed-main", { NULL }, 2864, "tcp" },
+ { "astromed-main", { NULL }, 2864, "udp" },
+ { "pit-vpn", { NULL }, 2865, "tcp" },
+ { "pit-vpn", { NULL }, 2865, "udp" },
+ { "iwlistener", { NULL }, 2866, "tcp" },
+ { "iwlistener", { NULL }, 2866, "udp" },
+ { "esps-portal", { NULL }, 2867, "tcp" },
+ { "esps-portal", { NULL }, 2867, "udp" },
+ { "npep-messaging", { NULL }, 2868, "tcp" },
+ { "npep-messaging", { NULL }, 2868, "udp" },
+ { "icslap", { NULL }, 2869, "tcp" },
+ { "icslap", { NULL }, 2869, "udp" },
+ { "daishi", { NULL }, 2870, "tcp" },
+ { "daishi", { NULL }, 2870, "udp" },
+ { "msi-selectplay", { NULL }, 2871, "tcp" },
+ { "msi-selectplay", { NULL }, 2871, "udp" },
+ { "radix", { NULL }, 2872, "tcp" },
+ { "radix", { NULL }, 2872, "udp" },
+ { "dxmessagebase1", { NULL }, 2874, "tcp" },
+ { "dxmessagebase1", { NULL }, 2874, "udp" },
+ { "dxmessagebase2", { NULL }, 2875, "tcp" },
+ { "dxmessagebase2", { NULL }, 2875, "udp" },
+ { "sps-tunnel", { NULL }, 2876, "tcp" },
+ { "sps-tunnel", { NULL }, 2876, "udp" },
+ { "bluelance", { NULL }, 2877, "tcp" },
+ { "bluelance", { NULL }, 2877, "udp" },
+ { "aap", { NULL }, 2878, "tcp" },
+ { "aap", { NULL }, 2878, "udp" },
+ { "ucentric-ds", { NULL }, 2879, "tcp" },
+ { "ucentric-ds", { NULL }, 2879, "udp" },
+ { "synapse", { NULL }, 2880, "tcp" },
+ { "synapse", { NULL }, 2880, "udp" },
+ { "ndsp", { NULL }, 2881, "tcp" },
+ { "ndsp", { NULL }, 2881, "udp" },
+ { "ndtp", { NULL }, 2882, "tcp" },
+ { "ndtp", { NULL }, 2882, "udp" },
+ { "ndnp", { NULL }, 2883, "tcp" },
+ { "ndnp", { NULL }, 2883, "udp" },
+ { "flashmsg", { NULL }, 2884, "tcp" },
+ { "flashmsg", { NULL }, 2884, "udp" },
+ { "topflow", { NULL }, 2885, "tcp" },
+ { "topflow", { NULL }, 2885, "udp" },
+ { "responselogic", { NULL }, 2886, "tcp" },
+ { "responselogic", { NULL }, 2886, "udp" },
+ { "aironetddp", { NULL }, 2887, "tcp" },
+ { "aironetddp", { NULL }, 2887, "udp" },
+ { "spcsdlobby", { NULL }, 2888, "tcp" },
+ { "spcsdlobby", { NULL }, 2888, "udp" },
+ { "rsom", { NULL }, 2889, "tcp" },
+ { "rsom", { NULL }, 2889, "udp" },
+ { "cspclmulti", { NULL }, 2890, "tcp" },
+ { "cspclmulti", { NULL }, 2890, "udp" },
+ { "cinegrfx-elmd", { NULL }, 2891, "tcp" },
+ { "cinegrfx-elmd", { NULL }, 2891, "udp" },
+ { "snifferdata", { NULL }, 2892, "tcp" },
+ { "snifferdata", { NULL }, 2892, "udp" },
+ { "vseconnector", { NULL }, 2893, "tcp" },
+ { "vseconnector", { NULL }, 2893, "udp" },
+ { "abacus-remote", { NULL }, 2894, "tcp" },
+ { "abacus-remote", { NULL }, 2894, "udp" },
+ { "natuslink", { NULL }, 2895, "tcp" },
+ { "natuslink", { NULL }, 2895, "udp" },
+ { "ecovisiong6-1", { NULL }, 2896, "tcp" },
+ { "ecovisiong6-1", { NULL }, 2896, "udp" },
+ { "citrix-rtmp", { NULL }, 2897, "tcp" },
+ { "citrix-rtmp", { NULL }, 2897, "udp" },
+ { "appliance-cfg", { NULL }, 2898, "tcp" },
+ { "appliance-cfg", { NULL }, 2898, "udp" },
+ { "powergemplus", { NULL }, 2899, "tcp" },
+ { "powergemplus", { NULL }, 2899, "udp" },
+ { "quicksuite", { NULL }, 2900, "tcp" },
+ { "quicksuite", { NULL }, 2900, "udp" },
+ { "allstorcns", { NULL }, 2901, "tcp" },
+ { "allstorcns", { NULL }, 2901, "udp" },
+ { "netaspi", { NULL }, 2902, "tcp" },
+ { "netaspi", { NULL }, 2902, "udp" },
+ { "suitcase", { NULL }, 2903, "tcp" },
+ { "suitcase", { NULL }, 2903, "udp" },
+ { "m2ua", { NULL }, 2904, "tcp" },
+ { "m2ua", { NULL }, 2904, "udp" },
+ { "m2ua", { NULL }, 2904, "sctp"},
+ { "m3ua", { NULL }, 2905, "tcp" },
+ { "m3ua", { NULL }, 2905, "sctp"},
+ { "caller9", { NULL }, 2906, "tcp" },
+ { "caller9", { NULL }, 2906, "udp" },
+ { "webmethods-b2b", { NULL }, 2907, "tcp" },
+ { "webmethods-b2b", { NULL }, 2907, "udp" },
+ { "mao", { NULL }, 2908, "tcp" },
+ { "mao", { NULL }, 2908, "udp" },
+ { "funk-dialout", { NULL }, 2909, "tcp" },
+ { "funk-dialout", { NULL }, 2909, "udp" },
+ { "tdaccess", { NULL }, 2910, "tcp" },
+ { "tdaccess", { NULL }, 2910, "udp" },
+ { "blockade", { NULL }, 2911, "tcp" },
+ { "blockade", { NULL }, 2911, "udp" },
+ { "epicon", { NULL }, 2912, "tcp" },
+ { "epicon", { NULL }, 2912, "udp" },
+ { "boosterware", { NULL }, 2913, "tcp" },
+ { "boosterware", { NULL }, 2913, "udp" },
+ { "gamelobby", { NULL }, 2914, "tcp" },
+ { "gamelobby", { NULL }, 2914, "udp" },
+ { "tksocket", { NULL }, 2915, "tcp" },
+ { "tksocket", { NULL }, 2915, "udp" },
+ { "elvin_server", { NULL }, 2916, "tcp" },
+ { "elvin_server", { NULL }, 2916, "udp" },
+ { "elvin_client", { NULL }, 2917, "tcp" },
+ { "elvin_client", { NULL }, 2917, "udp" },
+ { "kastenchasepad", { NULL }, 2918, "tcp" },
+ { "kastenchasepad", { NULL }, 2918, "udp" },
+ { "roboer", { NULL }, 2919, "tcp" },
+ { "roboer", { NULL }, 2919, "udp" },
+ { "roboeda", { NULL }, 2920, "tcp" },
+ { "roboeda", { NULL }, 2920, "udp" },
+ { "cesdcdman", { NULL }, 2921, "tcp" },
+ { "cesdcdman", { NULL }, 2921, "udp" },
+ { "cesdcdtrn", { NULL }, 2922, "tcp" },
+ { "cesdcdtrn", { NULL }, 2922, "udp" },
+ { "wta-wsp-wtp-s", { NULL }, 2923, "tcp" },
+ { "wta-wsp-wtp-s", { NULL }, 2923, "udp" },
+ { "precise-vip", { NULL }, 2924, "tcp" },
+ { "precise-vip", { NULL }, 2924, "udp" },
+ { "mobile-file-dl", { NULL }, 2926, "tcp" },
+ { "mobile-file-dl", { NULL }, 2926, "udp" },
+ { "unimobilectrl", { NULL }, 2927, "tcp" },
+ { "unimobilectrl", { NULL }, 2927, "udp" },
+ { "redstone-cpss", { NULL }, 2928, "tcp" },
+ { "redstone-cpss", { NULL }, 2928, "udp" },
+ { "amx-webadmin", { NULL }, 2929, "tcp" },
+ { "amx-webadmin", { NULL }, 2929, "udp" },
+ { "amx-weblinx", { NULL }, 2930, "tcp" },
+ { "amx-weblinx", { NULL }, 2930, "udp" },
+ { "circle-x", { NULL }, 2931, "tcp" },
+ { "circle-x", { NULL }, 2931, "udp" },
+ { "incp", { NULL }, 2932, "tcp" },
+ { "incp", { NULL }, 2932, "udp" },
+ { "4-tieropmgw", { NULL }, 2933, "tcp" },
+ { "4-tieropmgw", { NULL }, 2933, "udp" },
+ { "4-tieropmcli", { NULL }, 2934, "tcp" },
+ { "4-tieropmcli", { NULL }, 2934, "udp" },
+ { "qtp", { NULL }, 2935, "tcp" },
+ { "qtp", { NULL }, 2935, "udp" },
+ { "otpatch", { NULL }, 2936, "tcp" },
+ { "otpatch", { NULL }, 2936, "udp" },
+ { "pnaconsult-lm", { NULL }, 2937, "tcp" },
+ { "pnaconsult-lm", { NULL }, 2937, "udp" },
+ { "sm-pas-1", { NULL }, 2938, "tcp" },
+ { "sm-pas-1", { NULL }, 2938, "udp" },
+ { "sm-pas-2", { NULL }, 2939, "tcp" },
+ { "sm-pas-2", { NULL }, 2939, "udp" },
+ { "sm-pas-3", { NULL }, 2940, "tcp" },
+ { "sm-pas-3", { NULL }, 2940, "udp" },
+ { "sm-pas-4", { NULL }, 2941, "tcp" },
+ { "sm-pas-4", { NULL }, 2941, "udp" },
+ { "sm-pas-5", { NULL }, 2942, "tcp" },
+ { "sm-pas-5", { NULL }, 2942, "udp" },
+ { "ttnrepository", { NULL }, 2943, "tcp" },
+ { "ttnrepository", { NULL }, 2943, "udp" },
+ { "megaco-h248", { NULL }, 2944, "tcp" },
+ { "megaco-h248", { NULL }, 2944, "udp" },
+ { "megaco-h248", { NULL }, 2944, "sctp"},
+ { "h248-binary", { NULL }, 2945, "tcp" },
+ { "h248-binary", { NULL }, 2945, "udp" },
+ { "h248-binary", { NULL }, 2945, "sctp"},
+ { "fjsvmpor", { NULL }, 2946, "tcp" },
+ { "fjsvmpor", { NULL }, 2946, "udp" },
+ { "gpsd", { NULL }, 2947, "tcp" },
+ { "gpsd", { NULL }, 2947, "udp" },
+ { "wap-push", { NULL }, 2948, "tcp" },
+ { "wap-push", { NULL }, 2948, "udp" },
+ { "wap-pushsecure", { NULL }, 2949, "tcp" },
+ { "wap-pushsecure", { NULL }, 2949, "udp" },
+ { "esip", { NULL }, 2950, "tcp" },
+ { "esip", { NULL }, 2950, "udp" },
+ { "ottp", { NULL }, 2951, "tcp" },
+ { "ottp", { NULL }, 2951, "udp" },
+ { "mpfwsas", { NULL }, 2952, "tcp" },
+ { "mpfwsas", { NULL }, 2952, "udp" },
+ { "ovalarmsrv", { NULL }, 2953, "tcp" },
+ { "ovalarmsrv", { NULL }, 2953, "udp" },
+ { "ovalarmsrv-cmd", { NULL }, 2954, "tcp" },
+ { "ovalarmsrv-cmd", { NULL }, 2954, "udp" },
+ { "csnotify", { NULL }, 2955, "tcp" },
+ { "csnotify", { NULL }, 2955, "udp" },
+ { "ovrimosdbman", { NULL }, 2956, "tcp" },
+ { "ovrimosdbman", { NULL }, 2956, "udp" },
+ { "jmact5", { NULL }, 2957, "tcp" },
+ { "jmact5", { NULL }, 2957, "udp" },
+ { "jmact6", { NULL }, 2958, "tcp" },
+ { "jmact6", { NULL }, 2958, "udp" },
+ { "rmopagt", { NULL }, 2959, "tcp" },
+ { "rmopagt", { NULL }, 2959, "udp" },
+ { "dfoxserver", { NULL }, 2960, "tcp" },
+ { "dfoxserver", { NULL }, 2960, "udp" },
+ { "boldsoft-lm", { NULL }, 2961, "tcp" },
+ { "boldsoft-lm", { NULL }, 2961, "udp" },
+ { "iph-policy-cli", { NULL }, 2962, "tcp" },
+ { "iph-policy-cli", { NULL }, 2962, "udp" },
+ { "iph-policy-adm", { NULL }, 2963, "tcp" },
+ { "iph-policy-adm", { NULL }, 2963, "udp" },
+ { "bullant-srap", { NULL }, 2964, "tcp" },
+ { "bullant-srap", { NULL }, 2964, "udp" },
+ { "bullant-rap", { NULL }, 2965, "tcp" },
+ { "bullant-rap", { NULL }, 2965, "udp" },
+ { "idp-infotrieve", { NULL }, 2966, "tcp" },
+ { "idp-infotrieve", { NULL }, 2966, "udp" },
+ { "ssc-agent", { NULL }, 2967, "tcp" },
+ { "ssc-agent", { NULL }, 2967, "udp" },
+ { "enpp", { NULL }, 2968, "tcp" },
+ { "enpp", { NULL }, 2968, "udp" },
+ { "essp", { NULL }, 2969, "tcp" },
+ { "essp", { NULL }, 2969, "udp" },
+ { "index-net", { NULL }, 2970, "tcp" },
+ { "index-net", { NULL }, 2970, "udp" },
+ { "netclip", { NULL }, 2971, "tcp" },
+ { "netclip", { NULL }, 2971, "udp" },
+ { "pmsm-webrctl", { NULL }, 2972, "tcp" },
+ { "pmsm-webrctl", { NULL }, 2972, "udp" },
+ { "svnetworks", { NULL }, 2973, "tcp" },
+ { "svnetworks", { NULL }, 2973, "udp" },
+ { "signal", { NULL }, 2974, "tcp" },
+ { "signal", { NULL }, 2974, "udp" },
+ { "fjmpcm", { NULL }, 2975, "tcp" },
+ { "fjmpcm", { NULL }, 2975, "udp" },
+ { "cns-srv-port", { NULL }, 2976, "tcp" },
+ { "cns-srv-port", { NULL }, 2976, "udp" },
+ { "ttc-etap-ns", { NULL }, 2977, "tcp" },
+ { "ttc-etap-ns", { NULL }, 2977, "udp" },
+ { "ttc-etap-ds", { NULL }, 2978, "tcp" },
+ { "ttc-etap-ds", { NULL }, 2978, "udp" },
+ { "h263-video", { NULL }, 2979, "tcp" },
+ { "h263-video", { NULL }, 2979, "udp" },
+ { "wimd", { NULL }, 2980, "tcp" },
+ { "wimd", { NULL }, 2980, "udp" },
+ { "mylxamport", { NULL }, 2981, "tcp" },
+ { "mylxamport", { NULL }, 2981, "udp" },
+ { "iwb-whiteboard", { NULL }, 2982, "tcp" },
+ { "iwb-whiteboard", { NULL }, 2982, "udp" },
+ { "netplan", { NULL }, 2983, "tcp" },
+ { "netplan", { NULL }, 2983, "udp" },
+ { "hpidsadmin", { NULL }, 2984, "tcp" },
+ { "hpidsadmin", { NULL }, 2984, "udp" },
+ { "hpidsagent", { NULL }, 2985, "tcp" },
+ { "hpidsagent", { NULL }, 2985, "udp" },
+ { "stonefalls", { NULL }, 2986, "tcp" },
+ { "stonefalls", { NULL }, 2986, "udp" },
+ { "identify", { NULL }, 2987, "tcp" },
+ { "identify", { NULL }, 2987, "udp" },
+ { "hippad", { NULL }, 2988, "tcp" },
+ { "hippad", { NULL }, 2988, "udp" },
+ { "zarkov", { NULL }, 2989, "tcp" },
+ { "zarkov", { NULL }, 2989, "udp" },
+ { "boscap", { NULL }, 2990, "tcp" },
+ { "boscap", { NULL }, 2990, "udp" },
+ { "wkstn-mon", { NULL }, 2991, "tcp" },
+ { "wkstn-mon", { NULL }, 2991, "udp" },
+ { "avenyo", { NULL }, 2992, "tcp" },
+ { "avenyo", { NULL }, 2992, "udp" },
+ { "veritas-vis1", { NULL }, 2993, "tcp" },
+ { "veritas-vis1", { NULL }, 2993, "udp" },
+ { "veritas-vis2", { NULL }, 2994, "tcp" },
+ { "veritas-vis2", { NULL }, 2994, "udp" },
+ { "idrs", { NULL }, 2995, "tcp" },
+ { "idrs", { NULL }, 2995, "udp" },
+ { "vsixml", { NULL }, 2996, "tcp" },
+ { "vsixml", { NULL }, 2996, "udp" },
+ { "rebol", { NULL }, 2997, "tcp" },
+ { "rebol", { NULL }, 2997, "udp" },
+ { "realsecure", { NULL }, 2998, "tcp" },
+ { "realsecure", { NULL }, 2998, "udp" },
+ { "remoteware-un", { NULL }, 2999, "tcp" },
+ { "remoteware-un", { NULL }, 2999, "udp" },
+ { "hbci", { NULL }, 3000, "tcp" },
+ { "hbci", { NULL }, 3000, "udp" },
+ { "remoteware-cl", { NULL }, 3000, "tcp" },
+ { "remoteware-cl", { NULL }, 3000, "udp" },
+ { "exlm-agent", { NULL }, 3002, "tcp" },
+ { "exlm-agent", { NULL }, 3002, "udp" },
+ { "remoteware-srv", { NULL }, 3002, "tcp" },
+ { "remoteware-srv", { NULL }, 3002, "udp" },
+ { "cgms", { NULL }, 3003, "tcp" },
+ { "cgms", { NULL }, 3003, "udp" },
+ { "csoftragent", { NULL }, 3004, "tcp" },
+ { "csoftragent", { NULL }, 3004, "udp" },
+ { "geniuslm", { NULL }, 3005, "tcp" },
+ { "geniuslm", { NULL }, 3005, "udp" },
+ { "ii-admin", { NULL }, 3006, "tcp" },
+ { "ii-admin", { NULL }, 3006, "udp" },
+ { "lotusmtap", { NULL }, 3007, "tcp" },
+ { "lotusmtap", { NULL }, 3007, "udp" },
+ { "midnight-tech", { NULL }, 3008, "tcp" },
+ { "midnight-tech", { NULL }, 3008, "udp" },
+ { "pxc-ntfy", { NULL }, 3009, "tcp" },
+ { "pxc-ntfy", { NULL }, 3009, "udp" },
+ { "gw", { NULL }, 3010, "tcp" },
+ { "ping-pong", { NULL }, 3010, "udp" },
+ { "trusted-web", { NULL }, 3011, "tcp" },
+ { "trusted-web", { NULL }, 3011, "udp" },
+ { "twsdss", { NULL }, 3012, "tcp" },
+ { "twsdss", { NULL }, 3012, "udp" },
+ { "gilatskysurfer", { NULL }, 3013, "tcp" },
+ { "gilatskysurfer", { NULL }, 3013, "udp" },
+ { "broker_service", { NULL }, 3014, "tcp" },
+ { "broker_service", { NULL }, 3014, "udp" },
+ { "nati-dstp", { NULL }, 3015, "tcp" },
+ { "nati-dstp", { NULL }, 3015, "udp" },
+ { "notify_srvr", { NULL }, 3016, "tcp" },
+ { "notify_srvr", { NULL }, 3016, "udp" },
+ { "event_listener", { NULL }, 3017, "tcp" },
+ { "event_listener", { NULL }, 3017, "udp" },
+ { "srvc_registry", { NULL }, 3018, "tcp" },
+ { "srvc_registry", { NULL }, 3018, "udp" },
+ { "resource_mgr", { NULL }, 3019, "tcp" },
+ { "resource_mgr", { NULL }, 3019, "udp" },
+ { "cifs", { NULL }, 3020, "tcp" },
+ { "cifs", { NULL }, 3020, "udp" },
+ { "agriserver", { NULL }, 3021, "tcp" },
+ { "agriserver", { NULL }, 3021, "udp" },
+ { "csregagent", { NULL }, 3022, "tcp" },
+ { "csregagent", { NULL }, 3022, "udp" },
+ { "magicnotes", { NULL }, 3023, "tcp" },
+ { "magicnotes", { NULL }, 3023, "udp" },
+ { "nds_sso", { NULL }, 3024, "tcp" },
+ { "nds_sso", { NULL }, 3024, "udp" },
+ { "arepa-raft", { NULL }, 3025, "tcp" },
+ { "arepa-raft", { NULL }, 3025, "udp" },
+ { "agri-gateway", { NULL }, 3026, "tcp" },
+ { "agri-gateway", { NULL }, 3026, "udp" },
+ { "LiebDevMgmt_C", { NULL }, 3027, "tcp" },
+ { "LiebDevMgmt_C", { NULL }, 3027, "udp" },
+ { "LiebDevMgmt_DM", { NULL }, 3028, "tcp" },
+ { "LiebDevMgmt_DM", { NULL }, 3028, "udp" },
+ { "LiebDevMgmt_A", { NULL }, 3029, "tcp" },
+ { "LiebDevMgmt_A", { NULL }, 3029, "udp" },
+ { "arepa-cas", { NULL }, 3030, "tcp" },
+ { "arepa-cas", { NULL }, 3030, "udp" },
+ { "eppc", { NULL }, 3031, "tcp" },
+ { "eppc", { NULL }, 3031, "udp" },
+ { "redwood-chat", { NULL }, 3032, "tcp" },
+ { "redwood-chat", { NULL }, 3032, "udp" },
+ { "pdb", { NULL }, 3033, "tcp" },
+ { "pdb", { NULL }, 3033, "udp" },
+ { "osmosis-aeea", { NULL }, 3034, "tcp" },
+ { "osmosis-aeea", { NULL }, 3034, "udp" },
+ { "fjsv-gssagt", { NULL }, 3035, "tcp" },
+ { "fjsv-gssagt", { NULL }, 3035, "udp" },
+ { "hagel-dump", { NULL }, 3036, "tcp" },
+ { "hagel-dump", { NULL }, 3036, "udp" },
+ { "hp-san-mgmt", { NULL }, 3037, "tcp" },
+ { "hp-san-mgmt", { NULL }, 3037, "udp" },
+ { "santak-ups", { NULL }, 3038, "tcp" },
+ { "santak-ups", { NULL }, 3038, "udp" },
+ { "cogitate", { NULL }, 3039, "tcp" },
+ { "cogitate", { NULL }, 3039, "udp" },
+ { "tomato-springs", { NULL }, 3040, "tcp" },
+ { "tomato-springs", { NULL }, 3040, "udp" },
+ { "di-traceware", { NULL }, 3041, "tcp" },
+ { "di-traceware", { NULL }, 3041, "udp" },
+ { "journee", { NULL }, 3042, "tcp" },
+ { "journee", { NULL }, 3042, "udp" },
+ { "brp", { NULL }, 3043, "tcp" },
+ { "brp", { NULL }, 3043, "udp" },
+ { "epp", { NULL }, 3044, "tcp" },
+ { "epp", { NULL }, 3044, "udp" },
+ { "responsenet", { NULL }, 3045, "tcp" },
+ { "responsenet", { NULL }, 3045, "udp" },
+ { "di-ase", { NULL }, 3046, "tcp" },
+ { "di-ase", { NULL }, 3046, "udp" },
+ { "hlserver", { NULL }, 3047, "tcp" },
+ { "hlserver", { NULL }, 3047, "udp" },
+ { "pctrader", { NULL }, 3048, "tcp" },
+ { "pctrader", { NULL }, 3048, "udp" },
+ { "nsws", { NULL }, 3049, "tcp" },
+ { "nsws", { NULL }, 3049, "udp" },
+ { "gds_db", { NULL }, 3050, "tcp" },
+ { "gds_db", { NULL }, 3050, "udp" },
+ { "galaxy-server", { NULL }, 3051, "tcp" },
+ { "galaxy-server", { NULL }, 3051, "udp" },
+ { "apc-3052", { NULL }, 3052, "tcp" },
+ { "apc-3052", { NULL }, 3052, "udp" },
+ { "dsom-server", { NULL }, 3053, "tcp" },
+ { "dsom-server", { NULL }, 3053, "udp" },
+ { "amt-cnf-prot", { NULL }, 3054, "tcp" },
+ { "amt-cnf-prot", { NULL }, 3054, "udp" },
+ { "policyserver", { NULL }, 3055, "tcp" },
+ { "policyserver", { NULL }, 3055, "udp" },
+ { "cdl-server", { NULL }, 3056, "tcp" },
+ { "cdl-server", { NULL }, 3056, "udp" },
+ { "goahead-fldup", { NULL }, 3057, "tcp" },
+ { "goahead-fldup", { NULL }, 3057, "udp" },
+ { "videobeans", { NULL }, 3058, "tcp" },
+ { "videobeans", { NULL }, 3058, "udp" },
+ { "qsoft", { NULL }, 3059, "tcp" },
+ { "qsoft", { NULL }, 3059, "udp" },
+ { "interserver", { NULL }, 3060, "tcp" },
+ { "interserver", { NULL }, 3060, "udp" },
+ { "cautcpd", { NULL }, 3061, "tcp" },
+ { "cautcpd", { NULL }, 3061, "udp" },
+ { "ncacn-ip-tcp", { NULL }, 3062, "tcp" },
+ { "ncacn-ip-tcp", { NULL }, 3062, "udp" },
+ { "ncadg-ip-udp", { NULL }, 3063, "tcp" },
+ { "ncadg-ip-udp", { NULL }, 3063, "udp" },
+ { "rprt", { NULL }, 3064, "tcp" },
+ { "rprt", { NULL }, 3064, "udp" },
+ { "slinterbase", { NULL }, 3065, "tcp" },
+ { "slinterbase", { NULL }, 3065, "udp" },
+ { "netattachsdmp", { NULL }, 3066, "tcp" },
+ { "netattachsdmp", { NULL }, 3066, "udp" },
+ { "fjhpjp", { NULL }, 3067, "tcp" },
+ { "fjhpjp", { NULL }, 3067, "udp" },
+ { "ls3bcast", { NULL }, 3068, "tcp" },
+ { "ls3bcast", { NULL }, 3068, "udp" },
+ { "ls3", { NULL }, 3069, "tcp" },
+ { "ls3", { NULL }, 3069, "udp" },
+ { "mgxswitch", { NULL }, 3070, "tcp" },
+ { "mgxswitch", { NULL }, 3070, "udp" },
+ { "csd-mgmt-port", { NULL }, 3071, "tcp" },
+ { "csd-mgmt-port", { NULL }, 3071, "udp" },
+ { "csd-monitor", { NULL }, 3072, "tcp" },
+ { "csd-monitor", { NULL }, 3072, "udp" },
+ { "vcrp", { NULL }, 3073, "tcp" },
+ { "vcrp", { NULL }, 3073, "udp" },
+ { "xbox", { NULL }, 3074, "tcp" },
+ { "xbox", { NULL }, 3074, "udp" },
+ { "orbix-locator", { NULL }, 3075, "tcp" },
+ { "orbix-locator", { NULL }, 3075, "udp" },
+ { "orbix-config", { NULL }, 3076, "tcp" },
+ { "orbix-config", { NULL }, 3076, "udp" },
+ { "orbix-loc-ssl", { NULL }, 3077, "tcp" },
+ { "orbix-loc-ssl", { NULL }, 3077, "udp" },
+ { "orbix-cfg-ssl", { NULL }, 3078, "tcp" },
+ { "orbix-cfg-ssl", { NULL }, 3078, "udp" },
+ { "lv-frontpanel", { NULL }, 3079, "tcp" },
+ { "lv-frontpanel", { NULL }, 3079, "udp" },
+ { "stm_pproc", { NULL }, 3080, "tcp" },
+ { "stm_pproc", { NULL }, 3080, "udp" },
+ { "tl1-lv", { NULL }, 3081, "tcp" },
+ { "tl1-lv", { NULL }, 3081, "udp" },
+ { "tl1-raw", { NULL }, 3082, "tcp" },
+ { "tl1-raw", { NULL }, 3082, "udp" },
+ { "tl1-telnet", { NULL }, 3083, "tcp" },
+ { "tl1-telnet", { NULL }, 3083, "udp" },
+ { "itm-mccs", { NULL }, 3084, "tcp" },
+ { "itm-mccs", { NULL }, 3084, "udp" },
+ { "pcihreq", { NULL }, 3085, "tcp" },
+ { "pcihreq", { NULL }, 3085, "udp" },
+ { "jdl-dbkitchen", { NULL }, 3086, "tcp" },
+ { "jdl-dbkitchen", { NULL }, 3086, "udp" },
+ { "asoki-sma", { NULL }, 3087, "tcp" },
+ { "asoki-sma", { NULL }, 3087, "udp" },
+ { "xdtp", { NULL }, 3088, "tcp" },
+ { "xdtp", { NULL }, 3088, "udp" },
+ { "ptk-alink", { NULL }, 3089, "tcp" },
+ { "ptk-alink", { NULL }, 3089, "udp" },
+ { "stss", { NULL }, 3090, "tcp" },
+ { "stss", { NULL }, 3090, "udp" },
+ { "1ci-smcs", { NULL }, 3091, "tcp" },
+ { "1ci-smcs", { NULL }, 3091, "udp" },
+ { "rapidmq-center", { NULL }, 3093, "tcp" },
+ { "rapidmq-center", { NULL }, 3093, "udp" },
+ { "rapidmq-reg", { NULL }, 3094, "tcp" },
+ { "rapidmq-reg", { NULL }, 3094, "udp" },
+ { "panasas", { NULL }, 3095, "tcp" },
+ { "panasas", { NULL }, 3095, "udp" },
+ { "ndl-aps", { NULL }, 3096, "tcp" },
+ { "ndl-aps", { NULL }, 3096, "udp" },
+ { "itu-bicc-stc", { NULL }, 3097, "sctp"},
+ { "umm-port", { NULL }, 3098, "tcp" },
+ { "umm-port", { NULL }, 3098, "udp" },
+ { "chmd", { NULL }, 3099, "tcp" },
+ { "chmd", { NULL }, 3099, "udp" },
+ { "opcon-xps", { NULL }, 3100, "tcp" },
+ { "opcon-xps", { NULL }, 3100, "udp" },
+ { "hp-pxpib", { NULL }, 3101, "tcp" },
+ { "hp-pxpib", { NULL }, 3101, "udp" },
+ { "slslavemon", { NULL }, 3102, "tcp" },
+ { "slslavemon", { NULL }, 3102, "udp" },
+ { "autocuesmi", { NULL }, 3103, "tcp" },
+ { "autocuesmi", { NULL }, 3103, "udp" },
+ { "autocuelog", { NULL }, 3104, "tcp" },
+ { "autocuetime", { NULL }, 3104, "udp" },
+ { "cardbox", { NULL }, 3105, "tcp" },
+ { "cardbox", { NULL }, 3105, "udp" },
+ { "cardbox-http", { NULL }, 3106, "tcp" },
+ { "cardbox-http", { NULL }, 3106, "udp" },
+ { "business", { NULL }, 3107, "tcp" },
+ { "business", { NULL }, 3107, "udp" },
+ { "geolocate", { NULL }, 3108, "tcp" },
+ { "geolocate", { NULL }, 3108, "udp" },
+ { "personnel", { NULL }, 3109, "tcp" },
+ { "personnel", { NULL }, 3109, "udp" },
+ { "sim-control", { NULL }, 3110, "tcp" },
+ { "sim-control", { NULL }, 3110, "udp" },
+ { "wsynch", { NULL }, 3111, "tcp" },
+ { "wsynch", { NULL }, 3111, "udp" },
+ { "ksysguard", { NULL }, 3112, "tcp" },
+ { "ksysguard", { NULL }, 3112, "udp" },
+ { "cs-auth-svr", { NULL }, 3113, "tcp" },
+ { "cs-auth-svr", { NULL }, 3113, "udp" },
+ { "ccmad", { NULL }, 3114, "tcp" },
+ { "ccmad", { NULL }, 3114, "udp" },
+ { "mctet-master", { NULL }, 3115, "tcp" },
+ { "mctet-master", { NULL }, 3115, "udp" },
+ { "mctet-gateway", { NULL }, 3116, "tcp" },
+ { "mctet-gateway", { NULL }, 3116, "udp" },
+ { "mctet-jserv", { NULL }, 3117, "tcp" },
+ { "mctet-jserv", { NULL }, 3117, "udp" },
+ { "pkagent", { NULL }, 3118, "tcp" },
+ { "pkagent", { NULL }, 3118, "udp" },
+ { "d2000kernel", { NULL }, 3119, "tcp" },
+ { "d2000kernel", { NULL }, 3119, "udp" },
+ { "d2000webserver", { NULL }, 3120, "tcp" },
+ { "d2000webserver", { NULL }, 3120, "udp" },
+ { "vtr-emulator", { NULL }, 3122, "tcp" },
+ { "vtr-emulator", { NULL }, 3122, "udp" },
+ { "edix", { NULL }, 3123, "tcp" },
+ { "edix", { NULL }, 3123, "udp" },
+ { "beacon-port", { NULL }, 3124, "tcp" },
+ { "beacon-port", { NULL }, 3124, "udp" },
+ { "a13-an", { NULL }, 3125, "tcp" },
+ { "a13-an", { NULL }, 3125, "udp" },
+ { "ctx-bridge", { NULL }, 3127, "tcp" },
+ { "ctx-bridge", { NULL }, 3127, "udp" },
+ { "ndl-aas", { NULL }, 3128, "tcp" },
+ { "ndl-aas", { NULL }, 3128, "udp" },
+ { "netport-id", { NULL }, 3129, "tcp" },
+ { "netport-id", { NULL }, 3129, "udp" },
+ { "icpv2", { NULL }, 3130, "tcp" },
+ { "icpv2", { NULL }, 3130, "udp" },
+ { "netbookmark", { NULL }, 3131, "tcp" },
+ { "netbookmark", { NULL }, 3131, "udp" },
+ { "ms-rule-engine", { NULL }, 3132, "tcp" },
+ { "ms-rule-engine", { NULL }, 3132, "udp" },
+ { "prism-deploy", { NULL }, 3133, "tcp" },
+ { "prism-deploy", { NULL }, 3133, "udp" },
+ { "ecp", { NULL }, 3134, "tcp" },
+ { "ecp", { NULL }, 3134, "udp" },
+ { "peerbook-port", { NULL }, 3135, "tcp" },
+ { "peerbook-port", { NULL }, 3135, "udp" },
+ { "grubd", { NULL }, 3136, "tcp" },
+ { "grubd", { NULL }, 3136, "udp" },
+ { "rtnt-1", { NULL }, 3137, "tcp" },
+ { "rtnt-1", { NULL }, 3137, "udp" },
+ { "rtnt-2", { NULL }, 3138, "tcp" },
+ { "rtnt-2", { NULL }, 3138, "udp" },
+ { "incognitorv", { NULL }, 3139, "tcp" },
+ { "incognitorv", { NULL }, 3139, "udp" },
+ { "ariliamulti", { NULL }, 3140, "tcp" },
+ { "ariliamulti", { NULL }, 3140, "udp" },
+ { "vmodem", { NULL }, 3141, "tcp" },
+ { "vmodem", { NULL }, 3141, "udp" },
+ { "rdc-wh-eos", { NULL }, 3142, "tcp" },
+ { "rdc-wh-eos", { NULL }, 3142, "udp" },
+ { "seaview", { NULL }, 3143, "tcp" },
+ { "seaview", { NULL }, 3143, "udp" },
+ { "tarantella", { NULL }, 3144, "tcp" },
+ { "tarantella", { NULL }, 3144, "udp" },
+ { "csi-lfap", { NULL }, 3145, "tcp" },
+ { "csi-lfap", { NULL }, 3145, "udp" },
+ { "bears-02", { NULL }, 3146, "tcp" },
+ { "bears-02", { NULL }, 3146, "udp" },
+ { "rfio", { NULL }, 3147, "tcp" },
+ { "rfio", { NULL }, 3147, "udp" },
+ { "nm-game-admin", { NULL }, 3148, "tcp" },
+ { "nm-game-admin", { NULL }, 3148, "udp" },
+ { "nm-game-server", { NULL }, 3149, "tcp" },
+ { "nm-game-server", { NULL }, 3149, "udp" },
+ { "nm-asses-admin", { NULL }, 3150, "tcp" },
+ { "nm-asses-admin", { NULL }, 3150, "udp" },
+ { "nm-assessor", { NULL }, 3151, "tcp" },
+ { "nm-assessor", { NULL }, 3151, "udp" },
+ { "feitianrockey", { NULL }, 3152, "tcp" },
+ { "feitianrockey", { NULL }, 3152, "udp" },
+ { "s8-client-port", { NULL }, 3153, "tcp" },
+ { "s8-client-port", { NULL }, 3153, "udp" },
+ { "ccmrmi", { NULL }, 3154, "tcp" },
+ { "ccmrmi", { NULL }, 3154, "udp" },
+ { "jpegmpeg", { NULL }, 3155, "tcp" },
+ { "jpegmpeg", { NULL }, 3155, "udp" },
+ { "indura", { NULL }, 3156, "tcp" },
+ { "indura", { NULL }, 3156, "udp" },
+ { "e3consultants", { NULL }, 3157, "tcp" },
+ { "e3consultants", { NULL }, 3157, "udp" },
+ { "stvp", { NULL }, 3158, "tcp" },
+ { "stvp", { NULL }, 3158, "udp" },
+ { "navegaweb-port", { NULL }, 3159, "tcp" },
+ { "navegaweb-port", { NULL }, 3159, "udp" },
+ { "tip-app-server", { NULL }, 3160, "tcp" },
+ { "tip-app-server", { NULL }, 3160, "udp" },
+ { "doc1lm", { NULL }, 3161, "tcp" },
+ { "doc1lm", { NULL }, 3161, "udp" },
+ { "sflm", { NULL }, 3162, "tcp" },
+ { "sflm", { NULL }, 3162, "udp" },
+ { "res-sap", { NULL }, 3163, "tcp" },
+ { "res-sap", { NULL }, 3163, "udp" },
+ { "imprs", { NULL }, 3164, "tcp" },
+ { "imprs", { NULL }, 3164, "udp" },
+ { "newgenpay", { NULL }, 3165, "tcp" },
+ { "newgenpay", { NULL }, 3165, "udp" },
+ { "sossecollector", { NULL }, 3166, "tcp" },
+ { "sossecollector", { NULL }, 3166, "udp" },
+ { "nowcontact", { NULL }, 3167, "tcp" },
+ { "nowcontact", { NULL }, 3167, "udp" },
+ { "poweronnud", { NULL }, 3168, "tcp" },
+ { "poweronnud", { NULL }, 3168, "udp" },
+ { "serverview-as", { NULL }, 3169, "tcp" },
+ { "serverview-as", { NULL }, 3169, "udp" },
+ { "serverview-asn", { NULL }, 3170, "tcp" },
+ { "serverview-asn", { NULL }, 3170, "udp" },
+ { "serverview-gf", { NULL }, 3171, "tcp" },
+ { "serverview-gf", { NULL }, 3171, "udp" },
+ { "serverview-rm", { NULL }, 3172, "tcp" },
+ { "serverview-rm", { NULL }, 3172, "udp" },
+ { "serverview-icc", { NULL }, 3173, "tcp" },
+ { "serverview-icc", { NULL }, 3173, "udp" },
+ { "armi-server", { NULL }, 3174, "tcp" },
+ { "armi-server", { NULL }, 3174, "udp" },
+ { "t1-e1-over-ip", { NULL }, 3175, "tcp" },
+ { "t1-e1-over-ip", { NULL }, 3175, "udp" },
+ { "ars-master", { NULL }, 3176, "tcp" },
+ { "ars-master", { NULL }, 3176, "udp" },
+ { "phonex-port", { NULL }, 3177, "tcp" },
+ { "phonex-port", { NULL }, 3177, "udp" },
+ { "radclientport", { NULL }, 3178, "tcp" },
+ { "radclientport", { NULL }, 3178, "udp" },
+ { "h2gf-w-2m", { NULL }, 3179, "tcp" },
+ { "h2gf-w-2m", { NULL }, 3179, "udp" },
+ { "mc-brk-srv", { NULL }, 3180, "tcp" },
+ { "mc-brk-srv", { NULL }, 3180, "udp" },
+ { "bmcpatrolagent", { NULL }, 3181, "tcp" },
+ { "bmcpatrolagent", { NULL }, 3181, "udp" },
+ { "bmcpatrolrnvu", { NULL }, 3182, "tcp" },
+ { "bmcpatrolrnvu", { NULL }, 3182, "udp" },
+ { "cops-tls", { NULL }, 3183, "tcp" },
+ { "cops-tls", { NULL }, 3183, "udp" },
+ { "apogeex-port", { NULL }, 3184, "tcp" },
+ { "apogeex-port", { NULL }, 3184, "udp" },
+ { "smpppd", { NULL }, 3185, "tcp" },
+ { "smpppd", { NULL }, 3185, "udp" },
+ { "iiw-port", { NULL }, 3186, "tcp" },
+ { "iiw-port", { NULL }, 3186, "udp" },
+ { "odi-port", { NULL }, 3187, "tcp" },
+ { "odi-port", { NULL }, 3187, "udp" },
+ { "brcm-comm-port", { NULL }, 3188, "tcp" },
+ { "brcm-comm-port", { NULL }, 3188, "udp" },
+ { "pcle-infex", { NULL }, 3189, "tcp" },
+ { "pcle-infex", { NULL }, 3189, "udp" },
+ { "csvr-proxy", { NULL }, 3190, "tcp" },
+ { "csvr-proxy", { NULL }, 3190, "udp" },
+ { "csvr-sslproxy", { NULL }, 3191, "tcp" },
+ { "csvr-sslproxy", { NULL }, 3191, "udp" },
+ { "firemonrcc", { NULL }, 3192, "tcp" },
+ { "firemonrcc", { NULL }, 3192, "udp" },
+ { "spandataport", { NULL }, 3193, "tcp" },
+ { "spandataport", { NULL }, 3193, "udp" },
+ { "magbind", { NULL }, 3194, "tcp" },
+ { "magbind", { NULL }, 3194, "udp" },
+ { "ncu-1", { NULL }, 3195, "tcp" },
+ { "ncu-1", { NULL }, 3195, "udp" },
+ { "ncu-2", { NULL }, 3196, "tcp" },
+ { "ncu-2", { NULL }, 3196, "udp" },
+ { "embrace-dp-s", { NULL }, 3197, "tcp" },
+ { "embrace-dp-s", { NULL }, 3197, "udp" },
+ { "embrace-dp-c", { NULL }, 3198, "tcp" },
+ { "embrace-dp-c", { NULL }, 3198, "udp" },
+ { "dmod-workspace", { NULL }, 3199, "tcp" },
+ { "dmod-workspace", { NULL }, 3199, "udp" },
+ { "tick-port", { NULL }, 3200, "tcp" },
+ { "tick-port", { NULL }, 3200, "udp" },
+ { "cpq-tasksmart", { NULL }, 3201, "tcp" },
+ { "cpq-tasksmart", { NULL }, 3201, "udp" },
+ { "intraintra", { NULL }, 3202, "tcp" },
+ { "intraintra", { NULL }, 3202, "udp" },
+ { "netwatcher-mon", { NULL }, 3203, "tcp" },
+ { "netwatcher-mon", { NULL }, 3203, "udp" },
+ { "netwatcher-db", { NULL }, 3204, "tcp" },
+ { "netwatcher-db", { NULL }, 3204, "udp" },
+ { "isns", { NULL }, 3205, "tcp" },
+ { "isns", { NULL }, 3205, "udp" },
+ { "ironmail", { NULL }, 3206, "tcp" },
+ { "ironmail", { NULL }, 3206, "udp" },
+ { "vx-auth-port", { NULL }, 3207, "tcp" },
+ { "vx-auth-port", { NULL }, 3207, "udp" },
+ { "pfu-prcallback", { NULL }, 3208, "tcp" },
+ { "pfu-prcallback", { NULL }, 3208, "udp" },
+ { "netwkpathengine", { NULL }, 3209, "tcp" },
+ { "netwkpathengine", { NULL }, 3209, "udp" },
+ { "flamenco-proxy", { NULL }, 3210, "tcp" },
+ { "flamenco-proxy", { NULL }, 3210, "udp" },
+ { "avsecuremgmt", { NULL }, 3211, "tcp" },
+ { "avsecuremgmt", { NULL }, 3211, "udp" },
+ { "surveyinst", { NULL }, 3212, "tcp" },
+ { "surveyinst", { NULL }, 3212, "udp" },
+ { "neon24x7", { NULL }, 3213, "tcp" },
+ { "neon24x7", { NULL }, 3213, "udp" },
+ { "jmq-daemon-1", { NULL }, 3214, "tcp" },
+ { "jmq-daemon-1", { NULL }, 3214, "udp" },
+ { "jmq-daemon-2", { NULL }, 3215, "tcp" },
+ { "jmq-daemon-2", { NULL }, 3215, "udp" },
+ { "ferrari-foam", { NULL }, 3216, "tcp" },
+ { "ferrari-foam", { NULL }, 3216, "udp" },
+ { "unite", { NULL }, 3217, "tcp" },
+ { "unite", { NULL }, 3217, "udp" },
+ { "smartpackets", { NULL }, 3218, "tcp" },
+ { "smartpackets", { NULL }, 3218, "udp" },
+ { "wms-messenger", { NULL }, 3219, "tcp" },
+ { "wms-messenger", { NULL }, 3219, "udp" },
+ { "xnm-ssl", { NULL }, 3220, "tcp" },
+ { "xnm-ssl", { NULL }, 3220, "udp" },
+ { "xnm-clear-text", { NULL }, 3221, "tcp" },
+ { "xnm-clear-text", { NULL }, 3221, "udp" },
+ { "glbp", { NULL }, 3222, "tcp" },
+ { "glbp", { NULL }, 3222, "udp" },
+ { "digivote", { NULL }, 3223, "tcp" },
+ { "digivote", { NULL }, 3223, "udp" },
+ { "aes-discovery", { NULL }, 3224, "tcp" },
+ { "aes-discovery", { NULL }, 3224, "udp" },
+ { "fcip-port", { NULL }, 3225, "tcp" },
+ { "fcip-port", { NULL }, 3225, "udp" },
+ { "isi-irp", { NULL }, 3226, "tcp" },
+ { "isi-irp", { NULL }, 3226, "udp" },
+ { "dwnmshttp", { NULL }, 3227, "tcp" },
+ { "dwnmshttp", { NULL }, 3227, "udp" },
+ { "dwmsgserver", { NULL }, 3228, "tcp" },
+ { "dwmsgserver", { NULL }, 3228, "udp" },
+ { "global-cd-port", { NULL }, 3229, "tcp" },
+ { "global-cd-port", { NULL }, 3229, "udp" },
+ { "sftdst-port", { NULL }, 3230, "tcp" },
+ { "sftdst-port", { NULL }, 3230, "udp" },
+ { "vidigo", { NULL }, 3231, "tcp" },
+ { "vidigo", { NULL }, 3231, "udp" },
+ { "mdtp", { NULL }, 3232, "tcp" },
+ { "mdtp", { NULL }, 3232, "udp" },
+ { "whisker", { NULL }, 3233, "tcp" },
+ { "whisker", { NULL }, 3233, "udp" },
+ { "alchemy", { NULL }, 3234, "tcp" },
+ { "alchemy", { NULL }, 3234, "udp" },
+ { "mdap-port", { NULL }, 3235, "tcp" },
+ { "mdap-port", { NULL }, 3235, "udp" },
+ { "apparenet-ts", { NULL }, 3236, "tcp" },
+ { "apparenet-ts", { NULL }, 3236, "udp" },
+ { "apparenet-tps", { NULL }, 3237, "tcp" },
+ { "apparenet-tps", { NULL }, 3237, "udp" },
+ { "apparenet-as", { NULL }, 3238, "tcp" },
+ { "apparenet-as", { NULL }, 3238, "udp" },
+ { "apparenet-ui", { NULL }, 3239, "tcp" },
+ { "apparenet-ui", { NULL }, 3239, "udp" },
+ { "triomotion", { NULL }, 3240, "tcp" },
+ { "triomotion", { NULL }, 3240, "udp" },
+ { "sysorb", { NULL }, 3241, "tcp" },
+ { "sysorb", { NULL }, 3241, "udp" },
+ { "sdp-id-port", { NULL }, 3242, "tcp" },
+ { "sdp-id-port", { NULL }, 3242, "udp" },
+ { "timelot", { NULL }, 3243, "tcp" },
+ { "timelot", { NULL }, 3243, "udp" },
+ { "onesaf", { NULL }, 3244, "tcp" },
+ { "onesaf", { NULL }, 3244, "udp" },
+ { "vieo-fe", { NULL }, 3245, "tcp" },
+ { "vieo-fe", { NULL }, 3245, "udp" },
+ { "dvt-system", { NULL }, 3246, "tcp" },
+ { "dvt-system", { NULL }, 3246, "udp" },
+ { "dvt-data", { NULL }, 3247, "tcp" },
+ { "dvt-data", { NULL }, 3247, "udp" },
+ { "procos-lm", { NULL }, 3248, "tcp" },
+ { "procos-lm", { NULL }, 3248, "udp" },
+ { "ssp", { NULL }, 3249, "tcp" },
+ { "ssp", { NULL }, 3249, "udp" },
+ { "hicp", { NULL }, 3250, "tcp" },
+ { "hicp", { NULL }, 3250, "udp" },
+ { "sysscanner", { NULL }, 3251, "tcp" },
+ { "sysscanner", { NULL }, 3251, "udp" },
+ { "dhe", { NULL }, 3252, "tcp" },
+ { "dhe", { NULL }, 3252, "udp" },
+ { "pda-data", { NULL }, 3253, "tcp" },
+ { "pda-data", { NULL }, 3253, "udp" },
+ { "pda-sys", { NULL }, 3254, "tcp" },
+ { "pda-sys", { NULL }, 3254, "udp" },
+ { "semaphore", { NULL }, 3255, "tcp" },
+ { "semaphore", { NULL }, 3255, "udp" },
+ { "cpqrpm-agent", { NULL }, 3256, "tcp" },
+ { "cpqrpm-agent", { NULL }, 3256, "udp" },
+ { "cpqrpm-server", { NULL }, 3257, "tcp" },
+ { "cpqrpm-server", { NULL }, 3257, "udp" },
+ { "ivecon-port", { NULL }, 3258, "tcp" },
+ { "ivecon-port", { NULL }, 3258, "udp" },
+ { "epncdp2", { NULL }, 3259, "tcp" },
+ { "epncdp2", { NULL }, 3259, "udp" },
+ { "iscsi-target", { NULL }, 3260, "tcp" },
+ { "iscsi-target", { NULL }, 3260, "udp" },
+ { "winshadow", { NULL }, 3261, "tcp" },
+ { "winshadow", { NULL }, 3261, "udp" },
+ { "necp", { NULL }, 3262, "tcp" },
+ { "necp", { NULL }, 3262, "udp" },
+ { "ecolor-imager", { NULL }, 3263, "tcp" },
+ { "ecolor-imager", { NULL }, 3263, "udp" },
+ { "ccmail", { NULL }, 3264, "tcp" },
+ { "ccmail", { NULL }, 3264, "udp" },
+ { "altav-tunnel", { NULL }, 3265, "tcp" },
+ { "altav-tunnel", { NULL }, 3265, "udp" },
+ { "ns-cfg-server", { NULL }, 3266, "tcp" },
+ { "ns-cfg-server", { NULL }, 3266, "udp" },
+ { "ibm-dial-out", { NULL }, 3267, "tcp" },
+ { "ibm-dial-out", { NULL }, 3267, "udp" },
+ { "msft-gc", { NULL }, 3268, "tcp" },
+ { "msft-gc", { NULL }, 3268, "udp" },
+ { "msft-gc-ssl", { NULL }, 3269, "tcp" },
+ { "msft-gc-ssl", { NULL }, 3269, "udp" },
+ { "verismart", { NULL }, 3270, "tcp" },
+ { "verismart", { NULL }, 3270, "udp" },
+ { "csoft-prev", { NULL }, 3271, "tcp" },
+ { "csoft-prev", { NULL }, 3271, "udp" },
+ { "user-manager", { NULL }, 3272, "tcp" },
+ { "user-manager", { NULL }, 3272, "udp" },
+ { "sxmp", { NULL }, 3273, "tcp" },
+ { "sxmp", { NULL }, 3273, "udp" },
+ { "ordinox-server", { NULL }, 3274, "tcp" },
+ { "ordinox-server", { NULL }, 3274, "udp" },
+ { "samd", { NULL }, 3275, "tcp" },
+ { "samd", { NULL }, 3275, "udp" },
+ { "maxim-asics", { NULL }, 3276, "tcp" },
+ { "maxim-asics", { NULL }, 3276, "udp" },
+ { "awg-proxy", { NULL }, 3277, "tcp" },
+ { "awg-proxy", { NULL }, 3277, "udp" },
+ { "lkcmserver", { NULL }, 3278, "tcp" },
+ { "lkcmserver", { NULL }, 3278, "udp" },
+ { "admind", { NULL }, 3279, "tcp" },
+ { "admind", { NULL }, 3279, "udp" },
+ { "vs-server", { NULL }, 3280, "tcp" },
+ { "vs-server", { NULL }, 3280, "udp" },
+ { "sysopt", { NULL }, 3281, "tcp" },
+ { "sysopt", { NULL }, 3281, "udp" },
+ { "datusorb", { NULL }, 3282, "tcp" },
+ { "datusorb", { NULL }, 3282, "udp" },
+ { "net-assistant", { NULL }, 3283, "tcp" },
+ { "net-assistant", { NULL }, 3283, "udp" },
+ { "4talk", { NULL }, 3284, "tcp" },
+ { "4talk", { NULL }, 3284, "udp" },
+ { "plato", { NULL }, 3285, "tcp" },
+ { "plato", { NULL }, 3285, "udp" },
+ { "e-net", { NULL }, 3286, "tcp" },
+ { "e-net", { NULL }, 3286, "udp" },
+ { "directvdata", { NULL }, 3287, "tcp" },
+ { "directvdata", { NULL }, 3287, "udp" },
+ { "cops", { NULL }, 3288, "tcp" },
+ { "cops", { NULL }, 3288, "udp" },
+ { "enpc", { NULL }, 3289, "tcp" },
+ { "enpc", { NULL }, 3289, "udp" },
+ { "caps-lm", { NULL }, 3290, "tcp" },
+ { "caps-lm", { NULL }, 3290, "udp" },
+ { "sah-lm", { NULL }, 3291, "tcp" },
+ { "sah-lm", { NULL }, 3291, "udp" },
+ { "cart-o-rama", { NULL }, 3292, "tcp" },
+ { "cart-o-rama", { NULL }, 3292, "udp" },
+ { "fg-fps", { NULL }, 3293, "tcp" },
+ { "fg-fps", { NULL }, 3293, "udp" },
+ { "fg-gip", { NULL }, 3294, "tcp" },
+ { "fg-gip", { NULL }, 3294, "udp" },
+ { "dyniplookup", { NULL }, 3295, "tcp" },
+ { "dyniplookup", { NULL }, 3295, "udp" },
+ { "rib-slm", { NULL }, 3296, "tcp" },
+ { "rib-slm", { NULL }, 3296, "udp" },
+ { "cytel-lm", { NULL }, 3297, "tcp" },
+ { "cytel-lm", { NULL }, 3297, "udp" },
+ { "deskview", { NULL }, 3298, "tcp" },
+ { "deskview", { NULL }, 3298, "udp" },
+ { "pdrncs", { NULL }, 3299, "tcp" },
+ { "pdrncs", { NULL }, 3299, "udp" },
+ { "mcs-fastmail", { NULL }, 3302, "tcp" },
+ { "mcs-fastmail", { NULL }, 3302, "udp" },
+ { "opsession-clnt", { NULL }, 3303, "tcp" },
+ { "opsession-clnt", { NULL }, 3303, "udp" },
+ { "opsession-srvr", { NULL }, 3304, "tcp" },
+ { "opsession-srvr", { NULL }, 3304, "udp" },
+ { "odette-ftp", { NULL }, 3305, "tcp" },
+ { "odette-ftp", { NULL }, 3305, "udp" },
+ { "mysql", { NULL }, 3306, "tcp" },
+ { "mysql", { NULL }, 3306, "udp" },
+ { "opsession-prxy", { NULL }, 3307, "tcp" },
+ { "opsession-prxy", { NULL }, 3307, "udp" },
+ { "tns-server", { NULL }, 3308, "tcp" },
+ { "tns-server", { NULL }, 3308, "udp" },
+ { "tns-adv", { NULL }, 3309, "tcp" },
+ { "tns-adv", { NULL }, 3309, "udp" },
+ { "dyna-access", { NULL }, 3310, "tcp" },
+ { "dyna-access", { NULL }, 3310, "udp" },
+ { "mcns-tel-ret", { NULL }, 3311, "tcp" },
+ { "mcns-tel-ret", { NULL }, 3311, "udp" },
+ { "appman-server", { NULL }, 3312, "tcp" },
+ { "appman-server", { NULL }, 3312, "udp" },
+ { "uorb", { NULL }, 3313, "tcp" },
+ { "uorb", { NULL }, 3313, "udp" },
+ { "uohost", { NULL }, 3314, "tcp" },
+ { "uohost", { NULL }, 3314, "udp" },
+ { "cdid", { NULL }, 3315, "tcp" },
+ { "cdid", { NULL }, 3315, "udp" },
+ { "aicc-cmi", { NULL }, 3316, "tcp" },
+ { "aicc-cmi", { NULL }, 3316, "udp" },
+ { "vsaiport", { NULL }, 3317, "tcp" },
+ { "vsaiport", { NULL }, 3317, "udp" },
+ { "ssrip", { NULL }, 3318, "tcp" },
+ { "ssrip", { NULL }, 3318, "udp" },
+ { "sdt-lmd", { NULL }, 3319, "tcp" },
+ { "sdt-lmd", { NULL }, 3319, "udp" },
+ { "officelink2000", { NULL }, 3320, "tcp" },
+ { "officelink2000", { NULL }, 3320, "udp" },
+ { "vnsstr", { NULL }, 3321, "tcp" },
+ { "vnsstr", { NULL }, 3321, "udp" },
+ { "sftu", { NULL }, 3326, "tcp" },
+ { "sftu", { NULL }, 3326, "udp" },
+ { "bbars", { NULL }, 3327, "tcp" },
+ { "bbars", { NULL }, 3327, "udp" },
+ { "egptlm", { NULL }, 3328, "tcp" },
+ { "egptlm", { NULL }, 3328, "udp" },
+ { "hp-device-disc", { NULL }, 3329, "tcp" },
+ { "hp-device-disc", { NULL }, 3329, "udp" },
+ { "mcs-calypsoicf", { NULL }, 3330, "tcp" },
+ { "mcs-calypsoicf", { NULL }, 3330, "udp" },
+ { "mcs-messaging", { NULL }, 3331, "tcp" },
+ { "mcs-messaging", { NULL }, 3331, "udp" },
+ { "mcs-mailsvr", { NULL }, 3332, "tcp" },
+ { "mcs-mailsvr", { NULL }, 3332, "udp" },
+ { "dec-notes", { NULL }, 3333, "tcp" },
+ { "dec-notes", { NULL }, 3333, "udp" },
+ { "directv-web", { NULL }, 3334, "tcp" },
+ { "directv-web", { NULL }, 3334, "udp" },
+ { "directv-soft", { NULL }, 3335, "tcp" },
+ { "directv-soft", { NULL }, 3335, "udp" },
+ { "directv-tick", { NULL }, 3336, "tcp" },
+ { "directv-tick", { NULL }, 3336, "udp" },
+ { "directv-catlg", { NULL }, 3337, "tcp" },
+ { "directv-catlg", { NULL }, 3337, "udp" },
+ { "anet-b", { NULL }, 3338, "tcp" },
+ { "anet-b", { NULL }, 3338, "udp" },
+ { "anet-l", { NULL }, 3339, "tcp" },
+ { "anet-l", { NULL }, 3339, "udp" },
+ { "anet-m", { NULL }, 3340, "tcp" },
+ { "anet-m", { NULL }, 3340, "udp" },
+ { "anet-h", { NULL }, 3341, "tcp" },
+ { "anet-h", { NULL }, 3341, "udp" },
+ { "webtie", { NULL }, 3342, "tcp" },
+ { "webtie", { NULL }, 3342, "udp" },
+ { "ms-cluster-net", { NULL }, 3343, "tcp" },
+ { "ms-cluster-net", { NULL }, 3343, "udp" },
+ { "bnt-manager", { NULL }, 3344, "tcp" },
+ { "bnt-manager", { NULL }, 3344, "udp" },
+ { "influence", { NULL }, 3345, "tcp" },
+ { "influence", { NULL }, 3345, "udp" },
+ { "trnsprntproxy", { NULL }, 3346, "tcp" },
+ { "trnsprntproxy", { NULL }, 3346, "udp" },
+ { "phoenix-rpc", { NULL }, 3347, "tcp" },
+ { "phoenix-rpc", { NULL }, 3347, "udp" },
+ { "pangolin-laser", { NULL }, 3348, "tcp" },
+ { "pangolin-laser", { NULL }, 3348, "udp" },
+ { "chevinservices", { NULL }, 3349, "tcp" },
+ { "chevinservices", { NULL }, 3349, "udp" },
+ { "findviatv", { NULL }, 3350, "tcp" },
+ { "findviatv", { NULL }, 3350, "udp" },
+ { "btrieve", { NULL }, 3351, "tcp" },
+ { "btrieve", { NULL }, 3351, "udp" },
+ { "ssql", { NULL }, 3352, "tcp" },
+ { "ssql", { NULL }, 3352, "udp" },
+ { "fatpipe", { NULL }, 3353, "tcp" },
+ { "fatpipe", { NULL }, 3353, "udp" },
+ { "suitjd", { NULL }, 3354, "tcp" },
+ { "suitjd", { NULL }, 3354, "udp" },
+ { "ordinox-dbase", { NULL }, 3355, "tcp" },
+ { "ordinox-dbase", { NULL }, 3355, "udp" },
+ { "upnotifyps", { NULL }, 3356, "tcp" },
+ { "upnotifyps", { NULL }, 3356, "udp" },
+ { "adtech-test", { NULL }, 3357, "tcp" },
+ { "adtech-test", { NULL }, 3357, "udp" },
+ { "mpsysrmsvr", { NULL }, 3358, "tcp" },
+ { "mpsysrmsvr", { NULL }, 3358, "udp" },
+ { "wg-netforce", { NULL }, 3359, "tcp" },
+ { "wg-netforce", { NULL }, 3359, "udp" },
+ { "kv-server", { NULL }, 3360, "tcp" },
+ { "kv-server", { NULL }, 3360, "udp" },
+ { "kv-agent", { NULL }, 3361, "tcp" },
+ { "kv-agent", { NULL }, 3361, "udp" },
+ { "dj-ilm", { NULL }, 3362, "tcp" },
+ { "dj-ilm", { NULL }, 3362, "udp" },
+ { "nati-vi-server", { NULL }, 3363, "tcp" },
+ { "nati-vi-server", { NULL }, 3363, "udp" },
+ { "creativeserver", { NULL }, 3364, "tcp" },
+ { "creativeserver", { NULL }, 3364, "udp" },
+ { "contentserver", { NULL }, 3365, "tcp" },
+ { "contentserver", { NULL }, 3365, "udp" },
+ { "creativepartnr", { NULL }, 3366, "tcp" },
+ { "creativepartnr", { NULL }, 3366, "udp" },
+ { "tip2", { NULL }, 3372, "tcp" },
+ { "tip2", { NULL }, 3372, "udp" },
+ { "lavenir-lm", { NULL }, 3373, "tcp" },
+ { "lavenir-lm", { NULL }, 3373, "udp" },
+ { "cluster-disc", { NULL }, 3374, "tcp" },
+ { "cluster-disc", { NULL }, 3374, "udp" },
+ { "vsnm-agent", { NULL }, 3375, "tcp" },
+ { "vsnm-agent", { NULL }, 3375, "udp" },
+ { "cdbroker", { NULL }, 3376, "tcp" },
+ { "cdbroker", { NULL }, 3376, "udp" },
+ { "cogsys-lm", { NULL }, 3377, "tcp" },
+ { "cogsys-lm", { NULL }, 3377, "udp" },
+ { "wsicopy", { NULL }, 3378, "tcp" },
+ { "wsicopy", { NULL }, 3378, "udp" },
+ { "socorfs", { NULL }, 3379, "tcp" },
+ { "socorfs", { NULL }, 3379, "udp" },
+ { "sns-channels", { NULL }, 3380, "tcp" },
+ { "sns-channels", { NULL }, 3380, "udp" },
+ { "geneous", { NULL }, 3381, "tcp" },
+ { "geneous", { NULL }, 3381, "udp" },
+ { "fujitsu-neat", { NULL }, 3382, "tcp" },
+ { "fujitsu-neat", { NULL }, 3382, "udp" },
+ { "esp-lm", { NULL }, 3383, "tcp" },
+ { "esp-lm", { NULL }, 3383, "udp" },
+ { "hp-clic", { NULL }, 3384, "tcp" },
+ { "hp-clic", { NULL }, 3384, "udp" },
+ { "qnxnetman", { NULL }, 3385, "tcp" },
+ { "qnxnetman", { NULL }, 3385, "udp" },
+ { "gprs-data", { NULL }, 3386, "tcp" },
+ { "gprs-sig", { NULL }, 3386, "udp" },
+ { "backroomnet", { NULL }, 3387, "tcp" },
+ { "backroomnet", { NULL }, 3387, "udp" },
+ { "cbserver", { NULL }, 3388, "tcp" },
+ { "cbserver", { NULL }, 3388, "udp" },
+ { "ms-wbt-server", { NULL }, 3389, "tcp" },
+ { "ms-wbt-server", { NULL }, 3389, "udp" },
+ { "dsc", { NULL }, 3390, "tcp" },
+ { "dsc", { NULL }, 3390, "udp" },
+ { "savant", { NULL }, 3391, "tcp" },
+ { "savant", { NULL }, 3391, "udp" },
+ { "efi-lm", { NULL }, 3392, "tcp" },
+ { "efi-lm", { NULL }, 3392, "udp" },
+ { "d2k-tapestry1", { NULL }, 3393, "tcp" },
+ { "d2k-tapestry1", { NULL }, 3393, "udp" },
+ { "d2k-tapestry2", { NULL }, 3394, "tcp" },
+ { "d2k-tapestry2", { NULL }, 3394, "udp" },
+ { "dyna-lm", { NULL }, 3395, "tcp" },
+ { "dyna-lm", { NULL }, 3395, "udp" },
+ { "printer_agent", { NULL }, 3396, "tcp" },
+ { "printer_agent", { NULL }, 3396, "udp" },
+ { "cloanto-lm", { NULL }, 3397, "tcp" },
+ { "cloanto-lm", { NULL }, 3397, "udp" },
+ { "mercantile", { NULL }, 3398, "tcp" },
+ { "mercantile", { NULL }, 3398, "udp" },
+ { "csms", { NULL }, 3399, "tcp" },
+ { "csms", { NULL }, 3399, "udp" },
+ { "csms2", { NULL }, 3400, "tcp" },
+ { "csms2", { NULL }, 3400, "udp" },
+ { "filecast", { NULL }, 3401, "tcp" },
+ { "filecast", { NULL }, 3401, "udp" },
+ { "fxaengine-net", { NULL }, 3402, "tcp" },
+ { "fxaengine-net", { NULL }, 3402, "udp" },
+ { "nokia-ann-ch1", { NULL }, 3405, "tcp" },
+ { "nokia-ann-ch1", { NULL }, 3405, "udp" },
+ { "nokia-ann-ch2", { NULL }, 3406, "tcp" },
+ { "nokia-ann-ch2", { NULL }, 3406, "udp" },
+ { "ldap-admin", { NULL }, 3407, "tcp" },
+ { "ldap-admin", { NULL }, 3407, "udp" },
+ { "BESApi", { NULL }, 3408, "tcp" },
+ { "BESApi", { NULL }, 3408, "udp" },
+ { "networklens", { NULL }, 3409, "tcp" },
+ { "networklens", { NULL }, 3409, "udp" },
+ { "networklenss", { NULL }, 3410, "tcp" },
+ { "networklenss", { NULL }, 3410, "udp" },
+ { "biolink-auth", { NULL }, 3411, "tcp" },
+ { "biolink-auth", { NULL }, 3411, "udp" },
+ { "xmlblaster", { NULL }, 3412, "tcp" },
+ { "xmlblaster", { NULL }, 3412, "udp" },
+ { "svnet", { NULL }, 3413, "tcp" },
+ { "svnet", { NULL }, 3413, "udp" },
+ { "wip-port", { NULL }, 3414, "tcp" },
+ { "wip-port", { NULL }, 3414, "udp" },
+ { "bcinameservice", { NULL }, 3415, "tcp" },
+ { "bcinameservice", { NULL }, 3415, "udp" },
+ { "commandport", { NULL }, 3416, "tcp" },
+ { "commandport", { NULL }, 3416, "udp" },
+ { "csvr", { NULL }, 3417, "tcp" },
+ { "csvr", { NULL }, 3417, "udp" },
+ { "rnmap", { NULL }, 3418, "tcp" },
+ { "rnmap", { NULL }, 3418, "udp" },
+ { "softaudit", { NULL }, 3419, "tcp" },
+ { "softaudit", { NULL }, 3419, "udp" },
+ { "ifcp-port", { NULL }, 3420, "tcp" },
+ { "ifcp-port", { NULL }, 3420, "udp" },
+ { "bmap", { NULL }, 3421, "tcp" },
+ { "bmap", { NULL }, 3421, "udp" },
+ { "rusb-sys-port", { NULL }, 3422, "tcp" },
+ { "rusb-sys-port", { NULL }, 3422, "udp" },
+ { "xtrm", { NULL }, 3423, "tcp" },
+ { "xtrm", { NULL }, 3423, "udp" },
+ { "xtrms", { NULL }, 3424, "tcp" },
+ { "xtrms", { NULL }, 3424, "udp" },
+ { "agps-port", { NULL }, 3425, "tcp" },
+ { "agps-port", { NULL }, 3425, "udp" },
+ { "arkivio", { NULL }, 3426, "tcp" },
+ { "arkivio", { NULL }, 3426, "udp" },
+ { "websphere-snmp", { NULL }, 3427, "tcp" },
+ { "websphere-snmp", { NULL }, 3427, "udp" },
+ { "twcss", { NULL }, 3428, "tcp" },
+ { "twcss", { NULL }, 3428, "udp" },
+ { "gcsp", { NULL }, 3429, "tcp" },
+ { "gcsp", { NULL }, 3429, "udp" },
+ { "ssdispatch", { NULL }, 3430, "tcp" },
+ { "ssdispatch", { NULL }, 3430, "udp" },
+ { "ndl-als", { NULL }, 3431, "tcp" },
+ { "ndl-als", { NULL }, 3431, "udp" },
+ { "osdcp", { NULL }, 3432, "tcp" },
+ { "osdcp", { NULL }, 3432, "udp" },
+ { "alta-smp", { NULL }, 3433, "tcp" },
+ { "alta-smp", { NULL }, 3433, "udp" },
+ { "opencm", { NULL }, 3434, "tcp" },
+ { "opencm", { NULL }, 3434, "udp" },
+ { "pacom", { NULL }, 3435, "tcp" },
+ { "pacom", { NULL }, 3435, "udp" },
+ { "gc-config", { NULL }, 3436, "tcp" },
+ { "gc-config", { NULL }, 3436, "udp" },
+ { "autocueds", { NULL }, 3437, "tcp" },
+ { "autocueds", { NULL }, 3437, "udp" },
+ { "spiral-admin", { NULL }, 3438, "tcp" },
+ { "spiral-admin", { NULL }, 3438, "udp" },
+ { "hri-port", { NULL }, 3439, "tcp" },
+ { "hri-port", { NULL }, 3439, "udp" },
+ { "ans-console", { NULL }, 3440, "tcp" },
+ { "ans-console", { NULL }, 3440, "udp" },
+ { "connect-client", { NULL }, 3441, "tcp" },
+ { "connect-client", { NULL }, 3441, "udp" },
+ { "connect-server", { NULL }, 3442, "tcp" },
+ { "connect-server", { NULL }, 3442, "udp" },
+ { "ov-nnm-websrv", { NULL }, 3443, "tcp" },
+ { "ov-nnm-websrv", { NULL }, 3443, "udp" },
+ { "denali-server", { NULL }, 3444, "tcp" },
+ { "denali-server", { NULL }, 3444, "udp" },
+ { "monp", { NULL }, 3445, "tcp" },
+ { "monp", { NULL }, 3445, "udp" },
+ { "3comfaxrpc", { NULL }, 3446, "tcp" },
+ { "3comfaxrpc", { NULL }, 3446, "udp" },
+ { "directnet", { NULL }, 3447, "tcp" },
+ { "directnet", { NULL }, 3447, "udp" },
+ { "dnc-port", { NULL }, 3448, "tcp" },
+ { "dnc-port", { NULL }, 3448, "udp" },
+ { "hotu-chat", { NULL }, 3449, "tcp" },
+ { "hotu-chat", { NULL }, 3449, "udp" },
+ { "castorproxy", { NULL }, 3450, "tcp" },
+ { "castorproxy", { NULL }, 3450, "udp" },
+ { "asam", { NULL }, 3451, "tcp" },
+ { "asam", { NULL }, 3451, "udp" },
+ { "sabp-signal", { NULL }, 3452, "tcp" },
+ { "sabp-signal", { NULL }, 3452, "udp" },
+ { "pscupd", { NULL }, 3453, "tcp" },
+ { "pscupd", { NULL }, 3453, "udp" },
+ { "mira", { NULL }, 3454, "tcp" },
+ { "prsvp", { NULL }, 3455, "tcp" },
+ { "prsvp", { NULL }, 3455, "udp" },
+ { "vat", { NULL }, 3456, "tcp" },
+ { "vat", { NULL }, 3456, "udp" },
+ { "vat-control", { NULL }, 3457, "tcp" },
+ { "vat-control", { NULL }, 3457, "udp" },
+ { "d3winosfi", { NULL }, 3458, "tcp" },
+ { "d3winosfi", { NULL }, 3458, "udp" },
+ { "integral", { NULL }, 3459, "tcp" },
+ { "integral", { NULL }, 3459, "udp" },
+ { "edm-manager", { NULL }, 3460, "tcp" },
+ { "edm-manager", { NULL }, 3460, "udp" },
+ { "edm-stager", { NULL }, 3461, "tcp" },
+ { "edm-stager", { NULL }, 3461, "udp" },
+ { "edm-std-notify", { NULL }, 3462, "tcp" },
+ { "edm-std-notify", { NULL }, 3462, "udp" },
+ { "edm-adm-notify", { NULL }, 3463, "tcp" },
+ { "edm-adm-notify", { NULL }, 3463, "udp" },
+ { "edm-mgr-sync", { NULL }, 3464, "tcp" },
+ { "edm-mgr-sync", { NULL }, 3464, "udp" },
+ { "edm-mgr-cntrl", { NULL }, 3465, "tcp" },
+ { "edm-mgr-cntrl", { NULL }, 3465, "udp" },
+ { "workflow", { NULL }, 3466, "tcp" },
+ { "workflow", { NULL }, 3466, "udp" },
+ { "rcst", { NULL }, 3467, "tcp" },
+ { "rcst", { NULL }, 3467, "udp" },
+ { "ttcmremotectrl", { NULL }, 3468, "tcp" },
+ { "ttcmremotectrl", { NULL }, 3468, "udp" },
+ { "pluribus", { NULL }, 3469, "tcp" },
+ { "pluribus", { NULL }, 3469, "udp" },
+ { "jt400", { NULL }, 3470, "tcp" },
+ { "jt400", { NULL }, 3470, "udp" },
+ { "jt400-ssl", { NULL }, 3471, "tcp" },
+ { "jt400-ssl", { NULL }, 3471, "udp" },
+ { "jaugsremotec-1", { NULL }, 3472, "tcp" },
+ { "jaugsremotec-1", { NULL }, 3472, "udp" },
+ { "jaugsremotec-2", { NULL }, 3473, "tcp" },
+ { "jaugsremotec-2", { NULL }, 3473, "udp" },
+ { "ttntspauto", { NULL }, 3474, "tcp" },
+ { "ttntspauto", { NULL }, 3474, "udp" },
+ { "genisar-port", { NULL }, 3475, "tcp" },
+ { "genisar-port", { NULL }, 3475, "udp" },
+ { "nppmp", { NULL }, 3476, "tcp" },
+ { "nppmp", { NULL }, 3476, "udp" },
+ { "ecomm", { NULL }, 3477, "tcp" },
+ { "ecomm", { NULL }, 3477, "udp" },
+ { "stun", { NULL }, 3478, "tcp" },
+ { "stun", { NULL }, 3478, "udp" },
+ { "turn", { NULL }, 3478, "tcp" },
+ { "turn", { NULL }, 3478, "udp" },
+ { "stun-behavior", { NULL }, 3478, "tcp" },
+ { "stun-behavior", { NULL }, 3478, "udp" },
+ { "twrpc", { NULL }, 3479, "tcp" },
+ { "twrpc", { NULL }, 3479, "udp" },
+ { "plethora", { NULL }, 3480, "tcp" },
+ { "plethora", { NULL }, 3480, "udp" },
+ { "cleanerliverc", { NULL }, 3481, "tcp" },
+ { "cleanerliverc", { NULL }, 3481, "udp" },
+ { "vulture", { NULL }, 3482, "tcp" },
+ { "vulture", { NULL }, 3482, "udp" },
+ { "slim-devices", { NULL }, 3483, "tcp" },
+ { "slim-devices", { NULL }, 3483, "udp" },
+ { "gbs-stp", { NULL }, 3484, "tcp" },
+ { "gbs-stp", { NULL }, 3484, "udp" },
+ { "celatalk", { NULL }, 3485, "tcp" },
+ { "celatalk", { NULL }, 3485, "udp" },
+ { "ifsf-hb-port", { NULL }, 3486, "tcp" },
+ { "ifsf-hb-port", { NULL }, 3486, "udp" },
+ { "ltctcp", { NULL }, 3487, "tcp" },
+ { "ltcudp", { NULL }, 3487, "udp" },
+ { "fs-rh-srv", { NULL }, 3488, "tcp" },
+ { "fs-rh-srv", { NULL }, 3488, "udp" },
+ { "dtp-dia", { NULL }, 3489, "tcp" },
+ { "dtp-dia", { NULL }, 3489, "udp" },
+ { "colubris", { NULL }, 3490, "tcp" },
+ { "colubris", { NULL }, 3490, "udp" },
+ { "swr-port", { NULL }, 3491, "tcp" },
+ { "swr-port", { NULL }, 3491, "udp" },
+ { "tvdumtray-port", { NULL }, 3492, "tcp" },
+ { "tvdumtray-port", { NULL }, 3492, "udp" },
+ { "nut", { NULL }, 3493, "tcp" },
+ { "nut", { NULL }, 3493, "udp" },
+ { "ibm3494", { NULL }, 3494, "tcp" },
+ { "ibm3494", { NULL }, 3494, "udp" },
+ { "seclayer-tcp", { NULL }, 3495, "tcp" },
+ { "seclayer-tcp", { NULL }, 3495, "udp" },
+ { "seclayer-tls", { NULL }, 3496, "tcp" },
+ { "seclayer-tls", { NULL }, 3496, "udp" },
+ { "ipether232port", { NULL }, 3497, "tcp" },
+ { "ipether232port", { NULL }, 3497, "udp" },
+ { "dashpas-port", { NULL }, 3498, "tcp" },
+ { "dashpas-port", { NULL }, 3498, "udp" },
+ { "sccip-media", { NULL }, 3499, "tcp" },
+ { "sccip-media", { NULL }, 3499, "udp" },
+ { "rtmp-port", { NULL }, 3500, "tcp" },
+ { "rtmp-port", { NULL }, 3500, "udp" },
+ { "isoft-p2p", { NULL }, 3501, "tcp" },
+ { "isoft-p2p", { NULL }, 3501, "udp" },
+ { "avinstalldisc", { NULL }, 3502, "tcp" },
+ { "avinstalldisc", { NULL }, 3502, "udp" },
+ { "lsp-ping", { NULL }, 3503, "tcp" },
+ { "lsp-ping", { NULL }, 3503, "udp" },
+ { "ironstorm", { NULL }, 3504, "tcp" },
+ { "ironstorm", { NULL }, 3504, "udp" },
+ { "ccmcomm", { NULL }, 3505, "tcp" },
+ { "ccmcomm", { NULL }, 3505, "udp" },
+ { "apc-3506", { NULL }, 3506, "tcp" },
+ { "apc-3506", { NULL }, 3506, "udp" },
+ { "nesh-broker", { NULL }, 3507, "tcp" },
+ { "nesh-broker", { NULL }, 3507, "udp" },
+ { "interactionweb", { NULL }, 3508, "tcp" },
+ { "interactionweb", { NULL }, 3508, "udp" },
+ { "vt-ssl", { NULL }, 3509, "tcp" },
+ { "vt-ssl", { NULL }, 3509, "udp" },
+ { "xss-port", { NULL }, 3510, "tcp" },
+ { "xss-port", { NULL }, 3510, "udp" },
+ { "webmail-2", { NULL }, 3511, "tcp" },
+ { "webmail-2", { NULL }, 3511, "udp" },
+ { "aztec", { NULL }, 3512, "tcp" },
+ { "aztec", { NULL }, 3512, "udp" },
+ { "arcpd", { NULL }, 3513, "tcp" },
+ { "arcpd", { NULL }, 3513, "udp" },
+ { "must-p2p", { NULL }, 3514, "tcp" },
+ { "must-p2p", { NULL }, 3514, "udp" },
+ { "must-backplane", { NULL }, 3515, "tcp" },
+ { "must-backplane", { NULL }, 3515, "udp" },
+ { "smartcard-port", { NULL }, 3516, "tcp" },
+ { "smartcard-port", { NULL }, 3516, "udp" },
+ { "802-11-iapp", { NULL }, 3517, "tcp" },
+ { "802-11-iapp", { NULL }, 3517, "udp" },
+ { "artifact-msg", { NULL }, 3518, "tcp" },
+ { "artifact-msg", { NULL }, 3518, "udp" },
+ { "nvmsgd", { NULL }, 3519, "tcp" },
+ { "galileo", { NULL }, 3519, "udp" },
+ { "galileolog", { NULL }, 3520, "tcp" },
+ { "galileolog", { NULL }, 3520, "udp" },
+ { "mc3ss", { NULL }, 3521, "tcp" },
+ { "mc3ss", { NULL }, 3521, "udp" },
+ { "nssocketport", { NULL }, 3522, "tcp" },
+ { "nssocketport", { NULL }, 3522, "udp" },
+ { "odeumservlink", { NULL }, 3523, "tcp" },
+ { "odeumservlink", { NULL }, 3523, "udp" },
+ { "ecmport", { NULL }, 3524, "tcp" },
+ { "ecmport", { NULL }, 3524, "udp" },
+ { "eisport", { NULL }, 3525, "tcp" },
+ { "eisport", { NULL }, 3525, "udp" },
+ { "starquiz-port", { NULL }, 3526, "tcp" },
+ { "starquiz-port", { NULL }, 3526, "udp" },
+ { "beserver-msg-q", { NULL }, 3527, "tcp" },
+ { "beserver-msg-q", { NULL }, 3527, "udp" },
+ { "jboss-iiop", { NULL }, 3528, "tcp" },
+ { "jboss-iiop", { NULL }, 3528, "udp" },
+ { "jboss-iiop-ssl", { NULL }, 3529, "tcp" },
+ { "jboss-iiop-ssl", { NULL }, 3529, "udp" },
+ { "gf", { NULL }, 3530, "tcp" },
+ { "gf", { NULL }, 3530, "udp" },
+ { "joltid", { NULL }, 3531, "tcp" },
+ { "joltid", { NULL }, 3531, "udp" },
+ { "raven-rmp", { NULL }, 3532, "tcp" },
+ { "raven-rmp", { NULL }, 3532, "udp" },
+ { "raven-rdp", { NULL }, 3533, "tcp" },
+ { "raven-rdp", { NULL }, 3533, "udp" },
+ { "urld-port", { NULL }, 3534, "tcp" },
+ { "urld-port", { NULL }, 3534, "udp" },
+ { "ms-la", { NULL }, 3535, "tcp" },
+ { "ms-la", { NULL }, 3535, "udp" },
+ { "snac", { NULL }, 3536, "tcp" },
+ { "snac", { NULL }, 3536, "udp" },
+ { "ni-visa-remote", { NULL }, 3537, "tcp" },
+ { "ni-visa-remote", { NULL }, 3537, "udp" },
+ { "ibm-diradm", { NULL }, 3538, "tcp" },
+ { "ibm-diradm", { NULL }, 3538, "udp" },
+ { "ibm-diradm-ssl", { NULL }, 3539, "tcp" },
+ { "ibm-diradm-ssl", { NULL }, 3539, "udp" },
+ { "pnrp-port", { NULL }, 3540, "tcp" },
+ { "pnrp-port", { NULL }, 3540, "udp" },
+ { "voispeed-port", { NULL }, 3541, "tcp" },
+ { "voispeed-port", { NULL }, 3541, "udp" },
+ { "hacl-monitor", { NULL }, 3542, "tcp" },
+ { "hacl-monitor", { NULL }, 3542, "udp" },
+ { "qftest-lookup", { NULL }, 3543, "tcp" },
+ { "qftest-lookup", { NULL }, 3543, "udp" },
+ { "teredo", { NULL }, 3544, "tcp" },
+ { "teredo", { NULL }, 3544, "udp" },
+ { "camac", { NULL }, 3545, "tcp" },
+ { "camac", { NULL }, 3545, "udp" },
+ { "symantec-sim", { NULL }, 3547, "tcp" },
+ { "symantec-sim", { NULL }, 3547, "udp" },
+ { "interworld", { NULL }, 3548, "tcp" },
+ { "interworld", { NULL }, 3548, "udp" },
+ { "tellumat-nms", { NULL }, 3549, "tcp" },
+ { "tellumat-nms", { NULL }, 3549, "udp" },
+ { "ssmpp", { NULL }, 3550, "tcp" },
+ { "ssmpp", { NULL }, 3550, "udp" },
+ { "apcupsd", { NULL }, 3551, "tcp" },
+ { "apcupsd", { NULL }, 3551, "udp" },
+ { "taserver", { NULL }, 3552, "tcp" },
+ { "taserver", { NULL }, 3552, "udp" },
+ { "rbr-discovery", { NULL }, 3553, "tcp" },
+ { "rbr-discovery", { NULL }, 3553, "udp" },
+ { "questnotify", { NULL }, 3554, "tcp" },
+ { "questnotify", { NULL }, 3554, "udp" },
+ { "razor", { NULL }, 3555, "tcp" },
+ { "razor", { NULL }, 3555, "udp" },
+ { "sky-transport", { NULL }, 3556, "tcp" },
+ { "sky-transport", { NULL }, 3556, "udp" },
+ { "personalos-001", { NULL }, 3557, "tcp" },
+ { "personalos-001", { NULL }, 3557, "udp" },
+ { "mcp-port", { NULL }, 3558, "tcp" },
+ { "mcp-port", { NULL }, 3558, "udp" },
+ { "cctv-port", { NULL }, 3559, "tcp" },
+ { "cctv-port", { NULL }, 3559, "udp" },
+ { "iniserve-port", { NULL }, 3560, "tcp" },
+ { "iniserve-port", { NULL }, 3560, "udp" },
+ { "bmc-onekey", { NULL }, 3561, "tcp" },
+ { "bmc-onekey", { NULL }, 3561, "udp" },
+ { "sdbproxy", { NULL }, 3562, "tcp" },
+ { "sdbproxy", { NULL }, 3562, "udp" },
+ { "watcomdebug", { NULL }, 3563, "tcp" },
+ { "watcomdebug", { NULL }, 3563, "udp" },
+ { "esimport", { NULL }, 3564, "tcp" },
+ { "esimport", { NULL }, 3564, "udp" },
+ { "m2pa", { NULL }, 3565, "tcp" },
+ { "m2pa", { NULL }, 3565, "sctp"},
+ { "quest-data-hub", { NULL }, 3566, "tcp" },
+ { "oap", { NULL }, 3567, "tcp" },
+ { "oap", { NULL }, 3567, "udp" },
+ { "oap-s", { NULL }, 3568, "tcp" },
+ { "oap-s", { NULL }, 3568, "udp" },
+ { "mbg-ctrl", { NULL }, 3569, "tcp" },
+ { "mbg-ctrl", { NULL }, 3569, "udp" },
+ { "mccwebsvr-port", { NULL }, 3570, "tcp" },
+ { "mccwebsvr-port", { NULL }, 3570, "udp" },
+ { "megardsvr-port", { NULL }, 3571, "tcp" },
+ { "megardsvr-port", { NULL }, 3571, "udp" },
+ { "megaregsvrport", { NULL }, 3572, "tcp" },
+ { "megaregsvrport", { NULL }, 3572, "udp" },
+ { "tag-ups-1", { NULL }, 3573, "tcp" },
+ { "tag-ups-1", { NULL }, 3573, "udp" },
+ { "dmaf-server", { NULL }, 3574, "tcp" },
+ { "dmaf-caster", { NULL }, 3574, "udp" },
+ { "ccm-port", { NULL }, 3575, "tcp" },
+ { "ccm-port", { NULL }, 3575, "udp" },
+ { "cmc-port", { NULL }, 3576, "tcp" },
+ { "cmc-port", { NULL }, 3576, "udp" },
+ { "config-port", { NULL }, 3577, "tcp" },
+ { "config-port", { NULL }, 3577, "udp" },
+ { "data-port", { NULL }, 3578, "tcp" },
+ { "data-port", { NULL }, 3578, "udp" },
+ { "ttat3lb", { NULL }, 3579, "tcp" },
+ { "ttat3lb", { NULL }, 3579, "udp" },
+ { "nati-svrloc", { NULL }, 3580, "tcp" },
+ { "nati-svrloc", { NULL }, 3580, "udp" },
+ { "kfxaclicensing", { NULL }, 3581, "tcp" },
+ { "kfxaclicensing", { NULL }, 3581, "udp" },
+ { "press", { NULL }, 3582, "tcp" },
+ { "press", { NULL }, 3582, "udp" },
+ { "canex-watch", { NULL }, 3583, "tcp" },
+ { "canex-watch", { NULL }, 3583, "udp" },
+ { "u-dbap", { NULL }, 3584, "tcp" },
+ { "u-dbap", { NULL }, 3584, "udp" },
+ { "emprise-lls", { NULL }, 3585, "tcp" },
+ { "emprise-lls", { NULL }, 3585, "udp" },
+ { "emprise-lsc", { NULL }, 3586, "tcp" },
+ { "emprise-lsc", { NULL }, 3586, "udp" },
+ { "p2pgroup", { NULL }, 3587, "tcp" },
+ { "p2pgroup", { NULL }, 3587, "udp" },
+ { "sentinel", { NULL }, 3588, "tcp" },
+ { "sentinel", { NULL }, 3588, "udp" },
+ { "isomair", { NULL }, 3589, "tcp" },
+ { "isomair", { NULL }, 3589, "udp" },
+ { "wv-csp-sms", { NULL }, 3590, "tcp" },
+ { "wv-csp-sms", { NULL }, 3590, "udp" },
+ { "gtrack-server", { NULL }, 3591, "tcp" },
+ { "gtrack-server", { NULL }, 3591, "udp" },
+ { "gtrack-ne", { NULL }, 3592, "tcp" },
+ { "gtrack-ne", { NULL }, 3592, "udp" },
+ { "bpmd", { NULL }, 3593, "tcp" },
+ { "bpmd", { NULL }, 3593, "udp" },
+ { "mediaspace", { NULL }, 3594, "tcp" },
+ { "mediaspace", { NULL }, 3594, "udp" },
+ { "shareapp", { NULL }, 3595, "tcp" },
+ { "shareapp", { NULL }, 3595, "udp" },
+ { "iw-mmogame", { NULL }, 3596, "tcp" },
+ { "iw-mmogame", { NULL }, 3596, "udp" },
+ { "a14", { NULL }, 3597, "tcp" },
+ { "a14", { NULL }, 3597, "udp" },
+ { "a15", { NULL }, 3598, "tcp" },
+ { "a15", { NULL }, 3598, "udp" },
+ { "quasar-server", { NULL }, 3599, "tcp" },
+ { "quasar-server", { NULL }, 3599, "udp" },
+ { "trap-daemon", { NULL }, 3600, "tcp" },
+ { "trap-daemon", { NULL }, 3600, "udp" },
+ { "visinet-gui", { NULL }, 3601, "tcp" },
+ { "visinet-gui", { NULL }, 3601, "udp" },
+ { "infiniswitchcl", { NULL }, 3602, "tcp" },
+ { "infiniswitchcl", { NULL }, 3602, "udp" },
+ { "int-rcv-cntrl", { NULL }, 3603, "tcp" },
+ { "int-rcv-cntrl", { NULL }, 3603, "udp" },
+ { "bmc-jmx-port", { NULL }, 3604, "tcp" },
+ { "bmc-jmx-port", { NULL }, 3604, "udp" },
+ { "comcam-io", { NULL }, 3605, "tcp" },
+ { "comcam-io", { NULL }, 3605, "udp" },
+ { "splitlock", { NULL }, 3606, "tcp" },
+ { "splitlock", { NULL }, 3606, "udp" },
+ { "precise-i3", { NULL }, 3607, "tcp" },
+ { "precise-i3", { NULL }, 3607, "udp" },
+ { "trendchip-dcp", { NULL }, 3608, "tcp" },
+ { "trendchip-dcp", { NULL }, 3608, "udp" },
+ { "cpdi-pidas-cm", { NULL }, 3609, "tcp" },
+ { "cpdi-pidas-cm", { NULL }, 3609, "udp" },
+ { "echonet", { NULL }, 3610, "tcp" },
+ { "echonet", { NULL }, 3610, "udp" },
+ { "six-degrees", { NULL }, 3611, "tcp" },
+ { "six-degrees", { NULL }, 3611, "udp" },
+ { "hp-dataprotect", { NULL }, 3612, "tcp" },
+ { "hp-dataprotect", { NULL }, 3612, "udp" },
+ { "alaris-disc", { NULL }, 3613, "tcp" },
+ { "alaris-disc", { NULL }, 3613, "udp" },
+ { "sigma-port", { NULL }, 3614, "tcp" },
+ { "sigma-port", { NULL }, 3614, "udp" },
+ { "start-network", { NULL }, 3615, "tcp" },
+ { "start-network", { NULL }, 3615, "udp" },
+ { "cd3o-protocol", { NULL }, 3616, "tcp" },
+ { "cd3o-protocol", { NULL }, 3616, "udp" },
+ { "sharp-server", { NULL }, 3617, "tcp" },
+ { "sharp-server", { NULL }, 3617, "udp" },
+ { "aairnet-1", { NULL }, 3618, "tcp" },
+ { "aairnet-1", { NULL }, 3618, "udp" },
+ { "aairnet-2", { NULL }, 3619, "tcp" },
+ { "aairnet-2", { NULL }, 3619, "udp" },
+ { "ep-pcp", { NULL }, 3620, "tcp" },
+ { "ep-pcp", { NULL }, 3620, "udp" },
+ { "ep-nsp", { NULL }, 3621, "tcp" },
+ { "ep-nsp", { NULL }, 3621, "udp" },
+ { "ff-lr-port", { NULL }, 3622, "tcp" },
+ { "ff-lr-port", { NULL }, 3622, "udp" },
+ { "haipe-discover", { NULL }, 3623, "tcp" },
+ { "haipe-discover", { NULL }, 3623, "udp" },
+ { "dist-upgrade", { NULL }, 3624, "tcp" },
+ { "dist-upgrade", { NULL }, 3624, "udp" },
+ { "volley", { NULL }, 3625, "tcp" },
+ { "volley", { NULL }, 3625, "udp" },
+ { "bvcdaemon-port", { NULL }, 3626, "tcp" },
+ { "bvcdaemon-port", { NULL }, 3626, "udp" },
+ { "jamserverport", { NULL }, 3627, "tcp" },
+ { "jamserverport", { NULL }, 3627, "udp" },
+ { "ept-machine", { NULL }, 3628, "tcp" },
+ { "ept-machine", { NULL }, 3628, "udp" },
+ { "escvpnet", { NULL }, 3629, "tcp" },
+ { "escvpnet", { NULL }, 3629, "udp" },
+ { "cs-remote-db", { NULL }, 3630, "tcp" },
+ { "cs-remote-db", { NULL }, 3630, "udp" },
+ { "cs-services", { NULL }, 3631, "tcp" },
+ { "cs-services", { NULL }, 3631, "udp" },
+ { "distcc", { NULL }, 3632, "tcp" },
+ { "distcc", { NULL }, 3632, "udp" },
+ { "wacp", { NULL }, 3633, "tcp" },
+ { "wacp", { NULL }, 3633, "udp" },
+ { "hlibmgr", { NULL }, 3634, "tcp" },
+ { "hlibmgr", { NULL }, 3634, "udp" },
+ { "sdo", { NULL }, 3635, "tcp" },
+ { "sdo", { NULL }, 3635, "udp" },
+ { "servistaitsm", { NULL }, 3636, "tcp" },
+ { "servistaitsm", { NULL }, 3636, "udp" },
+ { "scservp", { NULL }, 3637, "tcp" },
+ { "scservp", { NULL }, 3637, "udp" },
+ { "ehp-backup", { NULL }, 3638, "tcp" },
+ { "ehp-backup", { NULL }, 3638, "udp" },
+ { "xap-ha", { NULL }, 3639, "tcp" },
+ { "xap-ha", { NULL }, 3639, "udp" },
+ { "netplay-port1", { NULL }, 3640, "tcp" },
+ { "netplay-port1", { NULL }, 3640, "udp" },
+ { "netplay-port2", { NULL }, 3641, "tcp" },
+ { "netplay-port2", { NULL }, 3641, "udp" },
+ { "juxml-port", { NULL }, 3642, "tcp" },
+ { "juxml-port", { NULL }, 3642, "udp" },
+ { "audiojuggler", { NULL }, 3643, "tcp" },
+ { "audiojuggler", { NULL }, 3643, "udp" },
+ { "ssowatch", { NULL }, 3644, "tcp" },
+ { "ssowatch", { NULL }, 3644, "udp" },
+ { "cyc", { NULL }, 3645, "tcp" },
+ { "cyc", { NULL }, 3645, "udp" },
+ { "xss-srv-port", { NULL }, 3646, "tcp" },
+ { "xss-srv-port", { NULL }, 3646, "udp" },
+ { "splitlock-gw", { NULL }, 3647, "tcp" },
+ { "splitlock-gw", { NULL }, 3647, "udp" },
+ { "fjcp", { NULL }, 3648, "tcp" },
+ { "fjcp", { NULL }, 3648, "udp" },
+ { "nmmp", { NULL }, 3649, "tcp" },
+ { "nmmp", { NULL }, 3649, "udp" },
+ { "prismiq-plugin", { NULL }, 3650, "tcp" },
+ { "prismiq-plugin", { NULL }, 3650, "udp" },
+ { "xrpc-registry", { NULL }, 3651, "tcp" },
+ { "xrpc-registry", { NULL }, 3651, "udp" },
+ { "vxcrnbuport", { NULL }, 3652, "tcp" },
+ { "vxcrnbuport", { NULL }, 3652, "udp" },
+ { "tsp", { NULL }, 3653, "tcp" },
+ { "tsp", { NULL }, 3653, "udp" },
+ { "vaprtm", { NULL }, 3654, "tcp" },
+ { "vaprtm", { NULL }, 3654, "udp" },
+ { "abatemgr", { NULL }, 3655, "tcp" },
+ { "abatemgr", { NULL }, 3655, "udp" },
+ { "abatjss", { NULL }, 3656, "tcp" },
+ { "abatjss", { NULL }, 3656, "udp" },
+ { "immedianet-bcn", { NULL }, 3657, "tcp" },
+ { "immedianet-bcn", { NULL }, 3657, "udp" },
+ { "ps-ams", { NULL }, 3658, "tcp" },
+ { "ps-ams", { NULL }, 3658, "udp" },
+ { "apple-sasl", { NULL }, 3659, "tcp" },
+ { "apple-sasl", { NULL }, 3659, "udp" },
+ { "can-nds-ssl", { NULL }, 3660, "tcp" },
+ { "can-nds-ssl", { NULL }, 3660, "udp" },
+ { "can-ferret-ssl", { NULL }, 3661, "tcp" },
+ { "can-ferret-ssl", { NULL }, 3661, "udp" },
+ { "pserver", { NULL }, 3662, "tcp" },
+ { "pserver", { NULL }, 3662, "udp" },
+ { "dtp", { NULL }, 3663, "tcp" },
+ { "dtp", { NULL }, 3663, "udp" },
+ { "ups-engine", { NULL }, 3664, "tcp" },
+ { "ups-engine", { NULL }, 3664, "udp" },
+ { "ent-engine", { NULL }, 3665, "tcp" },
+ { "ent-engine", { NULL }, 3665, "udp" },
+ { "eserver-pap", { NULL }, 3666, "tcp" },
+ { "eserver-pap", { NULL }, 3666, "udp" },
+ { "infoexch", { NULL }, 3667, "tcp" },
+ { "infoexch", { NULL }, 3667, "udp" },
+ { "dell-rm-port", { NULL }, 3668, "tcp" },
+ { "dell-rm-port", { NULL }, 3668, "udp" },
+ { "casanswmgmt", { NULL }, 3669, "tcp" },
+ { "casanswmgmt", { NULL }, 3669, "udp" },
+ { "smile", { NULL }, 3670, "tcp" },
+ { "smile", { NULL }, 3670, "udp" },
+ { "efcp", { NULL }, 3671, "tcp" },
+ { "efcp", { NULL }, 3671, "udp" },
+ { "lispworks-orb", { NULL }, 3672, "tcp" },
+ { "lispworks-orb", { NULL }, 3672, "udp" },
+ { "mediavault-gui", { NULL }, 3673, "tcp" },
+ { "mediavault-gui", { NULL }, 3673, "udp" },
+ { "wininstall-ipc", { NULL }, 3674, "tcp" },
+ { "wininstall-ipc", { NULL }, 3674, "udp" },
+ { "calltrax", { NULL }, 3675, "tcp" },
+ { "calltrax", { NULL }, 3675, "udp" },
+ { "va-pacbase", { NULL }, 3676, "tcp" },
+ { "va-pacbase", { NULL }, 3676, "udp" },
+ { "roverlog", { NULL }, 3677, "tcp" },
+ { "roverlog", { NULL }, 3677, "udp" },
+ { "ipr-dglt", { NULL }, 3678, "tcp" },
+ { "ipr-dglt", { NULL }, 3678, "udp" },
+ { "newton-dock", { NULL }, 3679, "tcp" },
+ { "newton-dock", { NULL }, 3679, "udp" },
+ { "npds-tracker", { NULL }, 3680, "tcp" },
+ { "npds-tracker", { NULL }, 3680, "udp" },
+ { "bts-x73", { NULL }, 3681, "tcp" },
+ { "bts-x73", { NULL }, 3681, "udp" },
+ { "cas-mapi", { NULL }, 3682, "tcp" },
+ { "cas-mapi", { NULL }, 3682, "udp" },
+ { "bmc-ea", { NULL }, 3683, "tcp" },
+ { "bmc-ea", { NULL }, 3683, "udp" },
+ { "faxstfx-port", { NULL }, 3684, "tcp" },
+ { "faxstfx-port", { NULL }, 3684, "udp" },
+ { "dsx-agent", { NULL }, 3685, "tcp" },
+ { "dsx-agent", { NULL }, 3685, "udp" },
+ { "tnmpv2", { NULL }, 3686, "tcp" },
+ { "tnmpv2", { NULL }, 3686, "udp" },
+ { "simple-push", { NULL }, 3687, "tcp" },
+ { "simple-push", { NULL }, 3687, "udp" },
+ { "simple-push-s", { NULL }, 3688, "tcp" },
+ { "simple-push-s", { NULL }, 3688, "udp" },
+ { "daap", { NULL }, 3689, "tcp" },
+ { "daap", { NULL }, 3689, "udp" },
+ { "svn", { NULL }, 3690, "tcp" },
+ { "svn", { NULL }, 3690, "udp" },
+ { "magaya-network", { NULL }, 3691, "tcp" },
+ { "magaya-network", { NULL }, 3691, "udp" },
+ { "intelsync", { NULL }, 3692, "tcp" },
+ { "intelsync", { NULL }, 3692, "udp" },
+ { "bmc-data-coll", { NULL }, 3695, "tcp" },
+ { "bmc-data-coll", { NULL }, 3695, "udp" },
+ { "telnetcpcd", { NULL }, 3696, "tcp" },
+ { "telnetcpcd", { NULL }, 3696, "udp" },
+ { "nw-license", { NULL }, 3697, "tcp" },
+ { "nw-license", { NULL }, 3697, "udp" },
+ { "sagectlpanel", { NULL }, 3698, "tcp" },
+ { "sagectlpanel", { NULL }, 3698, "udp" },
+ { "kpn-icw", { NULL }, 3699, "tcp" },
+ { "kpn-icw", { NULL }, 3699, "udp" },
+ { "lrs-paging", { NULL }, 3700, "tcp" },
+ { "lrs-paging", { NULL }, 3700, "udp" },
+ { "netcelera", { NULL }, 3701, "tcp" },
+ { "netcelera", { NULL }, 3701, "udp" },
+ { "ws-discovery", { NULL }, 3702, "tcp" },
+ { "ws-discovery", { NULL }, 3702, "udp" },
+ { "adobeserver-3", { NULL }, 3703, "tcp" },
+ { "adobeserver-3", { NULL }, 3703, "udp" },
+ { "adobeserver-4", { NULL }, 3704, "tcp" },
+ { "adobeserver-4", { NULL }, 3704, "udp" },
+ { "adobeserver-5", { NULL }, 3705, "tcp" },
+ { "adobeserver-5", { NULL }, 3705, "udp" },
+ { "rt-event", { NULL }, 3706, "tcp" },
+ { "rt-event", { NULL }, 3706, "udp" },
+ { "rt-event-s", { NULL }, 3707, "tcp" },
+ { "rt-event-s", { NULL }, 3707, "udp" },
+ { "sun-as-iiops", { NULL }, 3708, "tcp" },
+ { "sun-as-iiops", { NULL }, 3708, "udp" },
+ { "ca-idms", { NULL }, 3709, "tcp" },
+ { "ca-idms", { NULL }, 3709, "udp" },
+ { "portgate-auth", { NULL }, 3710, "tcp" },
+ { "portgate-auth", { NULL }, 3710, "udp" },
+ { "edb-server2", { NULL }, 3711, "tcp" },
+ { "edb-server2", { NULL }, 3711, "udp" },
+ { "sentinel-ent", { NULL }, 3712, "tcp" },
+ { "sentinel-ent", { NULL }, 3712, "udp" },
+ { "tftps", { NULL }, 3713, "tcp" },
+ { "tftps", { NULL }, 3713, "udp" },
+ { "delos-dms", { NULL }, 3714, "tcp" },
+ { "delos-dms", { NULL }, 3714, "udp" },
+ { "anoto-rendezv", { NULL }, 3715, "tcp" },
+ { "anoto-rendezv", { NULL }, 3715, "udp" },
+ { "wv-csp-sms-cir", { NULL }, 3716, "tcp" },
+ { "wv-csp-sms-cir", { NULL }, 3716, "udp" },
+ { "wv-csp-udp-cir", { NULL }, 3717, "tcp" },
+ { "wv-csp-udp-cir", { NULL }, 3717, "udp" },
+ { "opus-services", { NULL }, 3718, "tcp" },
+ { "opus-services", { NULL }, 3718, "udp" },
+ { "itelserverport", { NULL }, 3719, "tcp" },
+ { "itelserverport", { NULL }, 3719, "udp" },
+ { "ufastro-instr", { NULL }, 3720, "tcp" },
+ { "ufastro-instr", { NULL }, 3720, "udp" },
+ { "xsync", { NULL }, 3721, "tcp" },
+ { "xsync", { NULL }, 3721, "udp" },
+ { "xserveraid", { NULL }, 3722, "tcp" },
+ { "xserveraid", { NULL }, 3722, "udp" },
+ { "sychrond", { NULL }, 3723, "tcp" },
+ { "sychrond", { NULL }, 3723, "udp" },
+ { "blizwow", { NULL }, 3724, "tcp" },
+ { "blizwow", { NULL }, 3724, "udp" },
+ { "na-er-tip", { NULL }, 3725, "tcp" },
+ { "na-er-tip", { NULL }, 3725, "udp" },
+ { "array-manager", { NULL }, 3726, "tcp" },
+ { "array-manager", { NULL }, 3726, "udp" },
+ { "e-mdu", { NULL }, 3727, "tcp" },
+ { "e-mdu", { NULL }, 3727, "udp" },
+ { "e-woa", { NULL }, 3728, "tcp" },
+ { "e-woa", { NULL }, 3728, "udp" },
+ { "fksp-audit", { NULL }, 3729, "tcp" },
+ { "fksp-audit", { NULL }, 3729, "udp" },
+ { "client-ctrl", { NULL }, 3730, "tcp" },
+ { "client-ctrl", { NULL }, 3730, "udp" },
+ { "smap", { NULL }, 3731, "tcp" },
+ { "smap", { NULL }, 3731, "udp" },
+ { "m-wnn", { NULL }, 3732, "tcp" },
+ { "m-wnn", { NULL }, 3732, "udp" },
+ { "multip-msg", { NULL }, 3733, "tcp" },
+ { "multip-msg", { NULL }, 3733, "udp" },
+ { "synel-data", { NULL }, 3734, "tcp" },
+ { "synel-data", { NULL }, 3734, "udp" },
+ { "pwdis", { NULL }, 3735, "tcp" },
+ { "pwdis", { NULL }, 3735, "udp" },
+ { "rs-rmi", { NULL }, 3736, "tcp" },
+ { "rs-rmi", { NULL }, 3736, "udp" },
+ { "xpanel", { NULL }, 3737, "tcp" },
+ { "versatalk", { NULL }, 3738, "tcp" },
+ { "versatalk", { NULL }, 3738, "udp" },
+ { "launchbird-lm", { NULL }, 3739, "tcp" },
+ { "launchbird-lm", { NULL }, 3739, "udp" },
+ { "heartbeat", { NULL }, 3740, "tcp" },
+ { "heartbeat", { NULL }, 3740, "udp" },
+ { "wysdma", { NULL }, 3741, "tcp" },
+ { "wysdma", { NULL }, 3741, "udp" },
+ { "cst-port", { NULL }, 3742, "tcp" },
+ { "cst-port", { NULL }, 3742, "udp" },
+ { "ipcs-command", { NULL }, 3743, "tcp" },
+ { "ipcs-command", { NULL }, 3743, "udp" },
+ { "sasg", { NULL }, 3744, "tcp" },
+ { "sasg", { NULL }, 3744, "udp" },
+ { "gw-call-port", { NULL }, 3745, "tcp" },
+ { "gw-call-port", { NULL }, 3745, "udp" },
+ { "linktest", { NULL }, 3746, "tcp" },
+ { "linktest", { NULL }, 3746, "udp" },
+ { "linktest-s", { NULL }, 3747, "tcp" },
+ { "linktest-s", { NULL }, 3747, "udp" },
+ { "webdata", { NULL }, 3748, "tcp" },
+ { "webdata", { NULL }, 3748, "udp" },
+ { "cimtrak", { NULL }, 3749, "tcp" },
+ { "cimtrak", { NULL }, 3749, "udp" },
+ { "cbos-ip-port", { NULL }, 3750, "tcp" },
+ { "cbos-ip-port", { NULL }, 3750, "udp" },
+ { "gprs-cube", { NULL }, 3751, "tcp" },
+ { "gprs-cube", { NULL }, 3751, "udp" },
+ { "vipremoteagent", { NULL }, 3752, "tcp" },
+ { "vipremoteagent", { NULL }, 3752, "udp" },
+ { "nattyserver", { NULL }, 3753, "tcp" },
+ { "nattyserver", { NULL }, 3753, "udp" },
+ { "timestenbroker", { NULL }, 3754, "tcp" },
+ { "timestenbroker", { NULL }, 3754, "udp" },
+ { "sas-remote-hlp", { NULL }, 3755, "tcp" },
+ { "sas-remote-hlp", { NULL }, 3755, "udp" },
+ { "canon-capt", { NULL }, 3756, "tcp" },
+ { "canon-capt", { NULL }, 3756, "udp" },
+ { "grf-port", { NULL }, 3757, "tcp" },
+ { "grf-port", { NULL }, 3757, "udp" },
+ { "apw-registry", { NULL }, 3758, "tcp" },
+ { "apw-registry", { NULL }, 3758, "udp" },
+ { "exapt-lmgr", { NULL }, 3759, "tcp" },
+ { "exapt-lmgr", { NULL }, 3759, "udp" },
+ { "adtempusclient", { NULL }, 3760, "tcp" },
+ { "adtempusclient", { NULL }, 3760, "udp" },
+ { "gsakmp", { NULL }, 3761, "tcp" },
+ { "gsakmp", { NULL }, 3761, "udp" },
+ { "gbs-smp", { NULL }, 3762, "tcp" },
+ { "gbs-smp", { NULL }, 3762, "udp" },
+ { "xo-wave", { NULL }, 3763, "tcp" },
+ { "xo-wave", { NULL }, 3763, "udp" },
+ { "mni-prot-rout", { NULL }, 3764, "tcp" },
+ { "mni-prot-rout", { NULL }, 3764, "udp" },
+ { "rtraceroute", { NULL }, 3765, "tcp" },
+ { "rtraceroute", { NULL }, 3765, "udp" },
+ { "listmgr-port", { NULL }, 3767, "tcp" },
+ { "listmgr-port", { NULL }, 3767, "udp" },
+ { "rblcheckd", { NULL }, 3768, "tcp" },
+ { "rblcheckd", { NULL }, 3768, "udp" },
+ { "haipe-otnk", { NULL }, 3769, "tcp" },
+ { "haipe-otnk", { NULL }, 3769, "udp" },
+ { "cindycollab", { NULL }, 3770, "tcp" },
+ { "cindycollab", { NULL }, 3770, "udp" },
+ { "paging-port", { NULL }, 3771, "tcp" },
+ { "paging-port", { NULL }, 3771, "udp" },
+ { "ctp", { NULL }, 3772, "tcp" },
+ { "ctp", { NULL }, 3772, "udp" },
+ { "ctdhercules", { NULL }, 3773, "tcp" },
+ { "ctdhercules", { NULL }, 3773, "udp" },
+ { "zicom", { NULL }, 3774, "tcp" },
+ { "zicom", { NULL }, 3774, "udp" },
+ { "ispmmgr", { NULL }, 3775, "tcp" },
+ { "ispmmgr", { NULL }, 3775, "udp" },
+ { "dvcprov-port", { NULL }, 3776, "tcp" },
+ { "dvcprov-port", { NULL }, 3776, "udp" },
+ { "jibe-eb", { NULL }, 3777, "tcp" },
+ { "jibe-eb", { NULL }, 3777, "udp" },
+ { "c-h-it-port", { NULL }, 3778, "tcp" },
+ { "c-h-it-port", { NULL }, 3778, "udp" },
+ { "cognima", { NULL }, 3779, "tcp" },
+ { "cognima", { NULL }, 3779, "udp" },
+ { "nnp", { NULL }, 3780, "tcp" },
+ { "nnp", { NULL }, 3780, "udp" },
+ { "abcvoice-port", { NULL }, 3781, "tcp" },
+ { "abcvoice-port", { NULL }, 3781, "udp" },
+ { "iso-tp0s", { NULL }, 3782, "tcp" },
+ { "iso-tp0s", { NULL }, 3782, "udp" },
+ { "bim-pem", { NULL }, 3783, "tcp" },
+ { "bim-pem", { NULL }, 3783, "udp" },
+ { "bfd-control", { NULL }, 3784, "tcp" },
+ { "bfd-control", { NULL }, 3784, "udp" },
+ { "bfd-echo", { NULL }, 3785, "tcp" },
+ { "bfd-echo", { NULL }, 3785, "udp" },
+ { "upstriggervsw", { NULL }, 3786, "tcp" },
+ { "upstriggervsw", { NULL }, 3786, "udp" },
+ { "fintrx", { NULL }, 3787, "tcp" },
+ { "fintrx", { NULL }, 3787, "udp" },
+ { "isrp-port", { NULL }, 3788, "tcp" },
+ { "isrp-port", { NULL }, 3788, "udp" },
+ { "remotedeploy", { NULL }, 3789, "tcp" },
+ { "remotedeploy", { NULL }, 3789, "udp" },
+ { "quickbooksrds", { NULL }, 3790, "tcp" },
+ { "quickbooksrds", { NULL }, 3790, "udp" },
+ { "tvnetworkvideo", { NULL }, 3791, "tcp" },
+ { "tvnetworkvideo", { NULL }, 3791, "udp" },
+ { "sitewatch", { NULL }, 3792, "tcp" },
+ { "sitewatch", { NULL }, 3792, "udp" },
+ { "dcsoftware", { NULL }, 3793, "tcp" },
+ { "dcsoftware", { NULL }, 3793, "udp" },
+ { "jaus", { NULL }, 3794, "tcp" },
+ { "jaus", { NULL }, 3794, "udp" },
+ { "myblast", { NULL }, 3795, "tcp" },
+ { "myblast", { NULL }, 3795, "udp" },
+ { "spw-dialer", { NULL }, 3796, "tcp" },
+ { "spw-dialer", { NULL }, 3796, "udp" },
+ { "idps", { NULL }, 3797, "tcp" },
+ { "idps", { NULL }, 3797, "udp" },
+ { "minilock", { NULL }, 3798, "tcp" },
+ { "minilock", { NULL }, 3798, "udp" },
+ { "radius-dynauth", { NULL }, 3799, "tcp" },
+ { "radius-dynauth", { NULL }, 3799, "udp" },
+ { "pwgpsi", { NULL }, 3800, "tcp" },
+ { "pwgpsi", { NULL }, 3800, "udp" },
+ { "ibm-mgr", { NULL }, 3801, "tcp" },
+ { "ibm-mgr", { NULL }, 3801, "udp" },
+ { "vhd", { NULL }, 3802, "tcp" },
+ { "vhd", { NULL }, 3802, "udp" },
+ { "soniqsync", { NULL }, 3803, "tcp" },
+ { "soniqsync", { NULL }, 3803, "udp" },
+ { "iqnet-port", { NULL }, 3804, "tcp" },
+ { "iqnet-port", { NULL }, 3804, "udp" },
+ { "tcpdataserver", { NULL }, 3805, "tcp" },
+ { "tcpdataserver", { NULL }, 3805, "udp" },
+ { "wsmlb", { NULL }, 3806, "tcp" },
+ { "wsmlb", { NULL }, 3806, "udp" },
+ { "spugna", { NULL }, 3807, "tcp" },
+ { "spugna", { NULL }, 3807, "udp" },
+ { "sun-as-iiops-ca", { NULL }, 3808, "tcp" },
+ { "sun-as-iiops-ca", { NULL }, 3808, "udp" },
+ { "apocd", { NULL }, 3809, "tcp" },
+ { "apocd", { NULL }, 3809, "udp" },
+ { "wlanauth", { NULL }, 3810, "tcp" },
+ { "wlanauth", { NULL }, 3810, "udp" },
+ { "amp", { NULL }, 3811, "tcp" },
+ { "amp", { NULL }, 3811, "udp" },
+ { "neto-wol-server", { NULL }, 3812, "tcp" },
+ { "neto-wol-server", { NULL }, 3812, "udp" },
+ { "rap-ip", { NULL }, 3813, "tcp" },
+ { "rap-ip", { NULL }, 3813, "udp" },
+ { "neto-dcs", { NULL }, 3814, "tcp" },
+ { "neto-dcs", { NULL }, 3814, "udp" },
+ { "lansurveyorxml", { NULL }, 3815, "tcp" },
+ { "lansurveyorxml", { NULL }, 3815, "udp" },
+ { "sunlps-http", { NULL }, 3816, "tcp" },
+ { "sunlps-http", { NULL }, 3816, "udp" },
+ { "tapeware", { NULL }, 3817, "tcp" },
+ { "tapeware", { NULL }, 3817, "udp" },
+ { "crinis-hb", { NULL }, 3818, "tcp" },
+ { "crinis-hb", { NULL }, 3818, "udp" },
+ { "epl-slp", { NULL }, 3819, "tcp" },
+ { "epl-slp", { NULL }, 3819, "udp" },
+ { "scp", { NULL }, 3820, "tcp" },
+ { "scp", { NULL }, 3820, "udp" },
+ { "pmcp", { NULL }, 3821, "tcp" },
+ { "pmcp", { NULL }, 3821, "udp" },
+ { "acp-discovery", { NULL }, 3822, "tcp" },
+ { "acp-discovery", { NULL }, 3822, "udp" },
+ { "acp-conduit", { NULL }, 3823, "tcp" },
+ { "acp-conduit", { NULL }, 3823, "udp" },
+ { "acp-policy", { NULL }, 3824, "tcp" },
+ { "acp-policy", { NULL }, 3824, "udp" },
+ { "ffserver", { NULL }, 3825, "tcp" },
+ { "ffserver", { NULL }, 3825, "udp" },
+ { "wormux", { NULL }, 3826, "tcp" },
+ { "wormux", { NULL }, 3826, "udp" },
+ { "netmpi", { NULL }, 3827, "tcp" },
+ { "netmpi", { NULL }, 3827, "udp" },
+ { "neteh", { NULL }, 3828, "tcp" },
+ { "neteh", { NULL }, 3828, "udp" },
+ { "neteh-ext", { NULL }, 3829, "tcp" },
+ { "neteh-ext", { NULL }, 3829, "udp" },
+ { "cernsysmgmtagt", { NULL }, 3830, "tcp" },
+ { "cernsysmgmtagt", { NULL }, 3830, "udp" },
+ { "dvapps", { NULL }, 3831, "tcp" },
+ { "dvapps", { NULL }, 3831, "udp" },
+ { "xxnetserver", { NULL }, 3832, "tcp" },
+ { "xxnetserver", { NULL }, 3832, "udp" },
+ { "aipn-auth", { NULL }, 3833, "tcp" },
+ { "aipn-auth", { NULL }, 3833, "udp" },
+ { "spectardata", { NULL }, 3834, "tcp" },
+ { "spectardata", { NULL }, 3834, "udp" },
+ { "spectardb", { NULL }, 3835, "tcp" },
+ { "spectardb", { NULL }, 3835, "udp" },
+ { "markem-dcp", { NULL }, 3836, "tcp" },
+ { "markem-dcp", { NULL }, 3836, "udp" },
+ { "mkm-discovery", { NULL }, 3837, "tcp" },
+ { "mkm-discovery", { NULL }, 3837, "udp" },
+ { "sos", { NULL }, 3838, "tcp" },
+ { "sos", { NULL }, 3838, "udp" },
+ { "amx-rms", { NULL }, 3839, "tcp" },
+ { "amx-rms", { NULL }, 3839, "udp" },
+ { "flirtmitmir", { NULL }, 3840, "tcp" },
+ { "flirtmitmir", { NULL }, 3840, "udp" },
+ { "zfirm-shiprush3", { NULL }, 3841, "tcp" },
+ { "zfirm-shiprush3", { NULL }, 3841, "udp" },
+ { "nhci", { NULL }, 3842, "tcp" },
+ { "nhci", { NULL }, 3842, "udp" },
+ { "quest-agent", { NULL }, 3843, "tcp" },
+ { "quest-agent", { NULL }, 3843, "udp" },
+ { "rnm", { NULL }, 3844, "tcp" },
+ { "rnm", { NULL }, 3844, "udp" },
+ { "v-one-spp", { NULL }, 3845, "tcp" },
+ { "v-one-spp", { NULL }, 3845, "udp" },
+ { "an-pcp", { NULL }, 3846, "tcp" },
+ { "an-pcp", { NULL }, 3846, "udp" },
+ { "msfw-control", { NULL }, 3847, "tcp" },
+ { "msfw-control", { NULL }, 3847, "udp" },
+ { "item", { NULL }, 3848, "tcp" },
+ { "item", { NULL }, 3848, "udp" },
+ { "spw-dnspreload", { NULL }, 3849, "tcp" },
+ { "spw-dnspreload", { NULL }, 3849, "udp" },
+ { "qtms-bootstrap", { NULL }, 3850, "tcp" },
+ { "qtms-bootstrap", { NULL }, 3850, "udp" },
+ { "spectraport", { NULL }, 3851, "tcp" },
+ { "spectraport", { NULL }, 3851, "udp" },
+ { "sse-app-config", { NULL }, 3852, "tcp" },
+ { "sse-app-config", { NULL }, 3852, "udp" },
+ { "sscan", { NULL }, 3853, "tcp" },
+ { "sscan", { NULL }, 3853, "udp" },
+ { "stryker-com", { NULL }, 3854, "tcp" },
+ { "stryker-com", { NULL }, 3854, "udp" },
+ { "opentrac", { NULL }, 3855, "tcp" },
+ { "opentrac", { NULL }, 3855, "udp" },
+ { "informer", { NULL }, 3856, "tcp" },
+ { "informer", { NULL }, 3856, "udp" },
+ { "trap-port", { NULL }, 3857, "tcp" },
+ { "trap-port", { NULL }, 3857, "udp" },
+ { "trap-port-mom", { NULL }, 3858, "tcp" },
+ { "trap-port-mom", { NULL }, 3858, "udp" },
+ { "nav-port", { NULL }, 3859, "tcp" },
+ { "nav-port", { NULL }, 3859, "udp" },
+ { "sasp", { NULL }, 3860, "tcp" },
+ { "sasp", { NULL }, 3860, "udp" },
+ { "winshadow-hd", { NULL }, 3861, "tcp" },
+ { "winshadow-hd", { NULL }, 3861, "udp" },
+ { "giga-pocket", { NULL }, 3862, "tcp" },
+ { "giga-pocket", { NULL }, 3862, "udp" },
+ { "asap-tcp", { NULL }, 3863, "tcp" },
+ { "asap-udp", { NULL }, 3863, "udp" },
+ { "asap-sctp", { NULL }, 3863, "sctp"},
+ { "asap-tcp-tls", { NULL }, 3864, "tcp" },
+ { "asap-sctp-tls", { NULL }, 3864, "sctp"},
+ { "xpl", { NULL }, 3865, "tcp" },
+ { "xpl", { NULL }, 3865, "udp" },
+ { "dzdaemon", { NULL }, 3866, "tcp" },
+ { "dzdaemon", { NULL }, 3866, "udp" },
+ { "dzoglserver", { NULL }, 3867, "tcp" },
+ { "dzoglserver", { NULL }, 3867, "udp" },
+ { "diameter", { NULL }, 3868, "tcp" },
+ { "diameter", { NULL }, 3868, "sctp"},
+ { "ovsam-mgmt", { NULL }, 3869, "tcp" },
+ { "ovsam-mgmt", { NULL }, 3869, "udp" },
+ { "ovsam-d-agent", { NULL }, 3870, "tcp" },
+ { "ovsam-d-agent", { NULL }, 3870, "udp" },
+ { "avocent-adsap", { NULL }, 3871, "tcp" },
+ { "avocent-adsap", { NULL }, 3871, "udp" },
+ { "oem-agent", { NULL }, 3872, "tcp" },
+ { "oem-agent", { NULL }, 3872, "udp" },
+ { "fagordnc", { NULL }, 3873, "tcp" },
+ { "fagordnc", { NULL }, 3873, "udp" },
+ { "sixxsconfig", { NULL }, 3874, "tcp" },
+ { "sixxsconfig", { NULL }, 3874, "udp" },
+ { "pnbscada", { NULL }, 3875, "tcp" },
+ { "pnbscada", { NULL }, 3875, "udp" },
+ { "dl_agent", { NULL }, 3876, "tcp" },
+ { "dl_agent", { NULL }, 3876, "udp" },
+ { "xmpcr-interface", { NULL }, 3877, "tcp" },
+ { "xmpcr-interface", { NULL }, 3877, "udp" },
+ { "fotogcad", { NULL }, 3878, "tcp" },
+ { "fotogcad", { NULL }, 3878, "udp" },
+ { "appss-lm", { NULL }, 3879, "tcp" },
+ { "appss-lm", { NULL }, 3879, "udp" },
+ { "igrs", { NULL }, 3880, "tcp" },
+ { "igrs", { NULL }, 3880, "udp" },
+ { "idac", { NULL }, 3881, "tcp" },
+ { "idac", { NULL }, 3881, "udp" },
+ { "msdts1", { NULL }, 3882, "tcp" },
+ { "msdts1", { NULL }, 3882, "udp" },
+ { "vrpn", { NULL }, 3883, "tcp" },
+ { "vrpn", { NULL }, 3883, "udp" },
+ { "softrack-meter", { NULL }, 3884, "tcp" },
+ { "softrack-meter", { NULL }, 3884, "udp" },
+ { "topflow-ssl", { NULL }, 3885, "tcp" },
+ { "topflow-ssl", { NULL }, 3885, "udp" },
+ { "nei-management", { NULL }, 3886, "tcp" },
+ { "nei-management", { NULL }, 3886, "udp" },
+ { "ciphire-data", { NULL }, 3887, "tcp" },
+ { "ciphire-data", { NULL }, 3887, "udp" },
+ { "ciphire-serv", { NULL }, 3888, "tcp" },
+ { "ciphire-serv", { NULL }, 3888, "udp" },
+ { "dandv-tester", { NULL }, 3889, "tcp" },
+ { "dandv-tester", { NULL }, 3889, "udp" },
+ { "ndsconnect", { NULL }, 3890, "tcp" },
+ { "ndsconnect", { NULL }, 3890, "udp" },
+ { "rtc-pm-port", { NULL }, 3891, "tcp" },
+ { "rtc-pm-port", { NULL }, 3891, "udp" },
+ { "pcc-image-port", { NULL }, 3892, "tcp" },
+ { "pcc-image-port", { NULL }, 3892, "udp" },
+ { "cgi-starapi", { NULL }, 3893, "tcp" },
+ { "cgi-starapi", { NULL }, 3893, "udp" },
+ { "syam-agent", { NULL }, 3894, "tcp" },
+ { "syam-agent", { NULL }, 3894, "udp" },
+ { "syam-smc", { NULL }, 3895, "tcp" },
+ { "syam-smc", { NULL }, 3895, "udp" },
+ { "sdo-tls", { NULL }, 3896, "tcp" },
+ { "sdo-tls", { NULL }, 3896, "udp" },
+ { "sdo-ssh", { NULL }, 3897, "tcp" },
+ { "sdo-ssh", { NULL }, 3897, "udp" },
+ { "senip", { NULL }, 3898, "tcp" },
+ { "senip", { NULL }, 3898, "udp" },
+ { "itv-control", { NULL }, 3899, "tcp" },
+ { "itv-control", { NULL }, 3899, "udp" },
+ { "udt_os", { NULL }, 3900, "tcp" },
+ { "udt_os", { NULL }, 3900, "udp" },
+ { "nimsh", { NULL }, 3901, "tcp" },
+ { "nimsh", { NULL }, 3901, "udp" },
+ { "nimaux", { NULL }, 3902, "tcp" },
+ { "nimaux", { NULL }, 3902, "udp" },
+ { "charsetmgr", { NULL }, 3903, "tcp" },
+ { "charsetmgr", { NULL }, 3903, "udp" },
+ { "omnilink-port", { NULL }, 3904, "tcp" },
+ { "omnilink-port", { NULL }, 3904, "udp" },
+ { "mupdate", { NULL }, 3905, "tcp" },
+ { "mupdate", { NULL }, 3905, "udp" },
+ { "topovista-data", { NULL }, 3906, "tcp" },
+ { "topovista-data", { NULL }, 3906, "udp" },
+ { "imoguia-port", { NULL }, 3907, "tcp" },
+ { "imoguia-port", { NULL }, 3907, "udp" },
+ { "hppronetman", { NULL }, 3908, "tcp" },
+ { "hppronetman", { NULL }, 3908, "udp" },
+ { "surfcontrolcpa", { NULL }, 3909, "tcp" },
+ { "surfcontrolcpa", { NULL }, 3909, "udp" },
+ { "prnrequest", { NULL }, 3910, "tcp" },
+ { "prnrequest", { NULL }, 3910, "udp" },
+ { "prnstatus", { NULL }, 3911, "tcp" },
+ { "prnstatus", { NULL }, 3911, "udp" },
+ { "gbmt-stars", { NULL }, 3912, "tcp" },
+ { "gbmt-stars", { NULL }, 3912, "udp" },
+ { "listcrt-port", { NULL }, 3913, "tcp" },
+ { "listcrt-port", { NULL }, 3913, "udp" },
+ { "listcrt-port-2", { NULL }, 3914, "tcp" },
+ { "listcrt-port-2", { NULL }, 3914, "udp" },
+ { "agcat", { NULL }, 3915, "tcp" },
+ { "agcat", { NULL }, 3915, "udp" },
+ { "wysdmc", { NULL }, 3916, "tcp" },
+ { "wysdmc", { NULL }, 3916, "udp" },
+ { "aftmux", { NULL }, 3917, "tcp" },
+ { "aftmux", { NULL }, 3917, "udp" },
+ { "pktcablemmcops", { NULL }, 3918, "tcp" },
+ { "pktcablemmcops", { NULL }, 3918, "udp" },
+ { "hyperip", { NULL }, 3919, "tcp" },
+ { "hyperip", { NULL }, 3919, "udp" },
+ { "exasoftport1", { NULL }, 3920, "tcp" },
+ { "exasoftport1", { NULL }, 3920, "udp" },
+ { "herodotus-net", { NULL }, 3921, "tcp" },
+ { "herodotus-net", { NULL }, 3921, "udp" },
+ { "sor-update", { NULL }, 3922, "tcp" },
+ { "sor-update", { NULL }, 3922, "udp" },
+ { "symb-sb-port", { NULL }, 3923, "tcp" },
+ { "symb-sb-port", { NULL }, 3923, "udp" },
+ { "mpl-gprs-port", { NULL }, 3924, "tcp" },
+ { "mpl-gprs-port", { NULL }, 3924, "udp" },
+ { "zmp", { NULL }, 3925, "tcp" },
+ { "zmp", { NULL }, 3925, "udp" },
+ { "winport", { NULL }, 3926, "tcp" },
+ { "winport", { NULL }, 3926, "udp" },
+ { "natdataservice", { NULL }, 3927, "tcp" },
+ { "natdataservice", { NULL }, 3927, "udp" },
+ { "netboot-pxe", { NULL }, 3928, "tcp" },
+ { "netboot-pxe", { NULL }, 3928, "udp" },
+ { "smauth-port", { NULL }, 3929, "tcp" },
+ { "smauth-port", { NULL }, 3929, "udp" },
+ { "syam-webserver", { NULL }, 3930, "tcp" },
+ { "syam-webserver", { NULL }, 3930, "udp" },
+ { "msr-plugin-port", { NULL }, 3931, "tcp" },
+ { "msr-plugin-port", { NULL }, 3931, "udp" },
+ { "dyn-site", { NULL }, 3932, "tcp" },
+ { "dyn-site", { NULL }, 3932, "udp" },
+ { "plbserve-port", { NULL }, 3933, "tcp" },
+ { "plbserve-port", { NULL }, 3933, "udp" },
+ { "sunfm-port", { NULL }, 3934, "tcp" },
+ { "sunfm-port", { NULL }, 3934, "udp" },
+ { "sdp-portmapper", { NULL }, 3935, "tcp" },
+ { "sdp-portmapper", { NULL }, 3935, "udp" },
+ { "mailprox", { NULL }, 3936, "tcp" },
+ { "mailprox", { NULL }, 3936, "udp" },
+ { "dvbservdsc", { NULL }, 3937, "tcp" },
+ { "dvbservdsc", { NULL }, 3937, "udp" },
+ { "dbcontrol_agent", { NULL }, 3938, "tcp" },
+ { "dbcontrol_agent", { NULL }, 3938, "udp" },
+ { "aamp", { NULL }, 3939, "tcp" },
+ { "aamp", { NULL }, 3939, "udp" },
+ { "xecp-node", { NULL }, 3940, "tcp" },
+ { "xecp-node", { NULL }, 3940, "udp" },
+ { "homeportal-web", { NULL }, 3941, "tcp" },
+ { "homeportal-web", { NULL }, 3941, "udp" },
+ { "srdp", { NULL }, 3942, "tcp" },
+ { "srdp", { NULL }, 3942, "udp" },
+ { "tig", { NULL }, 3943, "tcp" },
+ { "tig", { NULL }, 3943, "udp" },
+ { "sops", { NULL }, 3944, "tcp" },
+ { "sops", { NULL }, 3944, "udp" },
+ { "emcads", { NULL }, 3945, "tcp" },
+ { "emcads", { NULL }, 3945, "udp" },
+ { "backupedge", { NULL }, 3946, "tcp" },
+ { "backupedge", { NULL }, 3946, "udp" },
+ { "ccp", { NULL }, 3947, "tcp" },
+ { "ccp", { NULL }, 3947, "udp" },
+ { "apdap", { NULL }, 3948, "tcp" },
+ { "apdap", { NULL }, 3948, "udp" },
+ { "drip", { NULL }, 3949, "tcp" },
+ { "drip", { NULL }, 3949, "udp" },
+ { "namemunge", { NULL }, 3950, "tcp" },
+ { "namemunge", { NULL }, 3950, "udp" },
+ { "pwgippfax", { NULL }, 3951, "tcp" },
+ { "pwgippfax", { NULL }, 3951, "udp" },
+ { "i3-sessionmgr", { NULL }, 3952, "tcp" },
+ { "i3-sessionmgr", { NULL }, 3952, "udp" },
+ { "xmlink-connect", { NULL }, 3953, "tcp" },
+ { "xmlink-connect", { NULL }, 3953, "udp" },
+ { "adrep", { NULL }, 3954, "tcp" },
+ { "adrep", { NULL }, 3954, "udp" },
+ { "p2pcommunity", { NULL }, 3955, "tcp" },
+ { "p2pcommunity", { NULL }, 3955, "udp" },
+ { "gvcp", { NULL }, 3956, "tcp" },
+ { "gvcp", { NULL }, 3956, "udp" },
+ { "mqe-broker", { NULL }, 3957, "tcp" },
+ { "mqe-broker", { NULL }, 3957, "udp" },
+ { "mqe-agent", { NULL }, 3958, "tcp" },
+ { "mqe-agent", { NULL }, 3958, "udp" },
+ { "treehopper", { NULL }, 3959, "tcp" },
+ { "treehopper", { NULL }, 3959, "udp" },
+ { "bess", { NULL }, 3960, "tcp" },
+ { "bess", { NULL }, 3960, "udp" },
+ { "proaxess", { NULL }, 3961, "tcp" },
+ { "proaxess", { NULL }, 3961, "udp" },
+ { "sbi-agent", { NULL }, 3962, "tcp" },
+ { "sbi-agent", { NULL }, 3962, "udp" },
+ { "thrp", { NULL }, 3963, "tcp" },
+ { "thrp", { NULL }, 3963, "udp" },
+ { "sasggprs", { NULL }, 3964, "tcp" },
+ { "sasggprs", { NULL }, 3964, "udp" },
+ { "ati-ip-to-ncpe", { NULL }, 3965, "tcp" },
+ { "ati-ip-to-ncpe", { NULL }, 3965, "udp" },
+ { "bflckmgr", { NULL }, 3966, "tcp" },
+ { "bflckmgr", { NULL }, 3966, "udp" },
+ { "ppsms", { NULL }, 3967, "tcp" },
+ { "ppsms", { NULL }, 3967, "udp" },
+ { "ianywhere-dbns", { NULL }, 3968, "tcp" },
+ { "ianywhere-dbns", { NULL }, 3968, "udp" },
+ { "landmarks", { NULL }, 3969, "tcp" },
+ { "landmarks", { NULL }, 3969, "udp" },
+ { "lanrevagent", { NULL }, 3970, "tcp" },
+ { "lanrevagent", { NULL }, 3970, "udp" },
+ { "lanrevserver", { NULL }, 3971, "tcp" },
+ { "lanrevserver", { NULL }, 3971, "udp" },
+ { "iconp", { NULL }, 3972, "tcp" },
+ { "iconp", { NULL }, 3972, "udp" },
+ { "progistics", { NULL }, 3973, "tcp" },
+ { "progistics", { NULL }, 3973, "udp" },
+ { "citysearch", { NULL }, 3974, "tcp" },
+ { "citysearch", { NULL }, 3974, "udp" },
+ { "airshot", { NULL }, 3975, "tcp" },
+ { "airshot", { NULL }, 3975, "udp" },
+ { "opswagent", { NULL }, 3976, "tcp" },
+ { "opswagent", { NULL }, 3976, "udp" },
+ { "opswmanager", { NULL }, 3977, "tcp" },
+ { "opswmanager", { NULL }, 3977, "udp" },
+ { "secure-cfg-svr", { NULL }, 3978, "tcp" },
+ { "secure-cfg-svr", { NULL }, 3978, "udp" },
+ { "smwan", { NULL }, 3979, "tcp" },
+ { "smwan", { NULL }, 3979, "udp" },
+ { "acms", { NULL }, 3980, "tcp" },
+ { "acms", { NULL }, 3980, "udp" },
+ { "starfish", { NULL }, 3981, "tcp" },
+ { "starfish", { NULL }, 3981, "udp" },
+ { "eis", { NULL }, 3982, "tcp" },
+ { "eis", { NULL }, 3982, "udp" },
+ { "eisp", { NULL }, 3983, "tcp" },
+ { "eisp", { NULL }, 3983, "udp" },
+ { "mapper-nodemgr", { NULL }, 3984, "tcp" },
+ { "mapper-nodemgr", { NULL }, 3984, "udp" },
+ { "mapper-mapethd", { NULL }, 3985, "tcp" },
+ { "mapper-mapethd", { NULL }, 3985, "udp" },
+ { "mapper-ws_ethd", { NULL }, 3986, "tcp" },
+ { "mapper-ws_ethd", { NULL }, 3986, "udp" },
+ { "centerline", { NULL }, 3987, "tcp" },
+ { "centerline", { NULL }, 3987, "udp" },
+ { "dcs-config", { NULL }, 3988, "tcp" },
+ { "dcs-config", { NULL }, 3988, "udp" },
+ { "bv-queryengine", { NULL }, 3989, "tcp" },
+ { "bv-queryengine", { NULL }, 3989, "udp" },
+ { "bv-is", { NULL }, 3990, "tcp" },
+ { "bv-is", { NULL }, 3990, "udp" },
+ { "bv-smcsrv", { NULL }, 3991, "tcp" },
+ { "bv-smcsrv", { NULL }, 3991, "udp" },
+ { "bv-ds", { NULL }, 3992, "tcp" },
+ { "bv-ds", { NULL }, 3992, "udp" },
+ { "bv-agent", { NULL }, 3993, "tcp" },
+ { "bv-agent", { NULL }, 3993, "udp" },
+ { "iss-mgmt-ssl", { NULL }, 3995, "tcp" },
+ { "iss-mgmt-ssl", { NULL }, 3995, "udp" },
+ { "abcsoftware", { NULL }, 3996, "tcp" },
+ { "abcsoftware", { NULL }, 3996, "udp" },
+ { "agentsease-db", { NULL }, 3997, "tcp" },
+ { "agentsease-db", { NULL }, 3997, "udp" },
+ { "dnx", { NULL }, 3998, "tcp" },
+ { "dnx", { NULL }, 3998, "udp" },
+ { "nvcnet", { NULL }, 3999, "tcp" },
+ { "nvcnet", { NULL }, 3999, "udp" },
+ { "terabase", { NULL }, 4000, "tcp" },
+ { "terabase", { NULL }, 4000, "udp" },
+ { "newoak", { NULL }, 4001, "tcp" },
+ { "newoak", { NULL }, 4001, "udp" },
+ { "pxc-spvr-ft", { NULL }, 4002, "tcp" },
+ { "pxc-spvr-ft", { NULL }, 4002, "udp" },
+ { "pxc-splr-ft", { NULL }, 4003, "tcp" },
+ { "pxc-splr-ft", { NULL }, 4003, "udp" },
+ { "pxc-roid", { NULL }, 4004, "tcp" },
+ { "pxc-roid", { NULL }, 4004, "udp" },
+ { "pxc-pin", { NULL }, 4005, "tcp" },
+ { "pxc-pin", { NULL }, 4005, "udp" },
+ { "pxc-spvr", { NULL }, 4006, "tcp" },
+ { "pxc-spvr", { NULL }, 4006, "udp" },
+ { "pxc-splr", { NULL }, 4007, "tcp" },
+ { "pxc-splr", { NULL }, 4007, "udp" },
+ { "netcheque", { NULL }, 4008, "tcp" },
+ { "netcheque", { NULL }, 4008, "udp" },
+ { "chimera-hwm", { NULL }, 4009, "tcp" },
+ { "chimera-hwm", { NULL }, 4009, "udp" },
+ { "samsung-unidex", { NULL }, 4010, "tcp" },
+ { "samsung-unidex", { NULL }, 4010, "udp" },
+ { "altserviceboot", { NULL }, 4011, "tcp" },
+ { "altserviceboot", { NULL }, 4011, "udp" },
+ { "pda-gate", { NULL }, 4012, "tcp" },
+ { "pda-gate", { NULL }, 4012, "udp" },
+ { "acl-manager", { NULL }, 4013, "tcp" },
+ { "acl-manager", { NULL }, 4013, "udp" },
+ { "taiclock", { NULL }, 4014, "tcp" },
+ { "taiclock", { NULL }, 4014, "udp" },
+ { "talarian-mcast1", { NULL }, 4015, "tcp" },
+ { "talarian-mcast1", { NULL }, 4015, "udp" },
+ { "talarian-mcast2", { NULL }, 4016, "tcp" },
+ { "talarian-mcast2", { NULL }, 4016, "udp" },
+ { "talarian-mcast3", { NULL }, 4017, "tcp" },
+ { "talarian-mcast3", { NULL }, 4017, "udp" },
+ { "talarian-mcast4", { NULL }, 4018, "tcp" },
+ { "talarian-mcast4", { NULL }, 4018, "udp" },
+ { "talarian-mcast5", { NULL }, 4019, "tcp" },
+ { "talarian-mcast5", { NULL }, 4019, "udp" },
+ { "trap", { NULL }, 4020, "tcp" },
+ { "trap", { NULL }, 4020, "udp" },
+ { "nexus-portal", { NULL }, 4021, "tcp" },
+ { "nexus-portal", { NULL }, 4021, "udp" },
+ { "dnox", { NULL }, 4022, "tcp" },
+ { "dnox", { NULL }, 4022, "udp" },
+ { "esnm-zoning", { NULL }, 4023, "tcp" },
+ { "esnm-zoning", { NULL }, 4023, "udp" },
+ { "tnp1-port", { NULL }, 4024, "tcp" },
+ { "tnp1-port", { NULL }, 4024, "udp" },
+ { "partimage", { NULL }, 4025, "tcp" },
+ { "partimage", { NULL }, 4025, "udp" },
+ { "as-debug", { NULL }, 4026, "tcp" },
+ { "as-debug", { NULL }, 4026, "udp" },
+ { "bxp", { NULL }, 4027, "tcp" },
+ { "bxp", { NULL }, 4027, "udp" },
+ { "dtserver-port", { NULL }, 4028, "tcp" },
+ { "dtserver-port", { NULL }, 4028, "udp" },
+ { "ip-qsig", { NULL }, 4029, "tcp" },
+ { "ip-qsig", { NULL }, 4029, "udp" },
+ { "jdmn-port", { NULL }, 4030, "tcp" },
+ { "jdmn-port", { NULL }, 4030, "udp" },
+ { "suucp", { NULL }, 4031, "tcp" },
+ { "suucp", { NULL }, 4031, "udp" },
+ { "vrts-auth-port", { NULL }, 4032, "tcp" },
+ { "vrts-auth-port", { NULL }, 4032, "udp" },
+ { "sanavigator", { NULL }, 4033, "tcp" },
+ { "sanavigator", { NULL }, 4033, "udp" },
+ { "ubxd", { NULL }, 4034, "tcp" },
+ { "ubxd", { NULL }, 4034, "udp" },
+ { "wap-push-http", { NULL }, 4035, "tcp" },
+ { "wap-push-http", { NULL }, 4035, "udp" },
+ { "wap-push-https", { NULL }, 4036, "tcp" },
+ { "wap-push-https", { NULL }, 4036, "udp" },
+ { "ravehd", { NULL }, 4037, "tcp" },
+ { "ravehd", { NULL }, 4037, "udp" },
+ { "fazzt-ptp", { NULL }, 4038, "tcp" },
+ { "fazzt-ptp", { NULL }, 4038, "udp" },
+ { "fazzt-admin", { NULL }, 4039, "tcp" },
+ { "fazzt-admin", { NULL }, 4039, "udp" },
+ { "yo-main", { NULL }, 4040, "tcp" },
+ { "yo-main", { NULL }, 4040, "udp" },
+ { "houston", { NULL }, 4041, "tcp" },
+ { "houston", { NULL }, 4041, "udp" },
+ { "ldxp", { NULL }, 4042, "tcp" },
+ { "ldxp", { NULL }, 4042, "udp" },
+ { "nirp", { NULL }, 4043, "tcp" },
+ { "nirp", { NULL }, 4043, "udp" },
+ { "ltp", { NULL }, 4044, "tcp" },
+ { "ltp", { NULL }, 4044, "udp" },
+ { "npp", { NULL }, 4045, "tcp" },
+ { "npp", { NULL }, 4045, "udp" },
+ { "acp-proto", { NULL }, 4046, "tcp" },
+ { "acp-proto", { NULL }, 4046, "udp" },
+ { "ctp-state", { NULL }, 4047, "tcp" },
+ { "ctp-state", { NULL }, 4047, "udp" },
+ { "wafs", { NULL }, 4049, "tcp" },
+ { "wafs", { NULL }, 4049, "udp" },
+ { "cisco-wafs", { NULL }, 4050, "tcp" },
+ { "cisco-wafs", { NULL }, 4050, "udp" },
+ { "cppdp", { NULL }, 4051, "tcp" },
+ { "cppdp", { NULL }, 4051, "udp" },
+ { "interact", { NULL }, 4052, "tcp" },
+ { "interact", { NULL }, 4052, "udp" },
+ { "ccu-comm-1", { NULL }, 4053, "tcp" },
+ { "ccu-comm-1", { NULL }, 4053, "udp" },
+ { "ccu-comm-2", { NULL }, 4054, "tcp" },
+ { "ccu-comm-2", { NULL }, 4054, "udp" },
+ { "ccu-comm-3", { NULL }, 4055, "tcp" },
+ { "ccu-comm-3", { NULL }, 4055, "udp" },
+ { "lms", { NULL }, 4056, "tcp" },
+ { "lms", { NULL }, 4056, "udp" },
+ { "wfm", { NULL }, 4057, "tcp" },
+ { "wfm", { NULL }, 4057, "udp" },
+ { "kingfisher", { NULL }, 4058, "tcp" },
+ { "kingfisher", { NULL }, 4058, "udp" },
+ { "dlms-cosem", { NULL }, 4059, "tcp" },
+ { "dlms-cosem", { NULL }, 4059, "udp" },
+ { "dsmeter_iatc", { NULL }, 4060, "tcp" },
+ { "dsmeter_iatc", { NULL }, 4060, "udp" },
+ { "ice-location", { NULL }, 4061, "tcp" },
+ { "ice-location", { NULL }, 4061, "udp" },
+ { "ice-slocation", { NULL }, 4062, "tcp" },
+ { "ice-slocation", { NULL }, 4062, "udp" },
+ { "ice-router", { NULL }, 4063, "tcp" },
+ { "ice-router", { NULL }, 4063, "udp" },
+ { "ice-srouter", { NULL }, 4064, "tcp" },
+ { "ice-srouter", { NULL }, 4064, "udp" },
+ { "avanti_cdp", { NULL }, 4065, "tcp" },
+ { "avanti_cdp", { NULL }, 4065, "udp" },
+ { "pmas", { NULL }, 4066, "tcp" },
+ { "pmas", { NULL }, 4066, "udp" },
+ { "idp", { NULL }, 4067, "tcp" },
+ { "idp", { NULL }, 4067, "udp" },
+ { "ipfltbcst", { NULL }, 4068, "tcp" },
+ { "ipfltbcst", { NULL }, 4068, "udp" },
+ { "minger", { NULL }, 4069, "tcp" },
+ { "minger", { NULL }, 4069, "udp" },
+ { "tripe", { NULL }, 4070, "tcp" },
+ { "tripe", { NULL }, 4070, "udp" },
+ { "aibkup", { NULL }, 4071, "tcp" },
+ { "aibkup", { NULL }, 4071, "udp" },
+ { "zieto-sock", { NULL }, 4072, "tcp" },
+ { "zieto-sock", { NULL }, 4072, "udp" },
+ { "iRAPP", { NULL }, 4073, "tcp" },
+ { "iRAPP", { NULL }, 4073, "udp" },
+ { "cequint-cityid", { NULL }, 4074, "tcp" },
+ { "cequint-cityid", { NULL }, 4074, "udp" },
+ { "perimlan", { NULL }, 4075, "tcp" },
+ { "perimlan", { NULL }, 4075, "udp" },
+ { "seraph", { NULL }, 4076, "tcp" },
+ { "seraph", { NULL }, 4076, "udp" },
+ { "ascomalarm", { NULL }, 4077, "udp" },
+ { "cssp", { NULL }, 4078, "tcp" },
+ { "santools", { NULL }, 4079, "tcp" },
+ { "santools", { NULL }, 4079, "udp" },
+ { "lorica-in", { NULL }, 4080, "tcp" },
+ { "lorica-in", { NULL }, 4080, "udp" },
+ { "lorica-in-sec", { NULL }, 4081, "tcp" },
+ { "lorica-in-sec", { NULL }, 4081, "udp" },
+ { "lorica-out", { NULL }, 4082, "tcp" },
+ { "lorica-out", { NULL }, 4082, "udp" },
+ { "lorica-out-sec", { NULL }, 4083, "tcp" },
+ { "lorica-out-sec", { NULL }, 4083, "udp" },
+ { "fortisphere-vm", { NULL }, 4084, "udp" },
+ { "ezmessagesrv", { NULL }, 4085, "tcp" },
+ { "ftsync", { NULL }, 4086, "udp" },
+ { "applusservice", { NULL }, 4087, "tcp" },
+ { "npsp", { NULL }, 4088, "tcp" },
+ { "opencore", { NULL }, 4089, "tcp" },
+ { "opencore", { NULL }, 4089, "udp" },
+ { "omasgport", { NULL }, 4090, "tcp" },
+ { "omasgport", { NULL }, 4090, "udp" },
+ { "ewinstaller", { NULL }, 4091, "tcp" },
+ { "ewinstaller", { NULL }, 4091, "udp" },
+ { "ewdgs", { NULL }, 4092, "tcp" },
+ { "ewdgs", { NULL }, 4092, "udp" },
+ { "pvxpluscs", { NULL }, 4093, "tcp" },
+ { "pvxpluscs", { NULL }, 4093, "udp" },
+ { "sysrqd", { NULL }, 4094, "tcp" },
+ { "sysrqd", { NULL }, 4094, "udp" },
+ { "xtgui", { NULL }, 4095, "tcp" },
+ { "xtgui", { NULL }, 4095, "udp" },
+ { "bre", { NULL }, 4096, "tcp" },
+ { "bre", { NULL }, 4096, "udp" },
+ { "patrolview", { NULL }, 4097, "tcp" },
+ { "patrolview", { NULL }, 4097, "udp" },
+ { "drmsfsd", { NULL }, 4098, "tcp" },
+ { "drmsfsd", { NULL }, 4098, "udp" },
+ { "dpcp", { NULL }, 4099, "tcp" },
+ { "dpcp", { NULL }, 4099, "udp" },
+ { "igo-incognito", { NULL }, 4100, "tcp" },
+ { "igo-incognito", { NULL }, 4100, "udp" },
+ { "brlp-0", { NULL }, 4101, "tcp" },
+ { "brlp-0", { NULL }, 4101, "udp" },
+ { "brlp-1", { NULL }, 4102, "tcp" },
+ { "brlp-1", { NULL }, 4102, "udp" },
+ { "brlp-2", { NULL }, 4103, "tcp" },
+ { "brlp-2", { NULL }, 4103, "udp" },
+ { "brlp-3", { NULL }, 4104, "tcp" },
+ { "brlp-3", { NULL }, 4104, "udp" },
+ { "shofarplayer", { NULL }, 4105, "tcp" },
+ { "shofarplayer", { NULL }, 4105, "udp" },
+ { "synchronite", { NULL }, 4106, "tcp" },
+ { "synchronite", { NULL }, 4106, "udp" },
+ { "j-ac", { NULL }, 4107, "tcp" },
+ { "j-ac", { NULL }, 4107, "udp" },
+ { "accel", { NULL }, 4108, "tcp" },
+ { "accel", { NULL }, 4108, "udp" },
+ { "izm", { NULL }, 4109, "tcp" },
+ { "izm", { NULL }, 4109, "udp" },
+ { "g2tag", { NULL }, 4110, "tcp" },
+ { "g2tag", { NULL }, 4110, "udp" },
+ { "xgrid", { NULL }, 4111, "tcp" },
+ { "xgrid", { NULL }, 4111, "udp" },
+ { "apple-vpns-rp", { NULL }, 4112, "tcp" },
+ { "apple-vpns-rp", { NULL }, 4112, "udp" },
+ { "aipn-reg", { NULL }, 4113, "tcp" },
+ { "aipn-reg", { NULL }, 4113, "udp" },
+ { "jomamqmonitor", { NULL }, 4114, "tcp" },
+ { "jomamqmonitor", { NULL }, 4114, "udp" },
+ { "cds", { NULL }, 4115, "tcp" },
+ { "cds", { NULL }, 4115, "udp" },
+ { "smartcard-tls", { NULL }, 4116, "tcp" },
+ { "smartcard-tls", { NULL }, 4116, "udp" },
+ { "hillrserv", { NULL }, 4117, "tcp" },
+ { "hillrserv", { NULL }, 4117, "udp" },
+ { "netscript", { NULL }, 4118, "tcp" },
+ { "netscript", { NULL }, 4118, "udp" },
+ { "assuria-slm", { NULL }, 4119, "tcp" },
+ { "assuria-slm", { NULL }, 4119, "udp" },
+ { "e-builder", { NULL }, 4121, "tcp" },
+ { "e-builder", { NULL }, 4121, "udp" },
+ { "fprams", { NULL }, 4122, "tcp" },
+ { "fprams", { NULL }, 4122, "udp" },
+ { "z-wave", { NULL }, 4123, "tcp" },
+ { "z-wave", { NULL }, 4123, "udp" },
+ { "tigv2", { NULL }, 4124, "tcp" },
+ { "tigv2", { NULL }, 4124, "udp" },
+ { "opsview-envoy", { NULL }, 4125, "tcp" },
+ { "opsview-envoy", { NULL }, 4125, "udp" },
+ { "ddrepl", { NULL }, 4126, "tcp" },
+ { "ddrepl", { NULL }, 4126, "udp" },
+ { "unikeypro", { NULL }, 4127, "tcp" },
+ { "unikeypro", { NULL }, 4127, "udp" },
+ { "nufw", { NULL }, 4128, "tcp" },
+ { "nufw", { NULL }, 4128, "udp" },
+ { "nuauth", { NULL }, 4129, "tcp" },
+ { "nuauth", { NULL }, 4129, "udp" },
+ { "fronet", { NULL }, 4130, "tcp" },
+ { "fronet", { NULL }, 4130, "udp" },
+ { "stars", { NULL }, 4131, "tcp" },
+ { "stars", { NULL }, 4131, "udp" },
+ { "nuts_dem", { NULL }, 4132, "tcp" },
+ { "nuts_dem", { NULL }, 4132, "udp" },
+ { "nuts_bootp", { NULL }, 4133, "tcp" },
+ { "nuts_bootp", { NULL }, 4133, "udp" },
+ { "nifty-hmi", { NULL }, 4134, "tcp" },
+ { "nifty-hmi", { NULL }, 4134, "udp" },
+ { "cl-db-attach", { NULL }, 4135, "tcp" },
+ { "cl-db-attach", { NULL }, 4135, "udp" },
+ { "cl-db-request", { NULL }, 4136, "tcp" },
+ { "cl-db-request", { NULL }, 4136, "udp" },
+ { "cl-db-remote", { NULL }, 4137, "tcp" },
+ { "cl-db-remote", { NULL }, 4137, "udp" },
+ { "nettest", { NULL }, 4138, "tcp" },
+ { "nettest", { NULL }, 4138, "udp" },
+ { "thrtx", { NULL }, 4139, "tcp" },
+ { "thrtx", { NULL }, 4139, "udp" },
+ { "cedros_fds", { NULL }, 4140, "tcp" },
+ { "cedros_fds", { NULL }, 4140, "udp" },
+ { "oirtgsvc", { NULL }, 4141, "tcp" },
+ { "oirtgsvc", { NULL }, 4141, "udp" },
+ { "oidocsvc", { NULL }, 4142, "tcp" },
+ { "oidocsvc", { NULL }, 4142, "udp" },
+ { "oidsr", { NULL }, 4143, "tcp" },
+ { "oidsr", { NULL }, 4143, "udp" },
+ { "vvr-control", { NULL }, 4145, "tcp" },
+ { "vvr-control", { NULL }, 4145, "udp" },
+ { "tgcconnect", { NULL }, 4146, "tcp" },
+ { "tgcconnect", { NULL }, 4146, "udp" },
+ { "vrxpservman", { NULL }, 4147, "tcp" },
+ { "vrxpservman", { NULL }, 4147, "udp" },
+ { "hhb-handheld", { NULL }, 4148, "tcp" },
+ { "hhb-handheld", { NULL }, 4148, "udp" },
+ { "agslb", { NULL }, 4149, "tcp" },
+ { "agslb", { NULL }, 4149, "udp" },
+ { "PowerAlert-nsa", { NULL }, 4150, "tcp" },
+ { "PowerAlert-nsa", { NULL }, 4150, "udp" },
+ { "menandmice_noh", { NULL }, 4151, "tcp" },
+ { "menandmice_noh", { NULL }, 4151, "udp" },
+ { "idig_mux", { NULL }, 4152, "tcp" },
+ { "idig_mux", { NULL }, 4152, "udp" },
+ { "mbl-battd", { NULL }, 4153, "tcp" },
+ { "mbl-battd", { NULL }, 4153, "udp" },
+ { "atlinks", { NULL }, 4154, "tcp" },
+ { "atlinks", { NULL }, 4154, "udp" },
+ { "bzr", { NULL }, 4155, "tcp" },
+ { "bzr", { NULL }, 4155, "udp" },
+ { "stat-results", { NULL }, 4156, "tcp" },
+ { "stat-results", { NULL }, 4156, "udp" },
+ { "stat-scanner", { NULL }, 4157, "tcp" },
+ { "stat-scanner", { NULL }, 4157, "udp" },
+ { "stat-cc", { NULL }, 4158, "tcp" },
+ { "stat-cc", { NULL }, 4158, "udp" },
+ { "nss", { NULL }, 4159, "tcp" },
+ { "nss", { NULL }, 4159, "udp" },
+ { "jini-discovery", { NULL }, 4160, "tcp" },
+ { "jini-discovery", { NULL }, 4160, "udp" },
+ { "omscontact", { NULL }, 4161, "tcp" },
+ { "omscontact", { NULL }, 4161, "udp" },
+ { "omstopology", { NULL }, 4162, "tcp" },
+ { "omstopology", { NULL }, 4162, "udp" },
+ { "silverpeakpeer", { NULL }, 4163, "tcp" },
+ { "silverpeakpeer", { NULL }, 4163, "udp" },
+ { "silverpeakcomm", { NULL }, 4164, "tcp" },
+ { "silverpeakcomm", { NULL }, 4164, "udp" },
+ { "altcp", { NULL }, 4165, "tcp" },
+ { "altcp", { NULL }, 4165, "udp" },
+ { "joost", { NULL }, 4166, "tcp" },
+ { "joost", { NULL }, 4166, "udp" },
+ { "ddgn", { NULL }, 4167, "tcp" },
+ { "ddgn", { NULL }, 4167, "udp" },
+ { "pslicser", { NULL }, 4168, "tcp" },
+ { "pslicser", { NULL }, 4168, "udp" },
+ { "iadt", { NULL }, 4169, "tcp" },
+ { "iadt-disc", { NULL }, 4169, "udp" },
+ { "d-cinema-csp", { NULL }, 4170, "tcp" },
+ { "ml-svnet", { NULL }, 4171, "tcp" },
+ { "pcoip", { NULL }, 4172, "tcp" },
+ { "pcoip", { NULL }, 4172, "udp" },
+ { "smcluster", { NULL }, 4174, "tcp" },
+ { "bccp", { NULL }, 4175, "tcp" },
+ { "tl-ipcproxy", { NULL }, 4176, "tcp" },
+ { "wello", { NULL }, 4177, "tcp" },
+ { "wello", { NULL }, 4177, "udp" },
+ { "storman", { NULL }, 4178, "tcp" },
+ { "storman", { NULL }, 4178, "udp" },
+ { "MaxumSP", { NULL }, 4179, "tcp" },
+ { "MaxumSP", { NULL }, 4179, "udp" },
+ { "httpx", { NULL }, 4180, "tcp" },
+ { "httpx", { NULL }, 4180, "udp" },
+ { "macbak", { NULL }, 4181, "tcp" },
+ { "macbak", { NULL }, 4181, "udp" },
+ { "pcptcpservice", { NULL }, 4182, "tcp" },
+ { "pcptcpservice", { NULL }, 4182, "udp" },
+ { "gmmp", { NULL }, 4183, "tcp" },
+ { "gmmp", { NULL }, 4183, "udp" },
+ { "universe_suite", { NULL }, 4184, "tcp" },
+ { "universe_suite", { NULL }, 4184, "udp" },
+ { "wcpp", { NULL }, 4185, "tcp" },
+ { "wcpp", { NULL }, 4185, "udp" },
+ { "boxbackupstore", { NULL }, 4186, "tcp" },
+ { "csc_proxy", { NULL }, 4187, "tcp" },
+ { "vatata", { NULL }, 4188, "tcp" },
+ { "vatata", { NULL }, 4188, "udp" },
+ { "pcep", { NULL }, 4189, "tcp" },
+ { "sieve", { NULL }, 4190, "tcp" },
+ { "dsmipv6", { NULL }, 4191, "udp" },
+ { "azeti", { NULL }, 4192, "tcp" },
+ { "azeti-bd", { NULL }, 4192, "udp" },
+ { "pvxplusio", { NULL }, 4193, "tcp" },
+ { "eims-admin", { NULL }, 4199, "tcp" },
+ { "eims-admin", { NULL }, 4199, "udp" },
+ { "corelccam", { NULL }, 4300, "tcp" },
+ { "corelccam", { NULL }, 4300, "udp" },
+ { "d-data", { NULL }, 4301, "tcp" },
+ { "d-data", { NULL }, 4301, "udp" },
+ { "d-data-control", { NULL }, 4302, "tcp" },
+ { "d-data-control", { NULL }, 4302, "udp" },
+ { "srcp", { NULL }, 4303, "tcp" },
+ { "srcp", { NULL }, 4303, "udp" },
+ { "owserver", { NULL }, 4304, "tcp" },
+ { "owserver", { NULL }, 4304, "udp" },
+ { "batman", { NULL }, 4305, "tcp" },
+ { "batman", { NULL }, 4305, "udp" },
+ { "pinghgl", { NULL }, 4306, "tcp" },
+ { "pinghgl", { NULL }, 4306, "udp" },
+ { "visicron-vs", { NULL }, 4307, "tcp" },
+ { "visicron-vs", { NULL }, 4307, "udp" },
+ { "compx-lockview", { NULL }, 4308, "tcp" },
+ { "compx-lockview", { NULL }, 4308, "udp" },
+ { "dserver", { NULL }, 4309, "tcp" },
+ { "dserver", { NULL }, 4309, "udp" },
+ { "mirrtex", { NULL }, 4310, "tcp" },
+ { "mirrtex", { NULL }, 4310, "udp" },
+ { "p6ssmc", { NULL }, 4311, "tcp" },
+ { "pscl-mgt", { NULL }, 4312, "tcp" },
+ { "perrla", { NULL }, 4313, "tcp" },
+ { "fdt-rcatp", { NULL }, 4320, "tcp" },
+ { "fdt-rcatp", { NULL }, 4320, "udp" },
+ { "rwhois", { NULL }, 4321, "tcp" },
+ { "rwhois", { NULL }, 4321, "udp" },
+ { "trim-event", { NULL }, 4322, "tcp" },
+ { "trim-event", { NULL }, 4322, "udp" },
+ { "trim-ice", { NULL }, 4323, "tcp" },
+ { "trim-ice", { NULL }, 4323, "udp" },
+ { "balour", { NULL }, 4324, "tcp" },
+ { "balour", { NULL }, 4324, "udp" },
+ { "geognosisman", { NULL }, 4325, "tcp" },
+ { "geognosisman", { NULL }, 4325, "udp" },
+ { "geognosis", { NULL }, 4326, "tcp" },
+ { "geognosis", { NULL }, 4326, "udp" },
+ { "jaxer-web", { NULL }, 4327, "tcp" },
+ { "jaxer-web", { NULL }, 4327, "udp" },
+ { "jaxer-manager", { NULL }, 4328, "tcp" },
+ { "jaxer-manager", { NULL }, 4328, "udp" },
+ { "publiqare-sync", { NULL }, 4329, "tcp" },
+ { "gaia", { NULL }, 4340, "tcp" },
+ { "gaia", { NULL }, 4340, "udp" },
+ { "lisp-data", { NULL }, 4341, "tcp" },
+ { "lisp-data", { NULL }, 4341, "udp" },
+ { "lisp-cons", { NULL }, 4342, "tcp" },
+ { "lisp-control", { NULL }, 4342, "udp" },
+ { "unicall", { NULL }, 4343, "tcp" },
+ { "unicall", { NULL }, 4343, "udp" },
+ { "vinainstall", { NULL }, 4344, "tcp" },
+ { "vinainstall", { NULL }, 4344, "udp" },
+ { "m4-network-as", { NULL }, 4345, "tcp" },
+ { "m4-network-as", { NULL }, 4345, "udp" },
+ { "elanlm", { NULL }, 4346, "tcp" },
+ { "elanlm", { NULL }, 4346, "udp" },
+ { "lansurveyor", { NULL }, 4347, "tcp" },
+ { "lansurveyor", { NULL }, 4347, "udp" },
+ { "itose", { NULL }, 4348, "tcp" },
+ { "itose", { NULL }, 4348, "udp" },
+ { "fsportmap", { NULL }, 4349, "tcp" },
+ { "fsportmap", { NULL }, 4349, "udp" },
+ { "net-device", { NULL }, 4350, "tcp" },
+ { "net-device", { NULL }, 4350, "udp" },
+ { "plcy-net-svcs", { NULL }, 4351, "tcp" },
+ { "plcy-net-svcs", { NULL }, 4351, "udp" },
+ { "pjlink", { NULL }, 4352, "tcp" },
+ { "pjlink", { NULL }, 4352, "udp" },
+ { "f5-iquery", { NULL }, 4353, "tcp" },
+ { "f5-iquery", { NULL }, 4353, "udp" },
+ { "qsnet-trans", { NULL }, 4354, "tcp" },
+ { "qsnet-trans", { NULL }, 4354, "udp" },
+ { "qsnet-workst", { NULL }, 4355, "tcp" },
+ { "qsnet-workst", { NULL }, 4355, "udp" },
+ { "qsnet-assist", { NULL }, 4356, "tcp" },
+ { "qsnet-assist", { NULL }, 4356, "udp" },
+ { "qsnet-cond", { NULL }, 4357, "tcp" },
+ { "qsnet-cond", { NULL }, 4357, "udp" },
+ { "qsnet-nucl", { NULL }, 4358, "tcp" },
+ { "qsnet-nucl", { NULL }, 4358, "udp" },
+ { "omabcastltkm", { NULL }, 4359, "tcp" },
+ { "omabcastltkm", { NULL }, 4359, "udp" },
+ { "matrix_vnet", { NULL }, 4360, "tcp" },
+ { "nacnl", { NULL }, 4361, "udp" },
+ { "afore-vdp-disc", { NULL }, 4362, "udp" },
+ { "wxbrief", { NULL }, 4368, "tcp" },
+ { "wxbrief", { NULL }, 4368, "udp" },
+ { "epmd", { NULL }, 4369, "tcp" },
+ { "epmd", { NULL }, 4369, "udp" },
+ { "elpro_tunnel", { NULL }, 4370, "tcp" },
+ { "elpro_tunnel", { NULL }, 4370, "udp" },
+ { "l2c-control", { NULL }, 4371, "tcp" },
+ { "l2c-disc", { NULL }, 4371, "udp" },
+ { "l2c-data", { NULL }, 4372, "tcp" },
+ { "l2c-data", { NULL }, 4372, "udp" },
+ { "remctl", { NULL }, 4373, "tcp" },
+ { "remctl", { NULL }, 4373, "udp" },
+ { "psi-ptt", { NULL }, 4374, "tcp" },
+ { "tolteces", { NULL }, 4375, "tcp" },
+ { "tolteces", { NULL }, 4375, "udp" },
+ { "bip", { NULL }, 4376, "tcp" },
+ { "bip", { NULL }, 4376, "udp" },
+ { "cp-spxsvr", { NULL }, 4377, "tcp" },
+ { "cp-spxsvr", { NULL }, 4377, "udp" },
+ { "cp-spxdpy", { NULL }, 4378, "tcp" },
+ { "cp-spxdpy", { NULL }, 4378, "udp" },
+ { "ctdb", { NULL }, 4379, "tcp" },
+ { "ctdb", { NULL }, 4379, "udp" },
+ { "xandros-cms", { NULL }, 4389, "tcp" },
+ { "xandros-cms", { NULL }, 4389, "udp" },
+ { "wiegand", { NULL }, 4390, "tcp" },
+ { "wiegand", { NULL }, 4390, "udp" },
+ { "apwi-imserver", { NULL }, 4391, "tcp" },
+ { "apwi-rxserver", { NULL }, 4392, "tcp" },
+ { "apwi-rxspooler", { NULL }, 4393, "tcp" },
+ { "apwi-disc", { NULL }, 4394, "udp" },
+ { "omnivisionesx", { NULL }, 4395, "tcp" },
+ { "omnivisionesx", { NULL }, 4395, "udp" },
+ { "fly", { NULL }, 4396, "tcp" },
+ { "ds-srv", { NULL }, 4400, "tcp" },
+ { "ds-srv", { NULL }, 4400, "udp" },
+ { "ds-srvr", { NULL }, 4401, "tcp" },
+ { "ds-srvr", { NULL }, 4401, "udp" },
+ { "ds-clnt", { NULL }, 4402, "tcp" },
+ { "ds-clnt", { NULL }, 4402, "udp" },
+ { "ds-user", { NULL }, 4403, "tcp" },
+ { "ds-user", { NULL }, 4403, "udp" },
+ { "ds-admin", { NULL }, 4404, "tcp" },
+ { "ds-admin", { NULL }, 4404, "udp" },
+ { "ds-mail", { NULL }, 4405, "tcp" },
+ { "ds-mail", { NULL }, 4405, "udp" },
+ { "ds-slp", { NULL }, 4406, "tcp" },
+ { "ds-slp", { NULL }, 4406, "udp" },
+ { "nacagent", { NULL }, 4407, "tcp" },
+ { "slscc", { NULL }, 4408, "tcp" },
+ { "netcabinet-com", { NULL }, 4409, "tcp" },
+ { "itwo-server", { NULL }, 4410, "tcp" },
+ { "netrockey6", { NULL }, 4425, "tcp" },
+ { "netrockey6", { NULL }, 4425, "udp" },
+ { "beacon-port-2", { NULL }, 4426, "tcp" },
+ { "beacon-port-2", { NULL }, 4426, "udp" },
+ { "drizzle", { NULL }, 4427, "tcp" },
+ { "omviserver", { NULL }, 4428, "tcp" },
+ { "omviagent", { NULL }, 4429, "tcp" },
+ { "rsqlserver", { NULL }, 4430, "tcp" },
+ { "rsqlserver", { NULL }, 4430, "udp" },
+ { "wspipe", { NULL }, 4431, "tcp" },
+ { "netblox", { NULL }, 4441, "udp" },
+ { "saris", { NULL }, 4442, "tcp" },
+ { "saris", { NULL }, 4442, "udp" },
+ { "pharos", { NULL }, 4443, "tcp" },
+ { "pharos", { NULL }, 4443, "udp" },
+ { "krb524", { NULL }, 4444, "tcp" },
+ { "krb524", { NULL }, 4444, "udp" },
+ { "nv-video", { NULL }, 4444, "tcp" },
+ { "nv-video", { NULL }, 4444, "udp" },
+ { "upnotifyp", { NULL }, 4445, "tcp" },
+ { "upnotifyp", { NULL }, 4445, "udp" },
+ { "n1-fwp", { NULL }, 4446, "tcp" },
+ { "n1-fwp", { NULL }, 4446, "udp" },
+ { "n1-rmgmt", { NULL }, 4447, "tcp" },
+ { "n1-rmgmt", { NULL }, 4447, "udp" },
+ { "asc-slmd", { NULL }, 4448, "tcp" },
+ { "asc-slmd", { NULL }, 4448, "udp" },
+ { "privatewire", { NULL }, 4449, "tcp" },
+ { "privatewire", { NULL }, 4449, "udp" },
+ { "camp", { NULL }, 4450, "tcp" },
+ { "camp", { NULL }, 4450, "udp" },
+ { "ctisystemmsg", { NULL }, 4451, "tcp" },
+ { "ctisystemmsg", { NULL }, 4451, "udp" },
+ { "ctiprogramload", { NULL }, 4452, "tcp" },
+ { "ctiprogramload", { NULL }, 4452, "udp" },
+ { "nssalertmgr", { NULL }, 4453, "tcp" },
+ { "nssalertmgr", { NULL }, 4453, "udp" },
+ { "nssagentmgr", { NULL }, 4454, "tcp" },
+ { "nssagentmgr", { NULL }, 4454, "udp" },
+ { "prchat-user", { NULL }, 4455, "tcp" },
+ { "prchat-user", { NULL }, 4455, "udp" },
+ { "prchat-server", { NULL }, 4456, "tcp" },
+ { "prchat-server", { NULL }, 4456, "udp" },
+ { "prRegister", { NULL }, 4457, "tcp" },
+ { "prRegister", { NULL }, 4457, "udp" },
+ { "mcp", { NULL }, 4458, "tcp" },
+ { "mcp", { NULL }, 4458, "udp" },
+ { "hpssmgmt", { NULL }, 4484, "tcp" },
+ { "hpssmgmt", { NULL }, 4484, "udp" },
+ { "assyst-dr", { NULL }, 4485, "tcp" },
+ { "icms", { NULL }, 4486, "tcp" },
+ { "icms", { NULL }, 4486, "udp" },
+ { "prex-tcp", { NULL }, 4487, "tcp" },
+ { "awacs-ice", { NULL }, 4488, "tcp" },
+ { "awacs-ice", { NULL }, 4488, "udp" },
+ { "ipsec-nat-t", { NULL }, 4500, "tcp" },
+ { "ipsec-nat-t", { NULL }, 4500, "udp" },
+ { "ehs", { NULL }, 4535, "tcp" },
+ { "ehs", { NULL }, 4535, "udp" },
+ { "ehs-ssl", { NULL }, 4536, "tcp" },
+ { "ehs-ssl", { NULL }, 4536, "udp" },
+ { "wssauthsvc", { NULL }, 4537, "tcp" },
+ { "wssauthsvc", { NULL }, 4537, "udp" },
+ { "swx-gate", { NULL }, 4538, "tcp" },
+ { "swx-gate", { NULL }, 4538, "udp" },
+ { "worldscores", { NULL }, 4545, "tcp" },
+ { "worldscores", { NULL }, 4545, "udp" },
+ { "sf-lm", { NULL }, 4546, "tcp" },
+ { "sf-lm", { NULL }, 4546, "udp" },
+ { "lanner-lm", { NULL }, 4547, "tcp" },
+ { "lanner-lm", { NULL }, 4547, "udp" },
+ { "synchromesh", { NULL }, 4548, "tcp" },
+ { "synchromesh", { NULL }, 4548, "udp" },
+ { "aegate", { NULL }, 4549, "tcp" },
+ { "aegate", { NULL }, 4549, "udp" },
+ { "gds-adppiw-db", { NULL }, 4550, "tcp" },
+ { "gds-adppiw-db", { NULL }, 4550, "udp" },
+ { "ieee-mih", { NULL }, 4551, "tcp" },
+ { "ieee-mih", { NULL }, 4551, "udp" },
+ { "menandmice-mon", { NULL }, 4552, "tcp" },
+ { "menandmice-mon", { NULL }, 4552, "udp" },
+ { "icshostsvc", { NULL }, 4553, "tcp" },
+ { "msfrs", { NULL }, 4554, "tcp" },
+ { "msfrs", { NULL }, 4554, "udp" },
+ { "rsip", { NULL }, 4555, "tcp" },
+ { "rsip", { NULL }, 4555, "udp" },
+ { "dtn-bundle-tcp", { NULL }, 4556, "tcp" },
+ { "dtn-bundle-udp", { NULL }, 4556, "udp" },
+ { "mtcevrunqss", { NULL }, 4557, "udp" },
+ { "mtcevrunqman", { NULL }, 4558, "udp" },
+ { "hylafax", { NULL }, 4559, "tcp" },
+ { "hylafax", { NULL }, 4559, "udp" },
+ { "kwtc", { NULL }, 4566, "tcp" },
+ { "kwtc", { NULL }, 4566, "udp" },
+ { "tram", { NULL }, 4567, "tcp" },
+ { "tram", { NULL }, 4567, "udp" },
+ { "bmc-reporting", { NULL }, 4568, "tcp" },
+ { "bmc-reporting", { NULL }, 4568, "udp" },
+ { "iax", { NULL }, 4569, "tcp" },
+ { "iax", { NULL }, 4569, "udp" },
+ { "rid", { NULL }, 4590, "tcp" },
+ { "l3t-at-an", { NULL }, 4591, "tcp" },
+ { "l3t-at-an", { NULL }, 4591, "udp" },
+ { "hrpd-ith-at-an", { NULL }, 4592, "udp" },
+ { "ipt-anri-anri", { NULL }, 4593, "tcp" },
+ { "ipt-anri-anri", { NULL }, 4593, "udp" },
+ { "ias-session", { NULL }, 4594, "tcp" },
+ { "ias-session", { NULL }, 4594, "udp" },
+ { "ias-paging", { NULL }, 4595, "tcp" },
+ { "ias-paging", { NULL }, 4595, "udp" },
+ { "ias-neighbor", { NULL }, 4596, "tcp" },
+ { "ias-neighbor", { NULL }, 4596, "udp" },
+ { "a21-an-1xbs", { NULL }, 4597, "tcp" },
+ { "a21-an-1xbs", { NULL }, 4597, "udp" },
+ { "a16-an-an", { NULL }, 4598, "tcp" },
+ { "a16-an-an", { NULL }, 4598, "udp" },
+ { "a17-an-an", { NULL }, 4599, "tcp" },
+ { "a17-an-an", { NULL }, 4599, "udp" },
+ { "piranha1", { NULL }, 4600, "tcp" },
+ { "piranha1", { NULL }, 4600, "udp" },
+ { "piranha2", { NULL }, 4601, "tcp" },
+ { "piranha2", { NULL }, 4601, "udp" },
+ { "mtsserver", { NULL }, 4602, "tcp" },
+ { "menandmice-upg", { NULL }, 4603, "tcp" },
+ { "playsta2-app", { NULL }, 4658, "tcp" },
+ { "playsta2-app", { NULL }, 4658, "udp" },
+ { "playsta2-lob", { NULL }, 4659, "tcp" },
+ { "playsta2-lob", { NULL }, 4659, "udp" },
+ { "smaclmgr", { NULL }, 4660, "tcp" },
+ { "smaclmgr", { NULL }, 4660, "udp" },
+ { "kar2ouche", { NULL }, 4661, "tcp" },
+ { "kar2ouche", { NULL }, 4661, "udp" },
+ { "oms", { NULL }, 4662, "tcp" },
+ { "oms", { NULL }, 4662, "udp" },
+ { "noteit", { NULL }, 4663, "tcp" },
+ { "noteit", { NULL }, 4663, "udp" },
+ { "ems", { NULL }, 4664, "tcp" },
+ { "ems", { NULL }, 4664, "udp" },
+ { "contclientms", { NULL }, 4665, "tcp" },
+ { "contclientms", { NULL }, 4665, "udp" },
+ { "eportcomm", { NULL }, 4666, "tcp" },
+ { "eportcomm", { NULL }, 4666, "udp" },
+ { "mmacomm", { NULL }, 4667, "tcp" },
+ { "mmacomm", { NULL }, 4667, "udp" },
+ { "mmaeds", { NULL }, 4668, "tcp" },
+ { "mmaeds", { NULL }, 4668, "udp" },
+ { "eportcommdata", { NULL }, 4669, "tcp" },
+ { "eportcommdata", { NULL }, 4669, "udp" },
+ { "light", { NULL }, 4670, "tcp" },
+ { "light", { NULL }, 4670, "udp" },
+ { "acter", { NULL }, 4671, "tcp" },
+ { "acter", { NULL }, 4671, "udp" },
+ { "rfa", { NULL }, 4672, "tcp" },
+ { "rfa", { NULL }, 4672, "udp" },
+ { "cxws", { NULL }, 4673, "tcp" },
+ { "cxws", { NULL }, 4673, "udp" },
+ { "appiq-mgmt", { NULL }, 4674, "tcp" },
+ { "appiq-mgmt", { NULL }, 4674, "udp" },
+ { "dhct-status", { NULL }, 4675, "tcp" },
+ { "dhct-status", { NULL }, 4675, "udp" },
+ { "dhct-alerts", { NULL }, 4676, "tcp" },
+ { "dhct-alerts", { NULL }, 4676, "udp" },
+ { "bcs", { NULL }, 4677, "tcp" },
+ { "bcs", { NULL }, 4677, "udp" },
+ { "traversal", { NULL }, 4678, "tcp" },
+ { "traversal", { NULL }, 4678, "udp" },
+ { "mgesupervision", { NULL }, 4679, "tcp" },
+ { "mgesupervision", { NULL }, 4679, "udp" },
+ { "mgemanagement", { NULL }, 4680, "tcp" },
+ { "mgemanagement", { NULL }, 4680, "udp" },
+ { "parliant", { NULL }, 4681, "tcp" },
+ { "parliant", { NULL }, 4681, "udp" },
+ { "finisar", { NULL }, 4682, "tcp" },
+ { "finisar", { NULL }, 4682, "udp" },
+ { "spike", { NULL }, 4683, "tcp" },
+ { "spike", { NULL }, 4683, "udp" },
+ { "rfid-rp1", { NULL }, 4684, "tcp" },
+ { "rfid-rp1", { NULL }, 4684, "udp" },
+ { "autopac", { NULL }, 4685, "tcp" },
+ { "autopac", { NULL }, 4685, "udp" },
+ { "msp-os", { NULL }, 4686, "tcp" },
+ { "msp-os", { NULL }, 4686, "udp" },
+ { "nst", { NULL }, 4687, "tcp" },
+ { "nst", { NULL }, 4687, "udp" },
+ { "mobile-p2p", { NULL }, 4688, "tcp" },
+ { "mobile-p2p", { NULL }, 4688, "udp" },
+ { "altovacentral", { NULL }, 4689, "tcp" },
+ { "altovacentral", { NULL }, 4689, "udp" },
+ { "prelude", { NULL }, 4690, "tcp" },
+ { "prelude", { NULL }, 4690, "udp" },
+ { "mtn", { NULL }, 4691, "tcp" },
+ { "mtn", { NULL }, 4691, "udp" },
+ { "conspiracy", { NULL }, 4692, "tcp" },
+ { "conspiracy", { NULL }, 4692, "udp" },
+ { "netxms-agent", { NULL }, 4700, "tcp" },
+ { "netxms-agent", { NULL }, 4700, "udp" },
+ { "netxms-mgmt", { NULL }, 4701, "tcp" },
+ { "netxms-mgmt", { NULL }, 4701, "udp" },
+ { "netxms-sync", { NULL }, 4702, "tcp" },
+ { "netxms-sync", { NULL }, 4702, "udp" },
+ { "npqes-test", { NULL }, 4703, "tcp" },
+ { "assuria-ins", { NULL }, 4704, "tcp" },
+ { "truckstar", { NULL }, 4725, "tcp" },
+ { "truckstar", { NULL }, 4725, "udp" },
+ { "a26-fap-fgw", { NULL }, 4726, "udp" },
+ { "fcis", { NULL }, 4727, "tcp" },
+ { "fcis-disc", { NULL }, 4727, "udp" },
+ { "capmux", { NULL }, 4728, "tcp" },
+ { "capmux", { NULL }, 4728, "udp" },
+ { "gsmtap", { NULL }, 4729, "udp" },
+ { "gearman", { NULL }, 4730, "tcp" },
+ { "gearman", { NULL }, 4730, "udp" },
+ { "remcap", { NULL }, 4731, "tcp" },
+ { "ohmtrigger", { NULL }, 4732, "udp" },
+ { "resorcs", { NULL }, 4733, "tcp" },
+ { "ipdr-sp", { NULL }, 4737, "tcp" },
+ { "ipdr-sp", { NULL }, 4737, "udp" },
+ { "solera-lpn", { NULL }, 4738, "tcp" },
+ { "solera-lpn", { NULL }, 4738, "udp" },
+ { "ipfix", { NULL }, 4739, "tcp" },
+ { "ipfix", { NULL }, 4739, "udp" },
+ { "ipfix", { NULL }, 4739, "sctp"},
+ { "ipfixs", { NULL }, 4740, "tcp" },
+ { "ipfixs", { NULL }, 4740, "sctp"},
+ { "ipfixs", { NULL }, 4740, "udp" },
+ { "lumimgrd", { NULL }, 4741, "tcp" },
+ { "lumimgrd", { NULL }, 4741, "udp" },
+ { "sicct", { NULL }, 4742, "tcp" },
+ { "sicct-sdp", { NULL }, 4742, "udp" },
+ { "openhpid", { NULL }, 4743, "tcp" },
+ { "openhpid", { NULL }, 4743, "udp" },
+ { "ifsp", { NULL }, 4744, "tcp" },
+ { "ifsp", { NULL }, 4744, "udp" },
+ { "fmp", { NULL }, 4745, "tcp" },
+ { "fmp", { NULL }, 4745, "udp" },
+ { "profilemac", { NULL }, 4749, "tcp" },
+ { "profilemac", { NULL }, 4749, "udp" },
+ { "ssad", { NULL }, 4750, "tcp" },
+ { "ssad", { NULL }, 4750, "udp" },
+ { "spocp", { NULL }, 4751, "tcp" },
+ { "spocp", { NULL }, 4751, "udp" },
+ { "snap", { NULL }, 4752, "tcp" },
+ { "snap", { NULL }, 4752, "udp" },
+ { "bfd-multi-ctl", { NULL }, 4784, "tcp" },
+ { "bfd-multi-ctl", { NULL }, 4784, "udp" },
+ { "cncp", { NULL }, 4785, "udp" },
+ { "smart-install", { NULL }, 4786, "tcp" },
+ { "sia-ctrl-plane", { NULL }, 4787, "tcp" },
+ { "iims", { NULL }, 4800, "tcp" },
+ { "iims", { NULL }, 4800, "udp" },
+ { "iwec", { NULL }, 4801, "tcp" },
+ { "iwec", { NULL }, 4801, "udp" },
+ { "ilss", { NULL }, 4802, "tcp" },
+ { "ilss", { NULL }, 4802, "udp" },
+ { "notateit", { NULL }, 4803, "tcp" },
+ { "notateit-disc", { NULL }, 4803, "udp" },
+ { "aja-ntv4-disc", { NULL }, 4804, "udp" },
+ { "htcp", { NULL }, 4827, "tcp" },
+ { "htcp", { NULL }, 4827, "udp" },
+ { "varadero-0", { NULL }, 4837, "tcp" },
+ { "varadero-0", { NULL }, 4837, "udp" },
+ { "varadero-1", { NULL }, 4838, "tcp" },
+ { "varadero-1", { NULL }, 4838, "udp" },
+ { "varadero-2", { NULL }, 4839, "tcp" },
+ { "varadero-2", { NULL }, 4839, "udp" },
+ { "opcua-tcp", { NULL }, 4840, "tcp" },
+ { "opcua-udp", { NULL }, 4840, "udp" },
+ { "quosa", { NULL }, 4841, "tcp" },
+ { "quosa", { NULL }, 4841, "udp" },
+ { "gw-asv", { NULL }, 4842, "tcp" },
+ { "gw-asv", { NULL }, 4842, "udp" },
+ { "opcua-tls", { NULL }, 4843, "tcp" },
+ { "opcua-tls", { NULL }, 4843, "udp" },
+ { "gw-log", { NULL }, 4844, "tcp" },
+ { "gw-log", { NULL }, 4844, "udp" },
+ { "wcr-remlib", { NULL }, 4845, "tcp" },
+ { "wcr-remlib", { NULL }, 4845, "udp" },
+ { "contamac_icm", { NULL }, 4846, "tcp" },
+ { "contamac_icm", { NULL }, 4846, "udp" },
+ { "wfc", { NULL }, 4847, "tcp" },
+ { "wfc", { NULL }, 4847, "udp" },
+ { "appserv-http", { NULL }, 4848, "tcp" },
+ { "appserv-http", { NULL }, 4848, "udp" },
+ { "appserv-https", { NULL }, 4849, "tcp" },
+ { "appserv-https", { NULL }, 4849, "udp" },
+ { "sun-as-nodeagt", { NULL }, 4850, "tcp" },
+ { "sun-as-nodeagt", { NULL }, 4850, "udp" },
+ { "derby-repli", { NULL }, 4851, "tcp" },
+ { "derby-repli", { NULL }, 4851, "udp" },
+ { "unify-debug", { NULL }, 4867, "tcp" },
+ { "unify-debug", { NULL }, 4867, "udp" },
+ { "phrelay", { NULL }, 4868, "tcp" },
+ { "phrelay", { NULL }, 4868, "udp" },
+ { "phrelaydbg", { NULL }, 4869, "tcp" },
+ { "phrelaydbg", { NULL }, 4869, "udp" },
+ { "cc-tracking", { NULL }, 4870, "tcp" },
+ { "cc-tracking", { NULL }, 4870, "udp" },
+ { "wired", { NULL }, 4871, "tcp" },
+ { "wired", { NULL }, 4871, "udp" },
+ { "tritium-can", { NULL }, 4876, "tcp" },
+ { "tritium-can", { NULL }, 4876, "udp" },
+ { "lmcs", { NULL }, 4877, "tcp" },
+ { "lmcs", { NULL }, 4877, "udp" },
+ { "inst-discovery", { NULL }, 4878, "udp" },
+ { "wsdl-event", { NULL }, 4879, "tcp" },
+ { "hislip", { NULL }, 4880, "tcp" },
+ { "socp-t", { NULL }, 4881, "udp" },
+ { "socp-c", { NULL }, 4882, "udp" },
+ { "wmlserver", { NULL }, 4883, "tcp" },
+ { "hivestor", { NULL }, 4884, "tcp" },
+ { "hivestor", { NULL }, 4884, "udp" },
+ { "abbs", { NULL }, 4885, "tcp" },
+ { "abbs", { NULL }, 4885, "udp" },
+ { "lyskom", { NULL }, 4894, "tcp" },
+ { "lyskom", { NULL }, 4894, "udp" },
+ { "radmin-port", { NULL }, 4899, "tcp" },
+ { "radmin-port", { NULL }, 4899, "udp" },
+ { "hfcs", { NULL }, 4900, "tcp" },
+ { "hfcs", { NULL }, 4900, "udp" },
+ { "flr_agent", { NULL }, 4901, "tcp" },
+ { "magiccontrol", { NULL }, 4902, "tcp" },
+ { "lutap", { NULL }, 4912, "tcp" },
+ { "lutcp", { NULL }, 4913, "tcp" },
+ { "bones", { NULL }, 4914, "tcp" },
+ { "bones", { NULL }, 4914, "udp" },
+ { "frcs", { NULL }, 4915, "tcp" },
+ { "atsc-mh-ssc", { NULL }, 4937, "udp" },
+ { "eq-office-4940", { NULL }, 4940, "tcp" },
+ { "eq-office-4940", { NULL }, 4940, "udp" },
+ { "eq-office-4941", { NULL }, 4941, "tcp" },
+ { "eq-office-4941", { NULL }, 4941, "udp" },
+ { "eq-office-4942", { NULL }, 4942, "tcp" },
+ { "eq-office-4942", { NULL }, 4942, "udp" },
+ { "munin", { NULL }, 4949, "tcp" },
+ { "munin", { NULL }, 4949, "udp" },
+ { "sybasesrvmon", { NULL }, 4950, "tcp" },
+ { "sybasesrvmon", { NULL }, 4950, "udp" },
+ { "pwgwims", { NULL }, 4951, "tcp" },
+ { "pwgwims", { NULL }, 4951, "udp" },
+ { "sagxtsds", { NULL }, 4952, "tcp" },
+ { "sagxtsds", { NULL }, 4952, "udp" },
+ { "dbsyncarbiter", { NULL }, 4953, "tcp" },
+ { "ccss-qmm", { NULL }, 4969, "tcp" },
+ { "ccss-qmm", { NULL }, 4969, "udp" },
+ { "ccss-qsm", { NULL }, 4970, "tcp" },
+ { "ccss-qsm", { NULL }, 4970, "udp" },
+ { "webyast", { NULL }, 4984, "tcp" },
+ { "gerhcs", { NULL }, 4985, "tcp" },
+ { "mrip", { NULL }, 4986, "tcp" },
+ { "mrip", { NULL }, 4986, "udp" },
+ { "smar-se-port1", { NULL }, 4987, "tcp" },
+ { "smar-se-port1", { NULL }, 4987, "udp" },
+ { "smar-se-port2", { NULL }, 4988, "tcp" },
+ { "smar-se-port2", { NULL }, 4988, "udp" },
+ { "parallel", { NULL }, 4989, "tcp" },
+ { "parallel", { NULL }, 4989, "udp" },
+ { "busycal", { NULL }, 4990, "tcp" },
+ { "busycal", { NULL }, 4990, "udp" },
+ { "vrt", { NULL }, 4991, "tcp" },
+ { "vrt", { NULL }, 4991, "udp" },
+ { "hfcs-manager", { NULL }, 4999, "tcp" },
+ { "hfcs-manager", { NULL }, 4999, "udp" },
+ { "commplex-main", { NULL }, 5000, "tcp" },
+ { "commplex-main", { NULL }, 5000, "udp" },
+ { "commplex-link", { NULL }, 5001, "tcp" },
+ { "commplex-link", { NULL }, 5001, "udp" },
+ { "rfe", { NULL }, 5002, "tcp" },
+ { "rfe", { NULL }, 5002, "udp" },
+ { "fmpro-internal", { NULL }, 5003, "tcp" },
+ { "fmpro-internal", { NULL }, 5003, "udp" },
+ { "avt-profile-1", { NULL }, 5004, "tcp" },
+ { "avt-profile-1", { NULL }, 5004, "udp" },
+ { "avt-profile-1", { NULL }, 5004, "dccp"},
+ { "avt-profile-2", { NULL }, 5005, "tcp" },
+ { "avt-profile-2", { NULL }, 5005, "udp" },
+ { "avt-profile-2", { NULL }, 5005, "dccp"},
+ { "wsm-server", { NULL }, 5006, "tcp" },
+ { "wsm-server", { NULL }, 5006, "udp" },
+ { "wsm-server-ssl", { NULL }, 5007, "tcp" },
+ { "wsm-server-ssl", { NULL }, 5007, "udp" },
+ { "synapsis-edge", { NULL }, 5008, "tcp" },
+ { "synapsis-edge", { NULL }, 5008, "udp" },
+ { "winfs", { NULL }, 5009, "tcp" },
+ { "winfs", { NULL }, 5009, "udp" },
+ { "telelpathstart", { NULL }, 5010, "tcp" },
+ { "telelpathstart", { NULL }, 5010, "udp" },
+ { "telelpathattack", { NULL }, 5011, "tcp" },
+ { "telelpathattack", { NULL }, 5011, "udp" },
+ { "nsp", { NULL }, 5012, "tcp" },
+ { "nsp", { NULL }, 5012, "udp" },
+ { "fmpro-v6", { NULL }, 5013, "tcp" },
+ { "fmpro-v6", { NULL }, 5013, "udp" },
+ { "onpsocket", { NULL }, 5014, "udp" },
+ { "fmwp", { NULL }, 5015, "tcp" },
+ { "zenginkyo-1", { NULL }, 5020, "tcp" },
+ { "zenginkyo-1", { NULL }, 5020, "udp" },
+ { "zenginkyo-2", { NULL }, 5021, "tcp" },
+ { "zenginkyo-2", { NULL }, 5021, "udp" },
+ { "mice", { NULL }, 5022, "tcp" },
+ { "mice", { NULL }, 5022, "udp" },
+ { "htuilsrv", { NULL }, 5023, "tcp" },
+ { "htuilsrv", { NULL }, 5023, "udp" },
+ { "scpi-telnet", { NULL }, 5024, "tcp" },
+ { "scpi-telnet", { NULL }, 5024, "udp" },
+ { "scpi-raw", { NULL }, 5025, "tcp" },
+ { "scpi-raw", { NULL }, 5025, "udp" },
+ { "strexec-d", { NULL }, 5026, "tcp" },
+ { "strexec-d", { NULL }, 5026, "udp" },
+ { "strexec-s", { NULL }, 5027, "tcp" },
+ { "strexec-s", { NULL }, 5027, "udp" },
+ { "qvr", { NULL }, 5028, "tcp" },
+ { "infobright", { NULL }, 5029, "tcp" },
+ { "infobright", { NULL }, 5029, "udp" },
+ { "surfpass", { NULL }, 5030, "tcp" },
+ { "surfpass", { NULL }, 5030, "udp" },
+ { "dmp", { NULL }, 5031, "udp" },
+ { "asnaacceler8db", { NULL }, 5042, "tcp" },
+ { "asnaacceler8db", { NULL }, 5042, "udp" },
+ { "swxadmin", { NULL }, 5043, "tcp" },
+ { "swxadmin", { NULL }, 5043, "udp" },
+ { "lxi-evntsvc", { NULL }, 5044, "tcp" },
+ { "lxi-evntsvc", { NULL }, 5044, "udp" },
+ { "osp", { NULL }, 5045, "tcp" },
+ { "vpm-udp", { NULL }, 5046, "udp" },
+ { "iscape", { NULL }, 5047, "udp" },
+ { "texai", { NULL }, 5048, "tcp" },
+ { "ivocalize", { NULL }, 5049, "tcp" },
+ { "ivocalize", { NULL }, 5049, "udp" },
+ { "mmcc", { NULL }, 5050, "tcp" },
+ { "mmcc", { NULL }, 5050, "udp" },
+ { "ita-agent", { NULL }, 5051, "tcp" },
+ { "ita-agent", { NULL }, 5051, "udp" },
+ { "ita-manager", { NULL }, 5052, "tcp" },
+ { "ita-manager", { NULL }, 5052, "udp" },
+ { "rlm", { NULL }, 5053, "tcp" },
+ { "rlm-admin", { NULL }, 5054, "tcp" },
+ { "unot", { NULL }, 5055, "tcp" },
+ { "unot", { NULL }, 5055, "udp" },
+ { "intecom-ps1", { NULL }, 5056, "tcp" },
+ { "intecom-ps1", { NULL }, 5056, "udp" },
+ { "intecom-ps2", { NULL }, 5057, "tcp" },
+ { "intecom-ps2", { NULL }, 5057, "udp" },
+ { "locus-disc", { NULL }, 5058, "udp" },
+ { "sds", { NULL }, 5059, "tcp" },
+ { "sds", { NULL }, 5059, "udp" },
+ { "sip", { NULL }, 5060, "tcp" },
+ { "sip", { NULL }, 5060, "udp" },
+ { "sip-tls", { NULL }, 5061, "tcp" },
+ { "sip-tls", { NULL }, 5061, "udp" },
+ { "na-localise", { NULL }, 5062, "tcp" },
+ { "na-localise", { NULL }, 5062, "udp" },
+ { "csrpc", { NULL }, 5063, "tcp" },
+ { "ca-1", { NULL }, 5064, "tcp" },
+ { "ca-1", { NULL }, 5064, "udp" },
+ { "ca-2", { NULL }, 5065, "tcp" },
+ { "ca-2", { NULL }, 5065, "udp" },
+ { "stanag-5066", { NULL }, 5066, "tcp" },
+ { "stanag-5066", { NULL }, 5066, "udp" },
+ { "authentx", { NULL }, 5067, "tcp" },
+ { "authentx", { NULL }, 5067, "udp" },
+ { "bitforestsrv", { NULL }, 5068, "tcp" },
+ { "i-net-2000-npr", { NULL }, 5069, "tcp" },
+ { "i-net-2000-npr", { NULL }, 5069, "udp" },
+ { "vtsas", { NULL }, 5070, "tcp" },
+ { "vtsas", { NULL }, 5070, "udp" },
+ { "powerschool", { NULL }, 5071, "tcp" },
+ { "powerschool", { NULL }, 5071, "udp" },
+ { "ayiya", { NULL }, 5072, "tcp" },
+ { "ayiya", { NULL }, 5072, "udp" },
+ { "tag-pm", { NULL }, 5073, "tcp" },
+ { "tag-pm", { NULL }, 5073, "udp" },
+ { "alesquery", { NULL }, 5074, "tcp" },
+ { "alesquery", { NULL }, 5074, "udp" },
+ { "cp-spxrpts", { NULL }, 5079, "udp" },
+ { "onscreen", { NULL }, 5080, "tcp" },
+ { "onscreen", { NULL }, 5080, "udp" },
+ { "sdl-ets", { NULL }, 5081, "tcp" },
+ { "sdl-ets", { NULL }, 5081, "udp" },
+ { "qcp", { NULL }, 5082, "tcp" },
+ { "qcp", { NULL }, 5082, "udp" },
+ { "qfp", { NULL }, 5083, "tcp" },
+ { "qfp", { NULL }, 5083, "udp" },
+ { "llrp", { NULL }, 5084, "tcp" },
+ { "llrp", { NULL }, 5084, "udp" },
+ { "encrypted-llrp", { NULL }, 5085, "tcp" },
+ { "encrypted-llrp", { NULL }, 5085, "udp" },
+ { "aprigo-cs", { NULL }, 5086, "tcp" },
+ { "car", { NULL }, 5090, "sctp"},
+ { "cxtp", { NULL }, 5091, "sctp"},
+ { "magpie", { NULL }, 5092, "udp" },
+ { "sentinel-lm", { NULL }, 5093, "tcp" },
+ { "sentinel-lm", { NULL }, 5093, "udp" },
+ { "hart-ip", { NULL }, 5094, "tcp" },
+ { "hart-ip", { NULL }, 5094, "udp" },
+ { "sentlm-srv2srv", { NULL }, 5099, "tcp" },
+ { "sentlm-srv2srv", { NULL }, 5099, "udp" },
+ { "socalia", { NULL }, 5100, "tcp" },
+ { "socalia", { NULL }, 5100, "udp" },
+ { "talarian-tcp", { NULL }, 5101, "tcp" },
+ { "talarian-udp", { NULL }, 5101, "udp" },
+ { "oms-nonsecure", { NULL }, 5102, "tcp" },
+ { "oms-nonsecure", { NULL }, 5102, "udp" },
+ { "actifio-c2c", { NULL }, 5103, "tcp" },
+ { "tinymessage", { NULL }, 5104, "udp" },
+ { "hughes-ap", { NULL }, 5105, "udp" },
+ { "taep-as-svc", { NULL }, 5111, "tcp" },
+ { "taep-as-svc", { NULL }, 5111, "udp" },
+ { "pm-cmdsvr", { NULL }, 5112, "tcp" },
+ { "pm-cmdsvr", { NULL }, 5112, "udp" },
+ { "ev-services", { NULL }, 5114, "tcp" },
+ { "autobuild", { NULL }, 5115, "tcp" },
+ { "emb-proj-cmd", { NULL }, 5116, "udp" },
+ { "gradecam", { NULL }, 5117, "tcp" },
+ { "nbt-pc", { NULL }, 5133, "tcp" },
+ { "nbt-pc", { NULL }, 5133, "udp" },
+ { "ppactivation", { NULL }, 5134, "tcp" },
+ { "erp-scale", { NULL }, 5135, "tcp" },
+ { "minotaur-sa", { NULL }, 5136, "udp" },
+ { "ctsd", { NULL }, 5137, "tcp" },
+ { "ctsd", { NULL }, 5137, "udp" },
+ { "rmonitor_secure", { NULL }, 5145, "tcp" },
+ { "rmonitor_secure", { NULL }, 5145, "udp" },
+ { "social-alarm", { NULL }, 5146, "tcp" },
+ { "atmp", { NULL }, 5150, "tcp" },
+ { "atmp", { NULL }, 5150, "udp" },
+ { "esri_sde", { NULL }, 5151, "tcp" },
+ { "esri_sde", { NULL }, 5151, "udp" },
+ { "sde-discovery", { NULL }, 5152, "tcp" },
+ { "sde-discovery", { NULL }, 5152, "udp" },
+ { "toruxserver", { NULL }, 5153, "tcp" },
+ { "bzflag", { NULL }, 5154, "tcp" },
+ { "bzflag", { NULL }, 5154, "udp" },
+ { "asctrl-agent", { NULL }, 5155, "tcp" },
+ { "asctrl-agent", { NULL }, 5155, "udp" },
+ { "rugameonline", { NULL }, 5156, "tcp" },
+ { "mediat", { NULL }, 5157, "tcp" },
+ { "snmpssh", { NULL }, 5161, "tcp" },
+ { "snmpssh-trap", { NULL }, 5162, "tcp" },
+ { "sbackup", { NULL }, 5163, "tcp" },
+ { "vpa", { NULL }, 5164, "tcp" },
+ { "vpa-disc", { NULL }, 5164, "udp" },
+ { "ife_icorp", { NULL }, 5165, "tcp" },
+ { "ife_icorp", { NULL }, 5165, "udp" },
+ { "winpcs", { NULL }, 5166, "tcp" },
+ { "winpcs", { NULL }, 5166, "udp" },
+ { "scte104", { NULL }, 5167, "tcp" },
+ { "scte104", { NULL }, 5167, "udp" },
+ { "scte30", { NULL }, 5168, "tcp" },
+ { "scte30", { NULL }, 5168, "udp" },
+ { "aol", { NULL }, 5190, "tcp" },
+ { "aol", { NULL }, 5190, "udp" },
+ { "aol-1", { NULL }, 5191, "tcp" },
+ { "aol-1", { NULL }, 5191, "udp" },
+ { "aol-2", { NULL }, 5192, "tcp" },
+ { "aol-2", { NULL }, 5192, "udp" },
+ { "aol-3", { NULL }, 5193, "tcp" },
+ { "aol-3", { NULL }, 5193, "udp" },
+ { "cpscomm", { NULL }, 5194, "tcp" },
+ { "targus-getdata", { NULL }, 5200, "tcp" },
+ { "targus-getdata", { NULL }, 5200, "udp" },
+ { "targus-getdata1", { NULL }, 5201, "tcp" },
+ { "targus-getdata1", { NULL }, 5201, "udp" },
+ { "targus-getdata2", { NULL }, 5202, "tcp" },
+ { "targus-getdata2", { NULL }, 5202, "udp" },
+ { "targus-getdata3", { NULL }, 5203, "tcp" },
+ { "targus-getdata3", { NULL }, 5203, "udp" },
+ { "3exmp", { NULL }, 5221, "tcp" },
+ { "xmpp-client", { NULL }, 5222, "tcp" },
+ { "hpvirtgrp", { NULL }, 5223, "tcp" },
+ { "hpvirtgrp", { NULL }, 5223, "udp" },
+ { "hpvirtctrl", { NULL }, 5224, "tcp" },
+ { "hpvirtctrl", { NULL }, 5224, "udp" },
+ { "hp-server", { NULL }, 5225, "tcp" },
+ { "hp-server", { NULL }, 5225, "udp" },
+ { "hp-status", { NULL }, 5226, "tcp" },
+ { "hp-status", { NULL }, 5226, "udp" },
+ { "perfd", { NULL }, 5227, "tcp" },
+ { "perfd", { NULL }, 5227, "udp" },
+ { "hpvroom", { NULL }, 5228, "tcp" },
+ { "csedaemon", { NULL }, 5232, "tcp" },
+ { "enfs", { NULL }, 5233, "tcp" },
+ { "eenet", { NULL }, 5234, "tcp" },
+ { "eenet", { NULL }, 5234, "udp" },
+ { "galaxy-network", { NULL }, 5235, "tcp" },
+ { "galaxy-network", { NULL }, 5235, "udp" },
+ { "padl2sim", { NULL }, 5236, "tcp" },
+ { "padl2sim", { NULL }, 5236, "udp" },
+ { "mnet-discovery", { NULL }, 5237, "tcp" },
+ { "mnet-discovery", { NULL }, 5237, "udp" },
+ { "downtools", { NULL }, 5245, "tcp" },
+ { "downtools-disc", { NULL }, 5245, "udp" },
+ { "capwap-control", { NULL }, 5246, "udp" },
+ { "capwap-data", { NULL }, 5247, "udp" },
+ { "caacws", { NULL }, 5248, "tcp" },
+ { "caacws", { NULL }, 5248, "udp" },
+ { "caaclang2", { NULL }, 5249, "tcp" },
+ { "caaclang2", { NULL }, 5249, "udp" },
+ { "soagateway", { NULL }, 5250, "tcp" },
+ { "soagateway", { NULL }, 5250, "udp" },
+ { "caevms", { NULL }, 5251, "tcp" },
+ { "caevms", { NULL }, 5251, "udp" },
+ { "movaz-ssc", { NULL }, 5252, "tcp" },
+ { "movaz-ssc", { NULL }, 5252, "udp" },
+ { "kpdp", { NULL }, 5253, "tcp" },
+ { "3com-njack-1", { NULL }, 5264, "tcp" },
+ { "3com-njack-1", { NULL }, 5264, "udp" },
+ { "3com-njack-2", { NULL }, 5265, "tcp" },
+ { "3com-njack-2", { NULL }, 5265, "udp" },
+ { "xmpp-server", { NULL }, 5269, "tcp" },
+ { "xmp", { NULL }, 5270, "tcp" },
+ { "xmp", { NULL }, 5270, "udp" },
+ { "cuelink", { NULL }, 5271, "tcp" },
+ { "cuelink-disc", { NULL }, 5271, "udp" },
+ { "pk", { NULL }, 5272, "tcp" },
+ { "pk", { NULL }, 5272, "udp" },
+ { "xmpp-bosh", { NULL }, 5280, "tcp" },
+ { "undo-lm", { NULL }, 5281, "tcp" },
+ { "transmit-port", { NULL }, 5282, "tcp" },
+ { "transmit-port", { NULL }, 5282, "udp" },
+ { "presence", { NULL }, 5298, "tcp" },
+ { "presence", { NULL }, 5298, "udp" },
+ { "nlg-data", { NULL }, 5299, "tcp" },
+ { "nlg-data", { NULL }, 5299, "udp" },
+ { "hacl-hb", { NULL }, 5300, "tcp" },
+ { "hacl-hb", { NULL }, 5300, "udp" },
+ { "hacl-gs", { NULL }, 5301, "tcp" },
+ { "hacl-gs", { NULL }, 5301, "udp" },
+ { "hacl-cfg", { NULL }, 5302, "tcp" },
+ { "hacl-cfg", { NULL }, 5302, "udp" },
+ { "hacl-probe", { NULL }, 5303, "tcp" },
+ { "hacl-probe", { NULL }, 5303, "udp" },
+ { "hacl-local", { NULL }, 5304, "tcp" },
+ { "hacl-local", { NULL }, 5304, "udp" },
+ { "hacl-test", { NULL }, 5305, "tcp" },
+ { "hacl-test", { NULL }, 5305, "udp" },
+ { "sun-mc-grp", { NULL }, 5306, "tcp" },
+ { "sun-mc-grp", { NULL }, 5306, "udp" },
+ { "sco-aip", { NULL }, 5307, "tcp" },
+ { "sco-aip", { NULL }, 5307, "udp" },
+ { "cfengine", { NULL }, 5308, "tcp" },
+ { "cfengine", { NULL }, 5308, "udp" },
+ { "jprinter", { NULL }, 5309, "tcp" },
+ { "jprinter", { NULL }, 5309, "udp" },
+ { "outlaws", { NULL }, 5310, "tcp" },
+ { "outlaws", { NULL }, 5310, "udp" },
+ { "permabit-cs", { NULL }, 5312, "tcp" },
+ { "permabit-cs", { NULL }, 5312, "udp" },
+ { "rrdp", { NULL }, 5313, "tcp" },
+ { "rrdp", { NULL }, 5313, "udp" },
+ { "opalis-rbt-ipc", { NULL }, 5314, "tcp" },
+ { "opalis-rbt-ipc", { NULL }, 5314, "udp" },
+ { "hacl-poll", { NULL }, 5315, "tcp" },
+ { "hacl-poll", { NULL }, 5315, "udp" },
+ { "hpdevms", { NULL }, 5316, "tcp" },
+ { "hpdevms", { NULL }, 5316, "udp" },
+ { "bsfserver-zn", { NULL }, 5320, "tcp" },
+ { "bsfsvr-zn-ssl", { NULL }, 5321, "tcp" },
+ { "kfserver", { NULL }, 5343, "tcp" },
+ { "kfserver", { NULL }, 5343, "udp" },
+ { "xkotodrcp", { NULL }, 5344, "tcp" },
+ { "xkotodrcp", { NULL }, 5344, "udp" },
+ { "stuns", { NULL }, 5349, "tcp" },
+ { "stuns", { NULL }, 5349, "udp" },
+ { "turns", { NULL }, 5349, "tcp" },
+ { "turns", { NULL }, 5349, "udp" },
+ { "stun-behaviors", { NULL }, 5349, "tcp" },
+ { "stun-behaviors", { NULL }, 5349, "udp" },
+ { "nat-pmp-status", { NULL }, 5350, "tcp" },
+ { "nat-pmp-status", { NULL }, 5350, "udp" },
+ { "nat-pmp", { NULL }, 5351, "tcp" },
+ { "nat-pmp", { NULL }, 5351, "udp" },
+ { "dns-llq", { NULL }, 5352, "tcp" },
+ { "dns-llq", { NULL }, 5352, "udp" },
+ { "mdns", { NULL }, 5353, "tcp" },
+ { "mdns", { NULL }, 5353, "udp" },
+ { "mdnsresponder", { NULL }, 5354, "tcp" },
+ { "mdnsresponder", { NULL }, 5354, "udp" },
+ { "llmnr", { NULL }, 5355, "tcp" },
+ { "llmnr", { NULL }, 5355, "udp" },
+ { "ms-smlbiz", { NULL }, 5356, "tcp" },
+ { "ms-smlbiz", { NULL }, 5356, "udp" },
+ { "wsdapi", { NULL }, 5357, "tcp" },
+ { "wsdapi", { NULL }, 5357, "udp" },
+ { "wsdapi-s", { NULL }, 5358, "tcp" },
+ { "wsdapi-s", { NULL }, 5358, "udp" },
+ { "ms-alerter", { NULL }, 5359, "tcp" },
+ { "ms-alerter", { NULL }, 5359, "udp" },
+ { "ms-sideshow", { NULL }, 5360, "tcp" },
+ { "ms-sideshow", { NULL }, 5360, "udp" },
+ { "ms-s-sideshow", { NULL }, 5361, "tcp" },
+ { "ms-s-sideshow", { NULL }, 5361, "udp" },
+ { "serverwsd2", { NULL }, 5362, "tcp" },
+ { "serverwsd2", { NULL }, 5362, "udp" },
+ { "net-projection", { NULL }, 5363, "tcp" },
+ { "net-projection", { NULL }, 5363, "udp" },
+ { "stresstester", { NULL }, 5397, "tcp" },
+ { "stresstester", { NULL }, 5397, "udp" },
+ { "elektron-admin", { NULL }, 5398, "tcp" },
+ { "elektron-admin", { NULL }, 5398, "udp" },
+ { "securitychase", { NULL }, 5399, "tcp" },
+ { "securitychase", { NULL }, 5399, "udp" },
+ { "excerpt", { NULL }, 5400, "tcp" },
+ { "excerpt", { NULL }, 5400, "udp" },
+ { "excerpts", { NULL }, 5401, "tcp" },
+ { "excerpts", { NULL }, 5401, "udp" },
+ { "mftp", { NULL }, 5402, "tcp" },
+ { "mftp", { NULL }, 5402, "udp" },
+ { "hpoms-ci-lstn", { NULL }, 5403, "tcp" },
+ { "hpoms-ci-lstn", { NULL }, 5403, "udp" },
+ { "hpoms-dps-lstn", { NULL }, 5404, "tcp" },
+ { "hpoms-dps-lstn", { NULL }, 5404, "udp" },
+ { "netsupport", { NULL }, 5405, "tcp" },
+ { "netsupport", { NULL }, 5405, "udp" },
+ { "systemics-sox", { NULL }, 5406, "tcp" },
+ { "systemics-sox", { NULL }, 5406, "udp" },
+ { "foresyte-clear", { NULL }, 5407, "tcp" },
+ { "foresyte-clear", { NULL }, 5407, "udp" },
+ { "foresyte-sec", { NULL }, 5408, "tcp" },
+ { "foresyte-sec", { NULL }, 5408, "udp" },
+ { "salient-dtasrv", { NULL }, 5409, "tcp" },
+ { "salient-dtasrv", { NULL }, 5409, "udp" },
+ { "salient-usrmgr", { NULL }, 5410, "tcp" },
+ { "salient-usrmgr", { NULL }, 5410, "udp" },
+ { "actnet", { NULL }, 5411, "tcp" },
+ { "actnet", { NULL }, 5411, "udp" },
+ { "continuus", { NULL }, 5412, "tcp" },
+ { "continuus", { NULL }, 5412, "udp" },
+ { "wwiotalk", { NULL }, 5413, "tcp" },
+ { "wwiotalk", { NULL }, 5413, "udp" },
+ { "statusd", { NULL }, 5414, "tcp" },
+ { "statusd", { NULL }, 5414, "udp" },
+ { "ns-server", { NULL }, 5415, "tcp" },
+ { "ns-server", { NULL }, 5415, "udp" },
+ { "sns-gateway", { NULL }, 5416, "tcp" },
+ { "sns-gateway", { NULL }, 5416, "udp" },
+ { "sns-agent", { NULL }, 5417, "tcp" },
+ { "sns-agent", { NULL }, 5417, "udp" },
+ { "mcntp", { NULL }, 5418, "tcp" },
+ { "mcntp", { NULL }, 5418, "udp" },
+ { "dj-ice", { NULL }, 5419, "tcp" },
+ { "dj-ice", { NULL }, 5419, "udp" },
+ { "cylink-c", { NULL }, 5420, "tcp" },
+ { "cylink-c", { NULL }, 5420, "udp" },
+ { "netsupport2", { NULL }, 5421, "tcp" },
+ { "netsupport2", { NULL }, 5421, "udp" },
+ { "salient-mux", { NULL }, 5422, "tcp" },
+ { "salient-mux", { NULL }, 5422, "udp" },
+ { "virtualuser", { NULL }, 5423, "tcp" },
+ { "virtualuser", { NULL }, 5423, "udp" },
+ { "beyond-remote", { NULL }, 5424, "tcp" },
+ { "beyond-remote", { NULL }, 5424, "udp" },
+ { "br-channel", { NULL }, 5425, "tcp" },
+ { "br-channel", { NULL }, 5425, "udp" },
+ { "devbasic", { NULL }, 5426, "tcp" },
+ { "devbasic", { NULL }, 5426, "udp" },
+ { "sco-peer-tta", { NULL }, 5427, "tcp" },
+ { "sco-peer-tta", { NULL }, 5427, "udp" },
+ { "telaconsole", { NULL }, 5428, "tcp" },
+ { "telaconsole", { NULL }, 5428, "udp" },
+ { "base", { NULL }, 5429, "tcp" },
+ { "base", { NULL }, 5429, "udp" },
+ { "radec-corp", { NULL }, 5430, "tcp" },
+ { "radec-corp", { NULL }, 5430, "udp" },
+ { "park-agent", { NULL }, 5431, "tcp" },
+ { "park-agent", { NULL }, 5431, "udp" },
+ { "postgresql", { NULL }, 5432, "tcp" },
+ { "postgresql", { NULL }, 5432, "udp" },
+ { "pyrrho", { NULL }, 5433, "tcp" },
+ { "pyrrho", { NULL }, 5433, "udp" },
+ { "sgi-arrayd", { NULL }, 5434, "tcp" },
+ { "sgi-arrayd", { NULL }, 5434, "udp" },
+ { "sceanics", { NULL }, 5435, "tcp" },
+ { "sceanics", { NULL }, 5435, "udp" },
+ { "pmip6-cntl", { NULL }, 5436, "udp" },
+ { "pmip6-data", { NULL }, 5437, "udp" },
+ { "spss", { NULL }, 5443, "tcp" },
+ { "spss", { NULL }, 5443, "udp" },
+ { "surebox", { NULL }, 5453, "tcp" },
+ { "surebox", { NULL }, 5453, "udp" },
+ { "apc-5454", { NULL }, 5454, "tcp" },
+ { "apc-5454", { NULL }, 5454, "udp" },
+ { "apc-5455", { NULL }, 5455, "tcp" },
+ { "apc-5455", { NULL }, 5455, "udp" },
+ { "apc-5456", { NULL }, 5456, "tcp" },
+ { "apc-5456", { NULL }, 5456, "udp" },
+ { "silkmeter", { NULL }, 5461, "tcp" },
+ { "silkmeter", { NULL }, 5461, "udp" },
+ { "ttl-publisher", { NULL }, 5462, "tcp" },
+ { "ttl-publisher", { NULL }, 5462, "udp" },
+ { "ttlpriceproxy", { NULL }, 5463, "tcp" },
+ { "ttlpriceproxy", { NULL }, 5463, "udp" },
+ { "quailnet", { NULL }, 5464, "tcp" },
+ { "quailnet", { NULL }, 5464, "udp" },
+ { "netops-broker", { NULL }, 5465, "tcp" },
+ { "netops-broker", { NULL }, 5465, "udp" },
+ { "fcp-addr-srvr1", { NULL }, 5500, "tcp" },
+ { "fcp-addr-srvr1", { NULL }, 5500, "udp" },
+ { "fcp-addr-srvr2", { NULL }, 5501, "tcp" },
+ { "fcp-addr-srvr2", { NULL }, 5501, "udp" },
+ { "fcp-srvr-inst1", { NULL }, 5502, "tcp" },
+ { "fcp-srvr-inst1", { NULL }, 5502, "udp" },
+ { "fcp-srvr-inst2", { NULL }, 5503, "tcp" },
+ { "fcp-srvr-inst2", { NULL }, 5503, "udp" },
+ { "fcp-cics-gw1", { NULL }, 5504, "tcp" },
+ { "fcp-cics-gw1", { NULL }, 5504, "udp" },
+ { "checkoutdb", { NULL }, 5505, "tcp" },
+ { "checkoutdb", { NULL }, 5505, "udp" },
+ { "amc", { NULL }, 5506, "tcp" },
+ { "amc", { NULL }, 5506, "udp" },
+ { "sgi-eventmond", { NULL }, 5553, "tcp" },
+ { "sgi-eventmond", { NULL }, 5553, "udp" },
+ { "sgi-esphttp", { NULL }, 5554, "tcp" },
+ { "sgi-esphttp", { NULL }, 5554, "udp" },
+ { "personal-agent", { NULL }, 5555, "tcp" },
+ { "personal-agent", { NULL }, 5555, "udp" },
+ { "freeciv", { NULL }, 5556, "tcp" },
+ { "freeciv", { NULL }, 5556, "udp" },
+ { "farenet", { NULL }, 5557, "tcp" },
+ { "westec-connect", { NULL }, 5566, "tcp" },
+ { "m-oap", { NULL }, 5567, "tcp" },
+ { "m-oap", { NULL }, 5567, "udp" },
+ { "sdt", { NULL }, 5568, "tcp" },
+ { "sdt", { NULL }, 5568, "udp" },
+ { "sdmmp", { NULL }, 5573, "tcp" },
+ { "sdmmp", { NULL }, 5573, "udp" },
+ { "lsi-bobcat", { NULL }, 5574, "tcp" },
+ { "ora-oap", { NULL }, 5575, "tcp" },
+ { "fdtracks", { NULL }, 5579, "tcp" },
+ { "tmosms0", { NULL }, 5580, "tcp" },
+ { "tmosms0", { NULL }, 5580, "udp" },
+ { "tmosms1", { NULL }, 5581, "tcp" },
+ { "tmosms1", { NULL }, 5581, "udp" },
+ { "fac-restore", { NULL }, 5582, "tcp" },
+ { "fac-restore", { NULL }, 5582, "udp" },
+ { "tmo-icon-sync", { NULL }, 5583, "tcp" },
+ { "tmo-icon-sync", { NULL }, 5583, "udp" },
+ { "bis-web", { NULL }, 5584, "tcp" },
+ { "bis-web", { NULL }, 5584, "udp" },
+ { "bis-sync", { NULL }, 5585, "tcp" },
+ { "bis-sync", { NULL }, 5585, "udp" },
+ { "ininmessaging", { NULL }, 5597, "tcp" },
+ { "ininmessaging", { NULL }, 5597, "udp" },
+ { "mctfeed", { NULL }, 5598, "tcp" },
+ { "mctfeed", { NULL }, 5598, "udp" },
+ { "esinstall", { NULL }, 5599, "tcp" },
+ { "esinstall", { NULL }, 5599, "udp" },
+ { "esmmanager", { NULL }, 5600, "tcp" },
+ { "esmmanager", { NULL }, 5600, "udp" },
+ { "esmagent", { NULL }, 5601, "tcp" },
+ { "esmagent", { NULL }, 5601, "udp" },
+ { "a1-msc", { NULL }, 5602, "tcp" },
+ { "a1-msc", { NULL }, 5602, "udp" },
+ { "a1-bs", { NULL }, 5603, "tcp" },
+ { "a1-bs", { NULL }, 5603, "udp" },
+ { "a3-sdunode", { NULL }, 5604, "tcp" },
+ { "a3-sdunode", { NULL }, 5604, "udp" },
+ { "a4-sdunode", { NULL }, 5605, "tcp" },
+ { "a4-sdunode", { NULL }, 5605, "udp" },
+ { "ninaf", { NULL }, 5627, "tcp" },
+ { "ninaf", { NULL }, 5627, "udp" },
+ { "htrust", { NULL }, 5628, "tcp" },
+ { "htrust", { NULL }, 5628, "udp" },
+ { "symantec-sfdb", { NULL }, 5629, "tcp" },
+ { "symantec-sfdb", { NULL }, 5629, "udp" },
+ { "precise-comm", { NULL }, 5630, "tcp" },
+ { "precise-comm", { NULL }, 5630, "udp" },
+ { "pcanywheredata", { NULL }, 5631, "tcp" },
+ { "pcanywheredata", { NULL }, 5631, "udp" },
+ { "pcanywherestat", { NULL }, 5632, "tcp" },
+ { "pcanywherestat", { NULL }, 5632, "udp" },
+ { "beorl", { NULL }, 5633, "tcp" },
+ { "beorl", { NULL }, 5633, "udp" },
+ { "xprtld", { NULL }, 5634, "tcp" },
+ { "xprtld", { NULL }, 5634, "udp" },
+ { "sfmsso", { NULL }, 5635, "tcp" },
+ { "sfm-db-server", { NULL }, 5636, "tcp" },
+ { "cssc", { NULL }, 5637, "tcp" },
+ { "amqps", { NULL }, 5671, "tcp" },
+ { "amqps", { NULL }, 5671, "udp" },
+ { "amqp", { NULL }, 5672, "tcp" },
+ { "amqp", { NULL }, 5672, "udp" },
+ { "amqp", { NULL }, 5672, "sctp"},
+ { "jms", { NULL }, 5673, "tcp" },
+ { "jms", { NULL }, 5673, "udp" },
+ { "hyperscsi-port", { NULL }, 5674, "tcp" },
+ { "hyperscsi-port", { NULL }, 5674, "udp" },
+ { "v5ua", { NULL }, 5675, "tcp" },
+ { "v5ua", { NULL }, 5675, "udp" },
+ { "v5ua", { NULL }, 5675, "sctp"},
+ { "raadmin", { NULL }, 5676, "tcp" },
+ { "raadmin", { NULL }, 5676, "udp" },
+ { "questdb2-lnchr", { NULL }, 5677, "tcp" },
+ { "questdb2-lnchr", { NULL }, 5677, "udp" },
+ { "rrac", { NULL }, 5678, "tcp" },
+ { "rrac", { NULL }, 5678, "udp" },
+ { "dccm", { NULL }, 5679, "tcp" },
+ { "dccm", { NULL }, 5679, "udp" },
+ { "auriga-router", { NULL }, 5680, "tcp" },
+ { "auriga-router", { NULL }, 5680, "udp" },
+ { "ncxcp", { NULL }, 5681, "tcp" },
+ { "ncxcp", { NULL }, 5681, "udp" },
+ { "brightcore", { NULL }, 5682, "udp" },
+ { "ggz", { NULL }, 5688, "tcp" },
+ { "ggz", { NULL }, 5688, "udp" },
+ { "qmvideo", { NULL }, 5689, "tcp" },
+ { "qmvideo", { NULL }, 5689, "udp" },
+ { "proshareaudio", { NULL }, 5713, "tcp" },
+ { "proshareaudio", { NULL }, 5713, "udp" },
+ { "prosharevideo", { NULL }, 5714, "tcp" },
+ { "prosharevideo", { NULL }, 5714, "udp" },
+ { "prosharedata", { NULL }, 5715, "tcp" },
+ { "prosharedata", { NULL }, 5715, "udp" },
+ { "prosharerequest", { NULL }, 5716, "tcp" },
+ { "prosharerequest", { NULL }, 5716, "udp" },
+ { "prosharenotify", { NULL }, 5717, "tcp" },
+ { "prosharenotify", { NULL }, 5717, "udp" },
+ { "dpm", { NULL }, 5718, "tcp" },
+ { "dpm", { NULL }, 5718, "udp" },
+ { "dpm-agent", { NULL }, 5719, "tcp" },
+ { "dpm-agent", { NULL }, 5719, "udp" },
+ { "ms-licensing", { NULL }, 5720, "tcp" },
+ { "ms-licensing", { NULL }, 5720, "udp" },
+ { "dtpt", { NULL }, 5721, "tcp" },
+ { "dtpt", { NULL }, 5721, "udp" },
+ { "msdfsr", { NULL }, 5722, "tcp" },
+ { "msdfsr", { NULL }, 5722, "udp" },
+ { "omhs", { NULL }, 5723, "tcp" },
+ { "omhs", { NULL }, 5723, "udp" },
+ { "omsdk", { NULL }, 5724, "tcp" },
+ { "omsdk", { NULL }, 5724, "udp" },
+ { "ms-ilm", { NULL }, 5725, "tcp" },
+ { "ms-ilm-sts", { NULL }, 5726, "tcp" },
+ { "asgenf", { NULL }, 5727, "tcp" },
+ { "io-dist-data", { NULL }, 5728, "tcp" },
+ { "io-dist-group", { NULL }, 5728, "udp" },
+ { "openmail", { NULL }, 5729, "tcp" },
+ { "openmail", { NULL }, 5729, "udp" },
+ { "unieng", { NULL }, 5730, "tcp" },
+ { "unieng", { NULL }, 5730, "udp" },
+ { "ida-discover1", { NULL }, 5741, "tcp" },
+ { "ida-discover1", { NULL }, 5741, "udp" },
+ { "ida-discover2", { NULL }, 5742, "tcp" },
+ { "ida-discover2", { NULL }, 5742, "udp" },
+ { "watchdoc-pod", { NULL }, 5743, "tcp" },
+ { "watchdoc-pod", { NULL }, 5743, "udp" },
+ { "watchdoc", { NULL }, 5744, "tcp" },
+ { "watchdoc", { NULL }, 5744, "udp" },
+ { "fcopy-server", { NULL }, 5745, "tcp" },
+ { "fcopy-server", { NULL }, 5745, "udp" },
+ { "fcopys-server", { NULL }, 5746, "tcp" },
+ { "fcopys-server", { NULL }, 5746, "udp" },
+ { "tunatic", { NULL }, 5747, "tcp" },
+ { "tunatic", { NULL }, 5747, "udp" },
+ { "tunalyzer", { NULL }, 5748, "tcp" },
+ { "tunalyzer", { NULL }, 5748, "udp" },
+ { "rscd", { NULL }, 5750, "tcp" },
+ { "rscd", { NULL }, 5750, "udp" },
+ { "openmailg", { NULL }, 5755, "tcp" },
+ { "openmailg", { NULL }, 5755, "udp" },
+ { "x500ms", { NULL }, 5757, "tcp" },
+ { "x500ms", { NULL }, 5757, "udp" },
+ { "openmailns", { NULL }, 5766, "tcp" },
+ { "openmailns", { NULL }, 5766, "udp" },
+ { "s-openmail", { NULL }, 5767, "tcp" },
+ { "s-openmail", { NULL }, 5767, "udp" },
+ { "openmailpxy", { NULL }, 5768, "tcp" },
+ { "openmailpxy", { NULL }, 5768, "udp" },
+ { "spramsca", { NULL }, 5769, "tcp" },
+ { "spramsca", { NULL }, 5769, "udp" },
+ { "spramsd", { NULL }, 5770, "tcp" },
+ { "spramsd", { NULL }, 5770, "udp" },
+ { "netagent", { NULL }, 5771, "tcp" },
+ { "netagent", { NULL }, 5771, "udp" },
+ { "dali-port", { NULL }, 5777, "tcp" },
+ { "dali-port", { NULL }, 5777, "udp" },
+ { "vts-rpc", { NULL }, 5780, "tcp" },
+ { "3par-evts", { NULL }, 5781, "tcp" },
+ { "3par-evts", { NULL }, 5781, "udp" },
+ { "3par-mgmt", { NULL }, 5782, "tcp" },
+ { "3par-mgmt", { NULL }, 5782, "udp" },
+ { "3par-mgmt-ssl", { NULL }, 5783, "tcp" },
+ { "3par-mgmt-ssl", { NULL }, 5783, "udp" },
+ { "ibar", { NULL }, 5784, "udp" },
+ { "3par-rcopy", { NULL }, 5785, "tcp" },
+ { "3par-rcopy", { NULL }, 5785, "udp" },
+ { "cisco-redu", { NULL }, 5786, "udp" },
+ { "waascluster", { NULL }, 5787, "udp" },
+ { "xtreamx", { NULL }, 5793, "tcp" },
+ { "xtreamx", { NULL }, 5793, "udp" },
+ { "spdp", { NULL }, 5794, "udp" },
+ { "icmpd", { NULL }, 5813, "tcp" },
+ { "icmpd", { NULL }, 5813, "udp" },
+ { "spt-automation", { NULL }, 5814, "tcp" },
+ { "spt-automation", { NULL }, 5814, "udp" },
+ { "wherehoo", { NULL }, 5859, "tcp" },
+ { "wherehoo", { NULL }, 5859, "udp" },
+ { "ppsuitemsg", { NULL }, 5863, "tcp" },
+ { "ppsuitemsg", { NULL }, 5863, "udp" },
+ { "rfb", { NULL }, 5900, "tcp" },
+ { "rfb", { NULL }, 5900, "udp" },
+ { "cm", { NULL }, 5910, "tcp" },
+ { "cm", { NULL }, 5910, "udp" },
+ { "cpdlc", { NULL }, 5911, "tcp" },
+ { "cpdlc", { NULL }, 5911, "udp" },
+ { "fis", { NULL }, 5912, "tcp" },
+ { "fis", { NULL }, 5912, "udp" },
+ { "ads-c", { NULL }, 5913, "tcp" },
+ { "ads-c", { NULL }, 5913, "udp" },
+ { "indy", { NULL }, 5963, "tcp" },
+ { "indy", { NULL }, 5963, "udp" },
+ { "mppolicy-v5", { NULL }, 5968, "tcp" },
+ { "mppolicy-v5", { NULL }, 5968, "udp" },
+ { "mppolicy-mgr", { NULL }, 5969, "tcp" },
+ { "mppolicy-mgr", { NULL }, 5969, "udp" },
+ { "couchdb", { NULL }, 5984, "tcp" },
+ { "couchdb", { NULL }, 5984, "udp" },
+ { "wsman", { NULL }, 5985, "tcp" },
+ { "wsman", { NULL }, 5985, "udp" },
+ { "wsmans", { NULL }, 5986, "tcp" },
+ { "wsmans", { NULL }, 5986, "udp" },
+ { "wbem-rmi", { NULL }, 5987, "tcp" },
+ { "wbem-rmi", { NULL }, 5987, "udp" },
+ { "wbem-http", { NULL }, 5988, "tcp" },
+ { "wbem-http", { NULL }, 5988, "udp" },
+ { "wbem-https", { NULL }, 5989, "tcp" },
+ { "wbem-https", { NULL }, 5989, "udp" },
+ { "wbem-exp-https", { NULL }, 5990, "tcp" },
+ { "wbem-exp-https", { NULL }, 5990, "udp" },
+ { "nuxsl", { NULL }, 5991, "tcp" },
+ { "nuxsl", { NULL }, 5991, "udp" },
+ { "consul-insight", { NULL }, 5992, "tcp" },
+ { "consul-insight", { NULL }, 5992, "udp" },
+ { "cvsup", { NULL }, 5999, "tcp" },
+ { "cvsup", { NULL }, 5999, "udp" },
+ { "ndl-ahp-svc", { NULL }, 6064, "tcp" },
+ { "ndl-ahp-svc", { NULL }, 6064, "udp" },
+ { "winpharaoh", { NULL }, 6065, "tcp" },
+ { "winpharaoh", { NULL }, 6065, "udp" },
+ { "ewctsp", { NULL }, 6066, "tcp" },
+ { "ewctsp", { NULL }, 6066, "udp" },
+ { "gsmp", { NULL }, 6068, "tcp" },
+ { "gsmp", { NULL }, 6068, "udp" },
+ { "trip", { NULL }, 6069, "tcp" },
+ { "trip", { NULL }, 6069, "udp" },
+ { "messageasap", { NULL }, 6070, "tcp" },
+ { "messageasap", { NULL }, 6070, "udp" },
+ { "ssdtp", { NULL }, 6071, "tcp" },
+ { "ssdtp", { NULL }, 6071, "udp" },
+ { "diagnose-proc", { NULL }, 6072, "tcp" },
+ { "diagnose-proc", { NULL }, 6072, "udp" },
+ { "directplay8", { NULL }, 6073, "tcp" },
+ { "directplay8", { NULL }, 6073, "udp" },
+ { "max", { NULL }, 6074, "tcp" },
+ { "max", { NULL }, 6074, "udp" },
+ { "dpm-acm", { NULL }, 6075, "tcp" },
+ { "miami-bcast", { NULL }, 6083, "udp" },
+ { "p2p-sip", { NULL }, 6084, "tcp" },
+ { "konspire2b", { NULL }, 6085, "tcp" },
+ { "konspire2b", { NULL }, 6085, "udp" },
+ { "pdtp", { NULL }, 6086, "tcp" },
+ { "pdtp", { NULL }, 6086, "udp" },
+ { "ldss", { NULL }, 6087, "tcp" },
+ { "ldss", { NULL }, 6087, "udp" },
+ { "raxa-mgmt", { NULL }, 6099, "tcp" },
+ { "synchronet-db", { NULL }, 6100, "tcp" },
+ { "synchronet-db", { NULL }, 6100, "udp" },
+ { "synchronet-rtc", { NULL }, 6101, "tcp" },
+ { "synchronet-rtc", { NULL }, 6101, "udp" },
+ { "synchronet-upd", { NULL }, 6102, "tcp" },
+ { "synchronet-upd", { NULL }, 6102, "udp" },
+ { "rets", { NULL }, 6103, "tcp" },
+ { "rets", { NULL }, 6103, "udp" },
+ { "dbdb", { NULL }, 6104, "tcp" },
+ { "dbdb", { NULL }, 6104, "udp" },
+ { "primaserver", { NULL }, 6105, "tcp" },
+ { "primaserver", { NULL }, 6105, "udp" },
+ { "mpsserver", { NULL }, 6106, "tcp" },
+ { "mpsserver", { NULL }, 6106, "udp" },
+ { "etc-control", { NULL }, 6107, "tcp" },
+ { "etc-control", { NULL }, 6107, "udp" },
+ { "sercomm-scadmin", { NULL }, 6108, "tcp" },
+ { "sercomm-scadmin", { NULL }, 6108, "udp" },
+ { "globecast-id", { NULL }, 6109, "tcp" },
+ { "globecast-id", { NULL }, 6109, "udp" },
+ { "softcm", { NULL }, 6110, "tcp" },
+ { "softcm", { NULL }, 6110, "udp" },
+ { "spc", { NULL }, 6111, "tcp" },
+ { "spc", { NULL }, 6111, "udp" },
+ { "dtspcd", { NULL }, 6112, "tcp" },
+ { "dtspcd", { NULL }, 6112, "udp" },
+ { "dayliteserver", { NULL }, 6113, "tcp" },
+ { "wrspice", { NULL }, 6114, "tcp" },
+ { "xic", { NULL }, 6115, "tcp" },
+ { "xtlserv", { NULL }, 6116, "tcp" },
+ { "daylitetouch", { NULL }, 6117, "tcp" },
+ { "spdy", { NULL }, 6121, "tcp" },
+ { "bex-webadmin", { NULL }, 6122, "tcp" },
+ { "bex-webadmin", { NULL }, 6122, "udp" },
+ { "backup-express", { NULL }, 6123, "tcp" },
+ { "backup-express", { NULL }, 6123, "udp" },
+ { "pnbs", { NULL }, 6124, "tcp" },
+ { "pnbs", { NULL }, 6124, "udp" },
+ { "nbt-wol", { NULL }, 6133, "tcp" },
+ { "nbt-wol", { NULL }, 6133, "udp" },
+ { "pulsonixnls", { NULL }, 6140, "tcp" },
+ { "pulsonixnls", { NULL }, 6140, "udp" },
+ { "meta-corp", { NULL }, 6141, "tcp" },
+ { "meta-corp", { NULL }, 6141, "udp" },
+ { "aspentec-lm", { NULL }, 6142, "tcp" },
+ { "aspentec-lm", { NULL }, 6142, "udp" },
+ { "watershed-lm", { NULL }, 6143, "tcp" },
+ { "watershed-lm", { NULL }, 6143, "udp" },
+ { "statsci1-lm", { NULL }, 6144, "tcp" },
+ { "statsci1-lm", { NULL }, 6144, "udp" },
+ { "statsci2-lm", { NULL }, 6145, "tcp" },
+ { "statsci2-lm", { NULL }, 6145, "udp" },
+ { "lonewolf-lm", { NULL }, 6146, "tcp" },
+ { "lonewolf-lm", { NULL }, 6146, "udp" },
+ { "montage-lm", { NULL }, 6147, "tcp" },
+ { "montage-lm", { NULL }, 6147, "udp" },
+ { "ricardo-lm", { NULL }, 6148, "tcp" },
+ { "ricardo-lm", { NULL }, 6148, "udp" },
+ { "tal-pod", { NULL }, 6149, "tcp" },
+ { "tal-pod", { NULL }, 6149, "udp" },
+ { "efb-aci", { NULL }, 6159, "tcp" },
+ { "patrol-ism", { NULL }, 6161, "tcp" },
+ { "patrol-ism", { NULL }, 6161, "udp" },
+ { "patrol-coll", { NULL }, 6162, "tcp" },
+ { "patrol-coll", { NULL }, 6162, "udp" },
+ { "pscribe", { NULL }, 6163, "tcp" },
+ { "pscribe", { NULL }, 6163, "udp" },
+ { "lm-x", { NULL }, 6200, "tcp" },
+ { "lm-x", { NULL }, 6200, "udp" },
+ { "radmind", { NULL }, 6222, "tcp" },
+ { "radmind", { NULL }, 6222, "udp" },
+ { "jeol-nsdtp-1", { NULL }, 6241, "tcp" },
+ { "jeol-nsddp-1", { NULL }, 6241, "udp" },
+ { "jeol-nsdtp-2", { NULL }, 6242, "tcp" },
+ { "jeol-nsddp-2", { NULL }, 6242, "udp" },
+ { "jeol-nsdtp-3", { NULL }, 6243, "tcp" },
+ { "jeol-nsddp-3", { NULL }, 6243, "udp" },
+ { "jeol-nsdtp-4", { NULL }, 6244, "tcp" },
+ { "jeol-nsddp-4", { NULL }, 6244, "udp" },
+ { "tl1-raw-ssl", { NULL }, 6251, "tcp" },
+ { "tl1-raw-ssl", { NULL }, 6251, "udp" },
+ { "tl1-ssh", { NULL }, 6252, "tcp" },
+ { "tl1-ssh", { NULL }, 6252, "udp" },
+ { "crip", { NULL }, 6253, "tcp" },
+ { "crip", { NULL }, 6253, "udp" },
+ { "gld", { NULL }, 6267, "tcp" },
+ { "grid", { NULL }, 6268, "tcp" },
+ { "grid", { NULL }, 6268, "udp" },
+ { "grid-alt", { NULL }, 6269, "tcp" },
+ { "grid-alt", { NULL }, 6269, "udp" },
+ { "bmc-grx", { NULL }, 6300, "tcp" },
+ { "bmc-grx", { NULL }, 6300, "udp" },
+ { "bmc_ctd_ldap", { NULL }, 6301, "tcp" },
+ { "bmc_ctd_ldap", { NULL }, 6301, "udp" },
+ { "ufmp", { NULL }, 6306, "tcp" },
+ { "ufmp", { NULL }, 6306, "udp" },
+ { "scup", { NULL }, 6315, "tcp" },
+ { "scup-disc", { NULL }, 6315, "udp" },
+ { "abb-escp", { NULL }, 6316, "tcp" },
+ { "abb-escp", { NULL }, 6316, "udp" },
+ { "repsvc", { NULL }, 6320, "tcp" },
+ { "repsvc", { NULL }, 6320, "udp" },
+ { "emp-server1", { NULL }, 6321, "tcp" },
+ { "emp-server1", { NULL }, 6321, "udp" },
+ { "emp-server2", { NULL }, 6322, "tcp" },
+ { "emp-server2", { NULL }, 6322, "udp" },
+ { "sflow", { NULL }, 6343, "tcp" },
+ { "sflow", { NULL }, 6343, "udp" },
+ { "gnutella-svc", { NULL }, 6346, "tcp" },
+ { "gnutella-svc", { NULL }, 6346, "udp" },
+ { "gnutella-rtr", { NULL }, 6347, "tcp" },
+ { "gnutella-rtr", { NULL }, 6347, "udp" },
+ { "adap", { NULL }, 6350, "tcp" },
+ { "adap", { NULL }, 6350, "udp" },
+ { "pmcs", { NULL }, 6355, "tcp" },
+ { "pmcs", { NULL }, 6355, "udp" },
+ { "metaedit-mu", { NULL }, 6360, "tcp" },
+ { "metaedit-mu", { NULL }, 6360, "udp" },
+ { "metaedit-se", { NULL }, 6370, "tcp" },
+ { "metaedit-se", { NULL }, 6370, "udp" },
+ { "metatude-mds", { NULL }, 6382, "tcp" },
+ { "metatude-mds", { NULL }, 6382, "udp" },
+ { "clariion-evr01", { NULL }, 6389, "tcp" },
+ { "clariion-evr01", { NULL }, 6389, "udp" },
+ { "metaedit-ws", { NULL }, 6390, "tcp" },
+ { "metaedit-ws", { NULL }, 6390, "udp" },
+ { "faxcomservice", { NULL }, 6417, "tcp" },
+ { "faxcomservice", { NULL }, 6417, "udp" },
+ { "syserverremote", { NULL }, 6418, "tcp" },
+ { "svdrp", { NULL }, 6419, "tcp" },
+ { "nim-vdrshell", { NULL }, 6420, "tcp" },
+ { "nim-vdrshell", { NULL }, 6420, "udp" },
+ { "nim-wan", { NULL }, 6421, "tcp" },
+ { "nim-wan", { NULL }, 6421, "udp" },
+ { "pgbouncer", { NULL }, 6432, "tcp" },
+ { "sun-sr-https", { NULL }, 6443, "tcp" },
+ { "sun-sr-https", { NULL }, 6443, "udp" },
+ { "sge_qmaster", { NULL }, 6444, "tcp" },
+ { "sge_qmaster", { NULL }, 6444, "udp" },
+ { "sge_execd", { NULL }, 6445, "tcp" },
+ { "sge_execd", { NULL }, 6445, "udp" },
+ { "mysql-proxy", { NULL }, 6446, "tcp" },
+ { "mysql-proxy", { NULL }, 6446, "udp" },
+ { "skip-cert-recv", { NULL }, 6455, "tcp" },
+ { "skip-cert-send", { NULL }, 6456, "udp" },
+ { "lvision-lm", { NULL }, 6471, "tcp" },
+ { "lvision-lm", { NULL }, 6471, "udp" },
+ { "sun-sr-http", { NULL }, 6480, "tcp" },
+ { "sun-sr-http", { NULL }, 6480, "udp" },
+ { "servicetags", { NULL }, 6481, "tcp" },
+ { "servicetags", { NULL }, 6481, "udp" },
+ { "ldoms-mgmt", { NULL }, 6482, "tcp" },
+ { "ldoms-mgmt", { NULL }, 6482, "udp" },
+ { "SunVTS-RMI", { NULL }, 6483, "tcp" },
+ { "SunVTS-RMI", { NULL }, 6483, "udp" },
+ { "sun-sr-jms", { NULL }, 6484, "tcp" },
+ { "sun-sr-jms", { NULL }, 6484, "udp" },
+ { "sun-sr-iiop", { NULL }, 6485, "tcp" },
+ { "sun-sr-iiop", { NULL }, 6485, "udp" },
+ { "sun-sr-iiops", { NULL }, 6486, "tcp" },
+ { "sun-sr-iiops", { NULL }, 6486, "udp" },
+ { "sun-sr-iiop-aut", { NULL }, 6487, "tcp" },
+ { "sun-sr-iiop-aut", { NULL }, 6487, "udp" },
+ { "sun-sr-jmx", { NULL }, 6488, "tcp" },
+ { "sun-sr-jmx", { NULL }, 6488, "udp" },
+ { "sun-sr-admin", { NULL }, 6489, "tcp" },
+ { "sun-sr-admin", { NULL }, 6489, "udp" },
+ { "boks", { NULL }, 6500, "tcp" },
+ { "boks", { NULL }, 6500, "udp" },
+ { "boks_servc", { NULL }, 6501, "tcp" },
+ { "boks_servc", { NULL }, 6501, "udp" },
+ { "boks_servm", { NULL }, 6502, "tcp" },
+ { "boks_servm", { NULL }, 6502, "udp" },
+ { "boks_clntd", { NULL }, 6503, "tcp" },
+ { "boks_clntd", { NULL }, 6503, "udp" },
+ { "badm_priv", { NULL }, 6505, "tcp" },
+ { "badm_priv", { NULL }, 6505, "udp" },
+ { "badm_pub", { NULL }, 6506, "tcp" },
+ { "badm_pub", { NULL }, 6506, "udp" },
+ { "bdir_priv", { NULL }, 6507, "tcp" },
+ { "bdir_priv", { NULL }, 6507, "udp" },
+ { "bdir_pub", { NULL }, 6508, "tcp" },
+ { "bdir_pub", { NULL }, 6508, "udp" },
+ { "mgcs-mfp-port", { NULL }, 6509, "tcp" },
+ { "mgcs-mfp-port", { NULL }, 6509, "udp" },
+ { "mcer-port", { NULL }, 6510, "tcp" },
+ { "mcer-port", { NULL }, 6510, "udp" },
+ { "netconf-tls", { NULL }, 6513, "tcp" },
+ { "syslog-tls", { NULL }, 6514, "tcp" },
+ { "syslog-tls", { NULL }, 6514, "udp" },
+ { "syslog-tls", { NULL }, 6514, "dccp"},
+ { "elipse-rec", { NULL }, 6515, "tcp" },
+ { "elipse-rec", { NULL }, 6515, "udp" },
+ { "lds-distrib", { NULL }, 6543, "tcp" },
+ { "lds-distrib", { NULL }, 6543, "udp" },
+ { "lds-dump", { NULL }, 6544, "tcp" },
+ { "lds-dump", { NULL }, 6544, "udp" },
+ { "apc-6547", { NULL }, 6547, "tcp" },
+ { "apc-6547", { NULL }, 6547, "udp" },
+ { "apc-6548", { NULL }, 6548, "tcp" },
+ { "apc-6548", { NULL }, 6548, "udp" },
+ { "apc-6549", { NULL }, 6549, "tcp" },
+ { "apc-6549", { NULL }, 6549, "udp" },
+ { "fg-sysupdate", { NULL }, 6550, "tcp" },
+ { "fg-sysupdate", { NULL }, 6550, "udp" },
+ { "sum", { NULL }, 6551, "tcp" },
+ { "sum", { NULL }, 6551, "udp" },
+ { "xdsxdm", { NULL }, 6558, "tcp" },
+ { "xdsxdm", { NULL }, 6558, "udp" },
+ { "sane-port", { NULL }, 6566, "tcp" },
+ { "sane-port", { NULL }, 6566, "udp" },
+ { "esp", { NULL }, 6567, "tcp" },
+ { "esp", { NULL }, 6567, "udp" },
+ { "canit_store", { NULL }, 6568, "tcp" },
+ { "rp-reputation", { NULL }, 6568, "udp" },
+ { "affiliate", { NULL }, 6579, "tcp" },
+ { "affiliate", { NULL }, 6579, "udp" },
+ { "parsec-master", { NULL }, 6580, "tcp" },
+ { "parsec-master", { NULL }, 6580, "udp" },
+ { "parsec-peer", { NULL }, 6581, "tcp" },
+ { "parsec-peer", { NULL }, 6581, "udp" },
+ { "parsec-game", { NULL }, 6582, "tcp" },
+ { "parsec-game", { NULL }, 6582, "udp" },
+ { "joaJewelSuite", { NULL }, 6583, "tcp" },
+ { "joaJewelSuite", { NULL }, 6583, "udp" },
+ { "mshvlm", { NULL }, 6600, "tcp" },
+ { "mstmg-sstp", { NULL }, 6601, "tcp" },
+ { "wsscomfrmwk", { NULL }, 6602, "tcp" },
+ { "odette-ftps", { NULL }, 6619, "tcp" },
+ { "odette-ftps", { NULL }, 6619, "udp" },
+ { "kftp-data", { NULL }, 6620, "tcp" },
+ { "kftp-data", { NULL }, 6620, "udp" },
+ { "kftp", { NULL }, 6621, "tcp" },
+ { "kftp", { NULL }, 6621, "udp" },
+ { "mcftp", { NULL }, 6622, "tcp" },
+ { "mcftp", { NULL }, 6622, "udp" },
+ { "ktelnet", { NULL }, 6623, "tcp" },
+ { "ktelnet", { NULL }, 6623, "udp" },
+ { "datascaler-db", { NULL }, 6624, "tcp" },
+ { "datascaler-ctl", { NULL }, 6625, "tcp" },
+ { "wago-service", { NULL }, 6626, "tcp" },
+ { "wago-service", { NULL }, 6626, "udp" },
+ { "nexgen", { NULL }, 6627, "tcp" },
+ { "nexgen", { NULL }, 6627, "udp" },
+ { "afesc-mc", { NULL }, 6628, "tcp" },
+ { "afesc-mc", { NULL }, 6628, "udp" },
+ { "mxodbc-connect", { NULL }, 6632, "tcp" },
+ { "pcs-sf-ui-man", { NULL }, 6655, "tcp" },
+ { "emgmsg", { NULL }, 6656, "tcp" },
+ { "palcom-disc", { NULL }, 6657, "udp" },
+ { "vocaltec-gold", { NULL }, 6670, "tcp" },
+ { "vocaltec-gold", { NULL }, 6670, "udp" },
+ { "p4p-portal", { NULL }, 6671, "tcp" },
+ { "p4p-portal", { NULL }, 6671, "udp" },
+ { "vision_server", { NULL }, 6672, "tcp" },
+ { "vision_server", { NULL }, 6672, "udp" },
+ { "vision_elmd", { NULL }, 6673, "tcp" },
+ { "vision_elmd", { NULL }, 6673, "udp" },
+ { "vfbp", { NULL }, 6678, "tcp" },
+ { "vfbp-disc", { NULL }, 6678, "udp" },
+ { "osaut", { NULL }, 6679, "tcp" },
+ { "osaut", { NULL }, 6679, "udp" },
+ { "clever-ctrace", { NULL }, 6687, "tcp" },
+ { "clever-tcpip", { NULL }, 6688, "tcp" },
+ { "tsa", { NULL }, 6689, "tcp" },
+ { "tsa", { NULL }, 6689, "udp" },
+ { "babel", { NULL }, 6697, "udp" },
+ { "kti-icad-srvr", { NULL }, 6701, "tcp" },
+ { "kti-icad-srvr", { NULL }, 6701, "udp" },
+ { "e-design-net", { NULL }, 6702, "tcp" },
+ { "e-design-net", { NULL }, 6702, "udp" },
+ { "e-design-web", { NULL }, 6703, "tcp" },
+ { "e-design-web", { NULL }, 6703, "udp" },
+ { "frc-hp", { NULL }, 6704, "sctp"},
+ { "frc-mp", { NULL }, 6705, "sctp"},
+ { "frc-lp", { NULL }, 6706, "sctp"},
+ { "ibprotocol", { NULL }, 6714, "tcp" },
+ { "ibprotocol", { NULL }, 6714, "udp" },
+ { "fibotrader-com", { NULL }, 6715, "tcp" },
+ { "fibotrader-com", { NULL }, 6715, "udp" },
+ { "bmc-perf-agent", { NULL }, 6767, "tcp" },
+ { "bmc-perf-agent", { NULL }, 6767, "udp" },
+ { "bmc-perf-mgrd", { NULL }, 6768, "tcp" },
+ { "bmc-perf-mgrd", { NULL }, 6768, "udp" },
+ { "adi-gxp-srvprt", { NULL }, 6769, "tcp" },
+ { "adi-gxp-srvprt", { NULL }, 6769, "udp" },
+ { "plysrv-http", { NULL }, 6770, "tcp" },
+ { "plysrv-http", { NULL }, 6770, "udp" },
+ { "plysrv-https", { NULL }, 6771, "tcp" },
+ { "plysrv-https", { NULL }, 6771, "udp" },
+ { "dgpf-exchg", { NULL }, 6785, "tcp" },
+ { "dgpf-exchg", { NULL }, 6785, "udp" },
+ { "smc-jmx", { NULL }, 6786, "tcp" },
+ { "smc-jmx", { NULL }, 6786, "udp" },
+ { "smc-admin", { NULL }, 6787, "tcp" },
+ { "smc-admin", { NULL }, 6787, "udp" },
+ { "smc-http", { NULL }, 6788, "tcp" },
+ { "smc-http", { NULL }, 6788, "udp" },
+ { "smc-https", { NULL }, 6789, "tcp" },
+ { "smc-https", { NULL }, 6789, "udp" },
+ { "hnmp", { NULL }, 6790, "tcp" },
+ { "hnmp", { NULL }, 6790, "udp" },
+ { "hnm", { NULL }, 6791, "tcp" },
+ { "hnm", { NULL }, 6791, "udp" },
+ { "acnet", { NULL }, 6801, "tcp" },
+ { "acnet", { NULL }, 6801, "udp" },
+ { "pentbox-sim", { NULL }, 6817, "tcp" },
+ { "ambit-lm", { NULL }, 6831, "tcp" },
+ { "ambit-lm", { NULL }, 6831, "udp" },
+ { "netmo-default", { NULL }, 6841, "tcp" },
+ { "netmo-default", { NULL }, 6841, "udp" },
+ { "netmo-http", { NULL }, 6842, "tcp" },
+ { "netmo-http", { NULL }, 6842, "udp" },
+ { "iccrushmore", { NULL }, 6850, "tcp" },
+ { "iccrushmore", { NULL }, 6850, "udp" },
+ { "acctopus-cc", { NULL }, 6868, "tcp" },
+ { "acctopus-st", { NULL }, 6868, "udp" },
+ { "muse", { NULL }, 6888, "tcp" },
+ { "muse", { NULL }, 6888, "udp" },
+ { "jetstream", { NULL }, 6901, "tcp" },
+ { "xsmsvc", { NULL }, 6936, "tcp" },
+ { "xsmsvc", { NULL }, 6936, "udp" },
+ { "bioserver", { NULL }, 6946, "tcp" },
+ { "bioserver", { NULL }, 6946, "udp" },
+ { "otlp", { NULL }, 6951, "tcp" },
+ { "otlp", { NULL }, 6951, "udp" },
+ { "jmact3", { NULL }, 6961, "tcp" },
+ { "jmact3", { NULL }, 6961, "udp" },
+ { "jmevt2", { NULL }, 6962, "tcp" },
+ { "jmevt2", { NULL }, 6962, "udp" },
+ { "swismgr1", { NULL }, 6963, "tcp" },
+ { "swismgr1", { NULL }, 6963, "udp" },
+ { "swismgr2", { NULL }, 6964, "tcp" },
+ { "swismgr2", { NULL }, 6964, "udp" },
+ { "swistrap", { NULL }, 6965, "tcp" },
+ { "swistrap", { NULL }, 6965, "udp" },
+ { "swispol", { NULL }, 6966, "tcp" },
+ { "swispol", { NULL }, 6966, "udp" },
+ { "acmsoda", { NULL }, 6969, "tcp" },
+ { "acmsoda", { NULL }, 6969, "udp" },
+ { "MobilitySrv", { NULL }, 6997, "tcp" },
+ { "MobilitySrv", { NULL }, 6997, "udp" },
+ { "iatp-highpri", { NULL }, 6998, "tcp" },
+ { "iatp-highpri", { NULL }, 6998, "udp" },
+ { "iatp-normalpri", { NULL }, 6999, "tcp" },
+ { "iatp-normalpri", { NULL }, 6999, "udp" },
+ { "afs3-fileserver", { NULL }, 7000, "tcp" },
+ { "afs3-fileserver", { NULL }, 7000, "udp" },
+ { "afs3-callback", { NULL }, 7001, "tcp" },
+ { "afs3-callback", { NULL }, 7001, "udp" },
+ { "afs3-prserver", { NULL }, 7002, "tcp" },
+ { "afs3-prserver", { NULL }, 7002, "udp" },
+ { "afs3-vlserver", { NULL }, 7003, "tcp" },
+ { "afs3-vlserver", { NULL }, 7003, "udp" },
+ { "afs3-kaserver", { NULL }, 7004, "tcp" },
+ { "afs3-kaserver", { NULL }, 7004, "udp" },
+ { "afs3-volser", { NULL }, 7005, "tcp" },
+ { "afs3-volser", { NULL }, 7005, "udp" },
+ { "afs3-errors", { NULL }, 7006, "tcp" },
+ { "afs3-errors", { NULL }, 7006, "udp" },
+ { "afs3-bos", { NULL }, 7007, "tcp" },
+ { "afs3-bos", { NULL }, 7007, "udp" },
+ { "afs3-update", { NULL }, 7008, "tcp" },
+ { "afs3-update", { NULL }, 7008, "udp" },
+ { "afs3-rmtsys", { NULL }, 7009, "tcp" },
+ { "afs3-rmtsys", { NULL }, 7009, "udp" },
+ { "ups-onlinet", { NULL }, 7010, "tcp" },
+ { "ups-onlinet", { NULL }, 7010, "udp" },
+ { "talon-disc", { NULL }, 7011, "tcp" },
+ { "talon-disc", { NULL }, 7011, "udp" },
+ { "talon-engine", { NULL }, 7012, "tcp" },
+ { "talon-engine", { NULL }, 7012, "udp" },
+ { "microtalon-dis", { NULL }, 7013, "tcp" },
+ { "microtalon-dis", { NULL }, 7013, "udp" },
+ { "microtalon-com", { NULL }, 7014, "tcp" },
+ { "microtalon-com", { NULL }, 7014, "udp" },
+ { "talon-webserver", { NULL }, 7015, "tcp" },
+ { "talon-webserver", { NULL }, 7015, "udp" },
+ { "dpserve", { NULL }, 7020, "tcp" },
+ { "dpserve", { NULL }, 7020, "udp" },
+ { "dpserveadmin", { NULL }, 7021, "tcp" },
+ { "dpserveadmin", { NULL }, 7021, "udp" },
+ { "ctdp", { NULL }, 7022, "tcp" },
+ { "ctdp", { NULL }, 7022, "udp" },
+ { "ct2nmcs", { NULL }, 7023, "tcp" },
+ { "ct2nmcs", { NULL }, 7023, "udp" },
+ { "vmsvc", { NULL }, 7024, "tcp" },
+ { "vmsvc", { NULL }, 7024, "udp" },
+ { "vmsvc-2", { NULL }, 7025, "tcp" },
+ { "vmsvc-2", { NULL }, 7025, "udp" },
+ { "op-probe", { NULL }, 7030, "tcp" },
+ { "op-probe", { NULL }, 7030, "udp" },
+ { "arcp", { NULL }, 7070, "tcp" },
+ { "arcp", { NULL }, 7070, "udp" },
+ { "iwg1", { NULL }, 7071, "tcp" },
+ { "iwg1", { NULL }, 7071, "udp" },
+ { "empowerid", { NULL }, 7080, "tcp" },
+ { "empowerid", { NULL }, 7080, "udp" },
+ { "lazy-ptop", { NULL }, 7099, "tcp" },
+ { "lazy-ptop", { NULL }, 7099, "udp" },
+ { "font-service", { NULL }, 7100, "tcp" },
+ { "font-service", { NULL }, 7100, "udp" },
+ { "elcn", { NULL }, 7101, "tcp" },
+ { "elcn", { NULL }, 7101, "udp" },
+ { "aes-x170", { NULL }, 7107, "udp" },
+ { "virprot-lm", { NULL }, 7121, "tcp" },
+ { "virprot-lm", { NULL }, 7121, "udp" },
+ { "scenidm", { NULL }, 7128, "tcp" },
+ { "scenidm", { NULL }, 7128, "udp" },
+ { "scenccs", { NULL }, 7129, "tcp" },
+ { "scenccs", { NULL }, 7129, "udp" },
+ { "cabsm-comm", { NULL }, 7161, "tcp" },
+ { "cabsm-comm", { NULL }, 7161, "udp" },
+ { "caistoragemgr", { NULL }, 7162, "tcp" },
+ { "caistoragemgr", { NULL }, 7162, "udp" },
+ { "cacsambroker", { NULL }, 7163, "tcp" },
+ { "cacsambroker", { NULL }, 7163, "udp" },
+ { "fsr", { NULL }, 7164, "tcp" },
+ { "fsr", { NULL }, 7164, "udp" },
+ { "doc-server", { NULL }, 7165, "tcp" },
+ { "doc-server", { NULL }, 7165, "udp" },
+ { "aruba-server", { NULL }, 7166, "tcp" },
+ { "aruba-server", { NULL }, 7166, "udp" },
+ { "casrmagent", { NULL }, 7167, "tcp" },
+ { "cnckadserver", { NULL }, 7168, "tcp" },
+ { "ccag-pib", { NULL }, 7169, "tcp" },
+ { "ccag-pib", { NULL }, 7169, "udp" },
+ { "nsrp", { NULL }, 7170, "tcp" },
+ { "nsrp", { NULL }, 7170, "udp" },
+ { "drm-production", { NULL }, 7171, "tcp" },
+ { "drm-production", { NULL }, 7171, "udp" },
+ { "zsecure", { NULL }, 7173, "tcp" },
+ { "clutild", { NULL }, 7174, "tcp" },
+ { "clutild", { NULL }, 7174, "udp" },
+ { "fodms", { NULL }, 7200, "tcp" },
+ { "fodms", { NULL }, 7200, "udp" },
+ { "dlip", { NULL }, 7201, "tcp" },
+ { "dlip", { NULL }, 7201, "udp" },
+ { "ramp", { NULL }, 7227, "tcp" },
+ { "ramp", { NULL }, 7227, "udp" },
+ { "citrixupp", { NULL }, 7228, "tcp" },
+ { "citrixuppg", { NULL }, 7229, "tcp" },
+ { "pads", { NULL }, 7237, "tcp" },
+ { "cnap", { NULL }, 7262, "tcp" },
+ { "cnap", { NULL }, 7262, "udp" },
+ { "watchme-7272", { NULL }, 7272, "tcp" },
+ { "watchme-7272", { NULL }, 7272, "udp" },
+ { "oma-rlp", { NULL }, 7273, "tcp" },
+ { "oma-rlp", { NULL }, 7273, "udp" },
+ { "oma-rlp-s", { NULL }, 7274, "tcp" },
+ { "oma-rlp-s", { NULL }, 7274, "udp" },
+ { "oma-ulp", { NULL }, 7275, "tcp" },
+ { "oma-ulp", { NULL }, 7275, "udp" },
+ { "oma-ilp", { NULL }, 7276, "tcp" },
+ { "oma-ilp", { NULL }, 7276, "udp" },
+ { "oma-ilp-s", { NULL }, 7277, "tcp" },
+ { "oma-ilp-s", { NULL }, 7277, "udp" },
+ { "oma-dcdocbs", { NULL }, 7278, "tcp" },
+ { "oma-dcdocbs", { NULL }, 7278, "udp" },
+ { "ctxlic", { NULL }, 7279, "tcp" },
+ { "ctxlic", { NULL }, 7279, "udp" },
+ { "itactionserver1", { NULL }, 7280, "tcp" },
+ { "itactionserver1", { NULL }, 7280, "udp" },
+ { "itactionserver2", { NULL }, 7281, "tcp" },
+ { "itactionserver2", { NULL }, 7281, "udp" },
+ { "mzca-action", { NULL }, 7282, "tcp" },
+ { "mzca-alert", { NULL }, 7282, "udp" },
+ { "lcm-server", { NULL }, 7365, "tcp" },
+ { "lcm-server", { NULL }, 7365, "udp" },
+ { "mindfilesys", { NULL }, 7391, "tcp" },
+ { "mindfilesys", { NULL }, 7391, "udp" },
+ { "mrssrendezvous", { NULL }, 7392, "tcp" },
+ { "mrssrendezvous", { NULL }, 7392, "udp" },
+ { "nfoldman", { NULL }, 7393, "tcp" },
+ { "nfoldman", { NULL }, 7393, "udp" },
+ { "fse", { NULL }, 7394, "tcp" },
+ { "fse", { NULL }, 7394, "udp" },
+ { "winqedit", { NULL }, 7395, "tcp" },
+ { "winqedit", { NULL }, 7395, "udp" },
+ { "hexarc", { NULL }, 7397, "tcp" },
+ { "hexarc", { NULL }, 7397, "udp" },
+ { "rtps-discovery", { NULL }, 7400, "tcp" },
+ { "rtps-discovery", { NULL }, 7400, "udp" },
+ { "rtps-dd-ut", { NULL }, 7401, "tcp" },
+ { "rtps-dd-ut", { NULL }, 7401, "udp" },
+ { "rtps-dd-mt", { NULL }, 7402, "tcp" },
+ { "rtps-dd-mt", { NULL }, 7402, "udp" },
+ { "ionixnetmon", { NULL }, 7410, "tcp" },
+ { "ionixnetmon", { NULL }, 7410, "udp" },
+ { "mtportmon", { NULL }, 7421, "tcp" },
+ { "mtportmon", { NULL }, 7421, "udp" },
+ { "pmdmgr", { NULL }, 7426, "tcp" },
+ { "pmdmgr", { NULL }, 7426, "udp" },
+ { "oveadmgr", { NULL }, 7427, "tcp" },
+ { "oveadmgr", { NULL }, 7427, "udp" },
+ { "ovladmgr", { NULL }, 7428, "tcp" },
+ { "ovladmgr", { NULL }, 7428, "udp" },
+ { "opi-sock", { NULL }, 7429, "tcp" },
+ { "opi-sock", { NULL }, 7429, "udp" },
+ { "xmpv7", { NULL }, 7430, "tcp" },
+ { "xmpv7", { NULL }, 7430, "udp" },
+ { "pmd", { NULL }, 7431, "tcp" },
+ { "pmd", { NULL }, 7431, "udp" },
+ { "faximum", { NULL }, 7437, "tcp" },
+ { "faximum", { NULL }, 7437, "udp" },
+ { "oracleas-https", { NULL }, 7443, "tcp" },
+ { "oracleas-https", { NULL }, 7443, "udp" },
+ { "rise", { NULL }, 7473, "tcp" },
+ { "rise", { NULL }, 7473, "udp" },
+ { "telops-lmd", { NULL }, 7491, "tcp" },
+ { "telops-lmd", { NULL }, 7491, "udp" },
+ { "silhouette", { NULL }, 7500, "tcp" },
+ { "silhouette", { NULL }, 7500, "udp" },
+ { "ovbus", { NULL }, 7501, "tcp" },
+ { "ovbus", { NULL }, 7501, "udp" },
+ { "acplt", { NULL }, 7509, "tcp" },
+ { "ovhpas", { NULL }, 7510, "tcp" },
+ { "ovhpas", { NULL }, 7510, "udp" },
+ { "pafec-lm", { NULL }, 7511, "tcp" },
+ { "pafec-lm", { NULL }, 7511, "udp" },
+ { "saratoga", { NULL }, 7542, "tcp" },
+ { "saratoga", { NULL }, 7542, "udp" },
+ { "atul", { NULL }, 7543, "tcp" },
+ { "atul", { NULL }, 7543, "udp" },
+ { "nta-ds", { NULL }, 7544, "tcp" },
+ { "nta-ds", { NULL }, 7544, "udp" },
+ { "nta-us", { NULL }, 7545, "tcp" },
+ { "nta-us", { NULL }, 7545, "udp" },
+ { "cfs", { NULL }, 7546, "tcp" },
+ { "cfs", { NULL }, 7546, "udp" },
+ { "cwmp", { NULL }, 7547, "tcp" },
+ { "cwmp", { NULL }, 7547, "udp" },
+ { "tidp", { NULL }, 7548, "tcp" },
+ { "tidp", { NULL }, 7548, "udp" },
+ { "nls-tl", { NULL }, 7549, "tcp" },
+ { "nls-tl", { NULL }, 7549, "udp" },
+ { "sncp", { NULL }, 7560, "tcp" },
+ { "sncp", { NULL }, 7560, "udp" },
+ { "cfw", { NULL }, 7563, "tcp" },
+ { "vsi-omega", { NULL }, 7566, "tcp" },
+ { "vsi-omega", { NULL }, 7566, "udp" },
+ { "dell-eql-asm", { NULL }, 7569, "tcp" },
+ { "aries-kfinder", { NULL }, 7570, "tcp" },
+ { "aries-kfinder", { NULL }, 7570, "udp" },
+ { "sun-lm", { NULL }, 7588, "tcp" },
+ { "sun-lm", { NULL }, 7588, "udp" },
+ { "indi", { NULL }, 7624, "tcp" },
+ { "indi", { NULL }, 7624, "udp" },
+ { "simco", { NULL }, 7626, "tcp" },
+ { "simco", { NULL }, 7626, "sctp"},
+ { "soap-http", { NULL }, 7627, "tcp" },
+ { "soap-http", { NULL }, 7627, "udp" },
+ { "zen-pawn", { NULL }, 7628, "tcp" },
+ { "zen-pawn", { NULL }, 7628, "udp" },
+ { "xdas", { NULL }, 7629, "tcp" },
+ { "xdas", { NULL }, 7629, "udp" },
+ { "hawk", { NULL }, 7630, "tcp" },
+ { "tesla-sys-msg", { NULL }, 7631, "tcp" },
+ { "pmdfmgt", { NULL }, 7633, "tcp" },
+ { "pmdfmgt", { NULL }, 7633, "udp" },
+ { "cuseeme", { NULL }, 7648, "tcp" },
+ { "cuseeme", { NULL }, 7648, "udp" },
+ { "imqstomp", { NULL }, 7672, "tcp" },
+ { "imqstomps", { NULL }, 7673, "tcp" },
+ { "imqtunnels", { NULL }, 7674, "tcp" },
+ { "imqtunnels", { NULL }, 7674, "udp" },
+ { "imqtunnel", { NULL }, 7675, "tcp" },
+ { "imqtunnel", { NULL }, 7675, "udp" },
+ { "imqbrokerd", { NULL }, 7676, "tcp" },
+ { "imqbrokerd", { NULL }, 7676, "udp" },
+ { "sun-user-https", { NULL }, 7677, "tcp" },
+ { "sun-user-https", { NULL }, 7677, "udp" },
+ { "pando-pub", { NULL }, 7680, "tcp" },
+ { "pando-pub", { NULL }, 7680, "udp" },
+ { "collaber", { NULL }, 7689, "tcp" },
+ { "collaber", { NULL }, 7689, "udp" },
+ { "klio", { NULL }, 7697, "tcp" },
+ { "klio", { NULL }, 7697, "udp" },
+ { "em7-secom", { NULL }, 7700, "tcp" },
+ { "sync-em7", { NULL }, 7707, "tcp" },
+ { "sync-em7", { NULL }, 7707, "udp" },
+ { "scinet", { NULL }, 7708, "tcp" },
+ { "scinet", { NULL }, 7708, "udp" },
+ { "medimageportal", { NULL }, 7720, "tcp" },
+ { "medimageportal", { NULL }, 7720, "udp" },
+ { "nsdeepfreezectl", { NULL }, 7724, "tcp" },
+ { "nsdeepfreezectl", { NULL }, 7724, "udp" },
+ { "nitrogen", { NULL }, 7725, "tcp" },
+ { "nitrogen", { NULL }, 7725, "udp" },
+ { "freezexservice", { NULL }, 7726, "tcp" },
+ { "freezexservice", { NULL }, 7726, "udp" },
+ { "trident-data", { NULL }, 7727, "tcp" },
+ { "trident-data", { NULL }, 7727, "udp" },
+ { "smip", { NULL }, 7734, "tcp" },
+ { "smip", { NULL }, 7734, "udp" },
+ { "aiagent", { NULL }, 7738, "tcp" },
+ { "aiagent", { NULL }, 7738, "udp" },
+ { "scriptview", { NULL }, 7741, "tcp" },
+ { "scriptview", { NULL }, 7741, "udp" },
+ { "msss", { NULL }, 7742, "tcp" },
+ { "sstp-1", { NULL }, 7743, "tcp" },
+ { "sstp-1", { NULL }, 7743, "udp" },
+ { "raqmon-pdu", { NULL }, 7744, "tcp" },
+ { "raqmon-pdu", { NULL }, 7744, "udp" },
+ { "prgp", { NULL }, 7747, "tcp" },
+ { "prgp", { NULL }, 7747, "udp" },
+ { "cbt", { NULL }, 7777, "tcp" },
+ { "cbt", { NULL }, 7777, "udp" },
+ { "interwise", { NULL }, 7778, "tcp" },
+ { "interwise", { NULL }, 7778, "udp" },
+ { "vstat", { NULL }, 7779, "tcp" },
+ { "vstat", { NULL }, 7779, "udp" },
+ { "accu-lmgr", { NULL }, 7781, "tcp" },
+ { "accu-lmgr", { NULL }, 7781, "udp" },
+ { "minivend", { NULL }, 7786, "tcp" },
+ { "minivend", { NULL }, 7786, "udp" },
+ { "popup-reminders", { NULL }, 7787, "tcp" },
+ { "popup-reminders", { NULL }, 7787, "udp" },
+ { "office-tools", { NULL }, 7789, "tcp" },
+ { "office-tools", { NULL }, 7789, "udp" },
+ { "q3ade", { NULL }, 7794, "tcp" },
+ { "q3ade", { NULL }, 7794, "udp" },
+ { "pnet-conn", { NULL }, 7797, "tcp" },
+ { "pnet-conn", { NULL }, 7797, "udp" },
+ { "pnet-enc", { NULL }, 7798, "tcp" },
+ { "pnet-enc", { NULL }, 7798, "udp" },
+ { "altbsdp", { NULL }, 7799, "tcp" },
+ { "altbsdp", { NULL }, 7799, "udp" },
+ { "asr", { NULL }, 7800, "tcp" },
+ { "asr", { NULL }, 7800, "udp" },
+ { "ssp-client", { NULL }, 7801, "tcp" },
+ { "ssp-client", { NULL }, 7801, "udp" },
+ { "rbt-wanopt", { NULL }, 7810, "tcp" },
+ { "rbt-wanopt", { NULL }, 7810, "udp" },
+ { "apc-7845", { NULL }, 7845, "tcp" },
+ { "apc-7845", { NULL }, 7845, "udp" },
+ { "apc-7846", { NULL }, 7846, "tcp" },
+ { "apc-7846", { NULL }, 7846, "udp" },
+ { "mobileanalyzer", { NULL }, 7869, "tcp" },
+ { "rbt-smc", { NULL }, 7870, "tcp" },
+ { "pss", { NULL }, 7880, "tcp" },
+ { "pss", { NULL }, 7880, "udp" },
+ { "ubroker", { NULL }, 7887, "tcp" },
+ { "ubroker", { NULL }, 7887, "udp" },
+ { "mevent", { NULL }, 7900, "tcp" },
+ { "mevent", { NULL }, 7900, "udp" },
+ { "tnos-sp", { NULL }, 7901, "tcp" },
+ { "tnos-sp", { NULL }, 7901, "udp" },
+ { "tnos-dp", { NULL }, 7902, "tcp" },
+ { "tnos-dp", { NULL }, 7902, "udp" },
+ { "tnos-dps", { NULL }, 7903, "tcp" },
+ { "tnos-dps", { NULL }, 7903, "udp" },
+ { "qo-secure", { NULL }, 7913, "tcp" },
+ { "qo-secure", { NULL }, 7913, "udp" },
+ { "t2-drm", { NULL }, 7932, "tcp" },
+ { "t2-drm", { NULL }, 7932, "udp" },
+ { "t2-brm", { NULL }, 7933, "tcp" },
+ { "t2-brm", { NULL }, 7933, "udp" },
+ { "supercell", { NULL }, 7967, "tcp" },
+ { "supercell", { NULL }, 7967, "udp" },
+ { "micromuse-ncps", { NULL }, 7979, "tcp" },
+ { "micromuse-ncps", { NULL }, 7979, "udp" },
+ { "quest-vista", { NULL }, 7980, "tcp" },
+ { "quest-vista", { NULL }, 7980, "udp" },
+ { "sossd-collect", { NULL }, 7981, "tcp" },
+ { "sossd-agent", { NULL }, 7982, "tcp" },
+ { "sossd-disc", { NULL }, 7982, "udp" },
+ { "pushns", { NULL }, 7997, "tcp" },
+ { "usicontentpush", { NULL }, 7998, "udp" },
+ { "irdmi2", { NULL }, 7999, "tcp" },
+ { "irdmi2", { NULL }, 7999, "udp" },
+ { "irdmi", { NULL }, 8000, "tcp" },
+ { "irdmi", { NULL }, 8000, "udp" },
+ { "vcom-tunnel", { NULL }, 8001, "tcp" },
+ { "vcom-tunnel", { NULL }, 8001, "udp" },
+ { "teradataordbms", { NULL }, 8002, "tcp" },
+ { "teradataordbms", { NULL }, 8002, "udp" },
+ { "mcreport", { NULL }, 8003, "tcp" },
+ { "mcreport", { NULL }, 8003, "udp" },
+ { "mxi", { NULL }, 8005, "tcp" },
+ { "mxi", { NULL }, 8005, "udp" },
+ { "http-alt", { NULL }, 8008, "tcp" },
+ { "http-alt", { NULL }, 8008, "udp" },
+ { "qbdb", { NULL }, 8019, "tcp" },
+ { "qbdb", { NULL }, 8019, "udp" },
+ { "intu-ec-svcdisc", { NULL }, 8020, "tcp" },
+ { "intu-ec-svcdisc", { NULL }, 8020, "udp" },
+ { "intu-ec-client", { NULL }, 8021, "tcp" },
+ { "intu-ec-client", { NULL }, 8021, "udp" },
+ { "oa-system", { NULL }, 8022, "tcp" },
+ { "oa-system", { NULL }, 8022, "udp" },
+ { "ca-audit-da", { NULL }, 8025, "tcp" },
+ { "ca-audit-da", { NULL }, 8025, "udp" },
+ { "ca-audit-ds", { NULL }, 8026, "tcp" },
+ { "ca-audit-ds", { NULL }, 8026, "udp" },
+ { "pro-ed", { NULL }, 8032, "tcp" },
+ { "pro-ed", { NULL }, 8032, "udp" },
+ { "mindprint", { NULL }, 8033, "tcp" },
+ { "mindprint", { NULL }, 8033, "udp" },
+ { "vantronix-mgmt", { NULL }, 8034, "tcp" },
+ { "vantronix-mgmt", { NULL }, 8034, "udp" },
+ { "ampify", { NULL }, 8040, "tcp" },
+ { "ampify", { NULL }, 8040, "udp" },
+ { "fs-agent", { NULL }, 8042, "tcp" },
+ { "fs-server", { NULL }, 8043, "tcp" },
+ { "fs-mgmt", { NULL }, 8044, "tcp" },
+ { "senomix01", { NULL }, 8052, "tcp" },
+ { "senomix01", { NULL }, 8052, "udp" },
+ { "senomix02", { NULL }, 8053, "tcp" },
+ { "senomix02", { NULL }, 8053, "udp" },
+ { "senomix03", { NULL }, 8054, "tcp" },
+ { "senomix03", { NULL }, 8054, "udp" },
+ { "senomix04", { NULL }, 8055, "tcp" },
+ { "senomix04", { NULL }, 8055, "udp" },
+ { "senomix05", { NULL }, 8056, "tcp" },
+ { "senomix05", { NULL }, 8056, "udp" },
+ { "senomix06", { NULL }, 8057, "tcp" },
+ { "senomix06", { NULL }, 8057, "udp" },
+ { "senomix07", { NULL }, 8058, "tcp" },
+ { "senomix07", { NULL }, 8058, "udp" },
+ { "senomix08", { NULL }, 8059, "tcp" },
+ { "senomix08", { NULL }, 8059, "udp" },
+ { "gadugadu", { NULL }, 8074, "tcp" },
+ { "gadugadu", { NULL }, 8074, "udp" },
+ { "http-alt", { NULL }, 8080, "tcp" },
+ { "http-alt", { NULL }, 8080, "udp" },
+ { "sunproxyadmin", { NULL }, 8081, "tcp" },
+ { "sunproxyadmin", { NULL }, 8081, "udp" },
+ { "us-cli", { NULL }, 8082, "tcp" },
+ { "us-cli", { NULL }, 8082, "udp" },
+ { "us-srv", { NULL }, 8083, "tcp" },
+ { "us-srv", { NULL }, 8083, "udp" },
+ { "d-s-n", { NULL }, 8086, "tcp" },
+ { "d-s-n", { NULL }, 8086, "udp" },
+ { "simplifymedia", { NULL }, 8087, "tcp" },
+ { "simplifymedia", { NULL }, 8087, "udp" },
+ { "radan-http", { NULL }, 8088, "tcp" },
+ { "radan-http", { NULL }, 8088, "udp" },
+ { "jamlink", { NULL }, 8091, "tcp" },
+ { "sac", { NULL }, 8097, "tcp" },
+ { "sac", { NULL }, 8097, "udp" },
+ { "xprint-server", { NULL }, 8100, "tcp" },
+ { "xprint-server", { NULL }, 8100, "udp" },
+ { "ldoms-migr", { NULL }, 8101, "tcp" },
+ { "mtl8000-matrix", { NULL }, 8115, "tcp" },
+ { "mtl8000-matrix", { NULL }, 8115, "udp" },
+ { "cp-cluster", { NULL }, 8116, "tcp" },
+ { "cp-cluster", { NULL }, 8116, "udp" },
+ { "privoxy", { NULL }, 8118, "tcp" },
+ { "privoxy", { NULL }, 8118, "udp" },
+ { "apollo-data", { NULL }, 8121, "tcp" },
+ { "apollo-data", { NULL }, 8121, "udp" },
+ { "apollo-admin", { NULL }, 8122, "tcp" },
+ { "apollo-admin", { NULL }, 8122, "udp" },
+ { "paycash-online", { NULL }, 8128, "tcp" },
+ { "paycash-online", { NULL }, 8128, "udp" },
+ { "paycash-wbp", { NULL }, 8129, "tcp" },
+ { "paycash-wbp", { NULL }, 8129, "udp" },
+ { "indigo-vrmi", { NULL }, 8130, "tcp" },
+ { "indigo-vrmi", { NULL }, 8130, "udp" },
+ { "indigo-vbcp", { NULL }, 8131, "tcp" },
+ { "indigo-vbcp", { NULL }, 8131, "udp" },
+ { "dbabble", { NULL }, 8132, "tcp" },
+ { "dbabble", { NULL }, 8132, "udp" },
+ { "isdd", { NULL }, 8148, "tcp" },
+ { "isdd", { NULL }, 8148, "udp" },
+ { "patrol", { NULL }, 8160, "tcp" },
+ { "patrol", { NULL }, 8160, "udp" },
+ { "patrol-snmp", { NULL }, 8161, "tcp" },
+ { "patrol-snmp", { NULL }, 8161, "udp" },
+ { "vmware-fdm", { NULL }, 8182, "tcp" },
+ { "vmware-fdm", { NULL }, 8182, "udp" },
+ { "proremote", { NULL }, 8183, "tcp" },
+ { "itach", { NULL }, 8184, "tcp" },
+ { "itach", { NULL }, 8184, "udp" },
+ { "spytechphone", { NULL }, 8192, "tcp" },
+ { "spytechphone", { NULL }, 8192, "udp" },
+ { "blp1", { NULL }, 8194, "tcp" },
+ { "blp1", { NULL }, 8194, "udp" },
+ { "blp2", { NULL }, 8195, "tcp" },
+ { "blp2", { NULL }, 8195, "udp" },
+ { "vvr-data", { NULL }, 8199, "tcp" },
+ { "vvr-data", { NULL }, 8199, "udp" },
+ { "trivnet1", { NULL }, 8200, "tcp" },
+ { "trivnet1", { NULL }, 8200, "udp" },
+ { "trivnet2", { NULL }, 8201, "tcp" },
+ { "trivnet2", { NULL }, 8201, "udp" },
+ { "lm-perfworks", { NULL }, 8204, "tcp" },
+ { "lm-perfworks", { NULL }, 8204, "udp" },
+ { "lm-instmgr", { NULL }, 8205, "tcp" },
+ { "lm-instmgr", { NULL }, 8205, "udp" },
+ { "lm-dta", { NULL }, 8206, "tcp" },
+ { "lm-dta", { NULL }, 8206, "udp" },
+ { "lm-sserver", { NULL }, 8207, "tcp" },
+ { "lm-sserver", { NULL }, 8207, "udp" },
+ { "lm-webwatcher", { NULL }, 8208, "tcp" },
+ { "lm-webwatcher", { NULL }, 8208, "udp" },
+ { "rexecj", { NULL }, 8230, "tcp" },
+ { "rexecj", { NULL }, 8230, "udp" },
+ { "synapse-nhttps", { NULL }, 8243, "tcp" },
+ { "synapse-nhttps", { NULL }, 8243, "udp" },
+ { "pando-sec", { NULL }, 8276, "tcp" },
+ { "pando-sec", { NULL }, 8276, "udp" },
+ { "synapse-nhttp", { NULL }, 8280, "tcp" },
+ { "synapse-nhttp", { NULL }, 8280, "udp" },
+ { "blp3", { NULL }, 8292, "tcp" },
+ { "blp3", { NULL }, 8292, "udp" },
+ { "hiperscan-id", { NULL }, 8293, "tcp" },
+ { "blp4", { NULL }, 8294, "tcp" },
+ { "blp4", { NULL }, 8294, "udp" },
+ { "tmi", { NULL }, 8300, "tcp" },
+ { "tmi", { NULL }, 8300, "udp" },
+ { "amberon", { NULL }, 8301, "tcp" },
+ { "amberon", { NULL }, 8301, "udp" },
+ { "tnp-discover", { NULL }, 8320, "tcp" },
+ { "tnp-discover", { NULL }, 8320, "udp" },
+ { "tnp", { NULL }, 8321, "tcp" },
+ { "tnp", { NULL }, 8321, "udp" },
+ { "server-find", { NULL }, 8351, "tcp" },
+ { "server-find", { NULL }, 8351, "udp" },
+ { "cruise-enum", { NULL }, 8376, "tcp" },
+ { "cruise-enum", { NULL }, 8376, "udp" },
+ { "cruise-swroute", { NULL }, 8377, "tcp" },
+ { "cruise-swroute", { NULL }, 8377, "udp" },
+ { "cruise-config", { NULL }, 8378, "tcp" },
+ { "cruise-config", { NULL }, 8378, "udp" },
+ { "cruise-diags", { NULL }, 8379, "tcp" },
+ { "cruise-diags", { NULL }, 8379, "udp" },
+ { "cruise-update", { NULL }, 8380, "tcp" },
+ { "cruise-update", { NULL }, 8380, "udp" },
+ { "m2mservices", { NULL }, 8383, "tcp" },
+ { "m2mservices", { NULL }, 8383, "udp" },
+ { "cvd", { NULL }, 8400, "tcp" },
+ { "cvd", { NULL }, 8400, "udp" },
+ { "sabarsd", { NULL }, 8401, "tcp" },
+ { "sabarsd", { NULL }, 8401, "udp" },
+ { "abarsd", { NULL }, 8402, "tcp" },
+ { "abarsd", { NULL }, 8402, "udp" },
+ { "admind", { NULL }, 8403, "tcp" },
+ { "admind", { NULL }, 8403, "udp" },
+ { "svcloud", { NULL }, 8404, "tcp" },
+ { "svbackup", { NULL }, 8405, "tcp" },
+ { "espeech", { NULL }, 8416, "tcp" },
+ { "espeech", { NULL }, 8416, "udp" },
+ { "espeech-rtp", { NULL }, 8417, "tcp" },
+ { "espeech-rtp", { NULL }, 8417, "udp" },
+ { "cybro-a-bus", { NULL }, 8442, "tcp" },
+ { "cybro-a-bus", { NULL }, 8442, "udp" },
+ { "pcsync-https", { NULL }, 8443, "tcp" },
+ { "pcsync-https", { NULL }, 8443, "udp" },
+ { "pcsync-http", { NULL }, 8444, "tcp" },
+ { "pcsync-http", { NULL }, 8444, "udp" },
+ { "npmp", { NULL }, 8450, "tcp" },
+ { "npmp", { NULL }, 8450, "udp" },
+ { "cisco-avp", { NULL }, 8470, "tcp" },
+ { "pim-port", { NULL }, 8471, "tcp" },
+ { "pim-port", { NULL }, 8471, "sctp"},
+ { "otv", { NULL }, 8472, "tcp" },
+ { "otv", { NULL }, 8472, "udp" },
+ { "vp2p", { NULL }, 8473, "tcp" },
+ { "vp2p", { NULL }, 8473, "udp" },
+ { "noteshare", { NULL }, 8474, "tcp" },
+ { "noteshare", { NULL }, 8474, "udp" },
+ { "fmtp", { NULL }, 8500, "tcp" },
+ { "fmtp", { NULL }, 8500, "udp" },
+ { "rtsp-alt", { NULL }, 8554, "tcp" },
+ { "rtsp-alt", { NULL }, 8554, "udp" },
+ { "d-fence", { NULL }, 8555, "tcp" },
+ { "d-fence", { NULL }, 8555, "udp" },
+ { "oap-admin", { NULL }, 8567, "tcp" },
+ { "oap-admin", { NULL }, 8567, "udp" },
+ { "asterix", { NULL }, 8600, "tcp" },
+ { "asterix", { NULL }, 8600, "udp" },
+ { "canon-mfnp", { NULL }, 8610, "tcp" },
+ { "canon-mfnp", { NULL }, 8610, "udp" },
+ { "canon-bjnp1", { NULL }, 8611, "tcp" },
+ { "canon-bjnp1", { NULL }, 8611, "udp" },
+ { "canon-bjnp2", { NULL }, 8612, "tcp" },
+ { "canon-bjnp2", { NULL }, 8612, "udp" },
+ { "canon-bjnp3", { NULL }, 8613, "tcp" },
+ { "canon-bjnp3", { NULL }, 8613, "udp" },
+ { "canon-bjnp4", { NULL }, 8614, "tcp" },
+ { "canon-bjnp4", { NULL }, 8614, "udp" },
+ { "sun-as-jmxrmi", { NULL }, 8686, "tcp" },
+ { "sun-as-jmxrmi", { NULL }, 8686, "udp" },
+ { "vnyx", { NULL }, 8699, "tcp" },
+ { "vnyx", { NULL }, 8699, "udp" },
+ { "dtp-net", { NULL }, 8732, "udp" },
+ { "ibus", { NULL }, 8733, "tcp" },
+ { "ibus", { NULL }, 8733, "udp" },
+ { "mc-appserver", { NULL }, 8763, "tcp" },
+ { "mc-appserver", { NULL }, 8763, "udp" },
+ { "openqueue", { NULL }, 8764, "tcp" },
+ { "openqueue", { NULL }, 8764, "udp" },
+ { "ultraseek-http", { NULL }, 8765, "tcp" },
+ { "ultraseek-http", { NULL }, 8765, "udp" },
+ { "dpap", { NULL }, 8770, "tcp" },
+ { "dpap", { NULL }, 8770, "udp" },
+ { "msgclnt", { NULL }, 8786, "tcp" },
+ { "msgclnt", { NULL }, 8786, "udp" },
+ { "msgsrvr", { NULL }, 8787, "tcp" },
+ { "msgsrvr", { NULL }, 8787, "udp" },
+ { "sunwebadmin", { NULL }, 8800, "tcp" },
+ { "sunwebadmin", { NULL }, 8800, "udp" },
+ { "truecm", { NULL }, 8804, "tcp" },
+ { "truecm", { NULL }, 8804, "udp" },
+ { "dxspider", { NULL }, 8873, "tcp" },
+ { "dxspider", { NULL }, 8873, "udp" },
+ { "cddbp-alt", { NULL }, 8880, "tcp" },
+ { "cddbp-alt", { NULL }, 8880, "udp" },
+ { "secure-mqtt", { NULL }, 8883, "tcp" },
+ { "secure-mqtt", { NULL }, 8883, "udp" },
+ { "ddi-tcp-1", { NULL }, 8888, "tcp" },
+ { "ddi-udp-1", { NULL }, 8888, "udp" },
+ { "ddi-tcp-2", { NULL }, 8889, "tcp" },
+ { "ddi-udp-2", { NULL }, 8889, "udp" },
+ { "ddi-tcp-3", { NULL }, 8890, "tcp" },
+ { "ddi-udp-3", { NULL }, 8890, "udp" },
+ { "ddi-tcp-4", { NULL }, 8891, "tcp" },
+ { "ddi-udp-4", { NULL }, 8891, "udp" },
+ { "ddi-tcp-5", { NULL }, 8892, "tcp" },
+ { "ddi-udp-5", { NULL }, 8892, "udp" },
+ { "ddi-tcp-6", { NULL }, 8893, "tcp" },
+ { "ddi-udp-6", { NULL }, 8893, "udp" },
+ { "ddi-tcp-7", { NULL }, 8894, "tcp" },
+ { "ddi-udp-7", { NULL }, 8894, "udp" },
+ { "ospf-lite", { NULL }, 8899, "tcp" },
+ { "ospf-lite", { NULL }, 8899, "udp" },
+ { "jmb-cds1", { NULL }, 8900, "tcp" },
+ { "jmb-cds1", { NULL }, 8900, "udp" },
+ { "jmb-cds2", { NULL }, 8901, "tcp" },
+ { "jmb-cds2", { NULL }, 8901, "udp" },
+ { "manyone-http", { NULL }, 8910, "tcp" },
+ { "manyone-http", { NULL }, 8910, "udp" },
+ { "manyone-xml", { NULL }, 8911, "tcp" },
+ { "manyone-xml", { NULL }, 8911, "udp" },
+ { "wcbackup", { NULL }, 8912, "tcp" },
+ { "wcbackup", { NULL }, 8912, "udp" },
+ { "dragonfly", { NULL }, 8913, "tcp" },
+ { "dragonfly", { NULL }, 8913, "udp" },
+ { "twds", { NULL }, 8937, "tcp" },
+ { "cumulus-admin", { NULL }, 8954, "tcp" },
+ { "cumulus-admin", { NULL }, 8954, "udp" },
+ { "sunwebadmins", { NULL }, 8989, "tcp" },
+ { "sunwebadmins", { NULL }, 8989, "udp" },
+ { "http-wmap", { NULL }, 8990, "tcp" },
+ { "http-wmap", { NULL }, 8990, "udp" },
+ { "https-wmap", { NULL }, 8991, "tcp" },
+ { "https-wmap", { NULL }, 8991, "udp" },
+ { "bctp", { NULL }, 8999, "tcp" },
+ { "bctp", { NULL }, 8999, "udp" },
+ { "cslistener", { NULL }, 9000, "tcp" },
+ { "cslistener", { NULL }, 9000, "udp" },
+ { "etlservicemgr", { NULL }, 9001, "tcp" },
+ { "etlservicemgr", { NULL }, 9001, "udp" },
+ { "dynamid", { NULL }, 9002, "tcp" },
+ { "dynamid", { NULL }, 9002, "udp" },
+ { "ogs-client", { NULL }, 9007, "udp" },
+ { "ogs-server", { NULL }, 9008, "tcp" },
+ { "pichat", { NULL }, 9009, "tcp" },
+ { "pichat", { NULL }, 9009, "udp" },
+ { "sdr", { NULL }, 9010, "tcp" },
+ { "tambora", { NULL }, 9020, "tcp" },
+ { "tambora", { NULL }, 9020, "udp" },
+ { "panagolin-ident", { NULL }, 9021, "tcp" },
+ { "panagolin-ident", { NULL }, 9021, "udp" },
+ { "paragent", { NULL }, 9022, "tcp" },
+ { "paragent", { NULL }, 9022, "udp" },
+ { "swa-1", { NULL }, 9023, "tcp" },
+ { "swa-1", { NULL }, 9023, "udp" },
+ { "swa-2", { NULL }, 9024, "tcp" },
+ { "swa-2", { NULL }, 9024, "udp" },
+ { "swa-3", { NULL }, 9025, "tcp" },
+ { "swa-3", { NULL }, 9025, "udp" },
+ { "swa-4", { NULL }, 9026, "tcp" },
+ { "swa-4", { NULL }, 9026, "udp" },
+ { "versiera", { NULL }, 9050, "tcp" },
+ { "fio-cmgmt", { NULL }, 9051, "tcp" },
+ { "glrpc", { NULL }, 9080, "tcp" },
+ { "glrpc", { NULL }, 9080, "udp" },
+ { "lcs-ap", { NULL }, 9082, "sctp"},
+ { "emc-pp-mgmtsvc", { NULL }, 9083, "tcp" },
+ { "aurora", { NULL }, 9084, "tcp" },
+ { "aurora", { NULL }, 9084, "udp" },
+ { "aurora", { NULL }, 9084, "sctp"},
+ { "ibm-rsyscon", { NULL }, 9085, "tcp" },
+ { "ibm-rsyscon", { NULL }, 9085, "udp" },
+ { "net2display", { NULL }, 9086, "tcp" },
+ { "net2display", { NULL }, 9086, "udp" },
+ { "classic", { NULL }, 9087, "tcp" },
+ { "classic", { NULL }, 9087, "udp" },
+ { "sqlexec", { NULL }, 9088, "tcp" },
+ { "sqlexec", { NULL }, 9088, "udp" },
+ { "sqlexec-ssl", { NULL }, 9089, "tcp" },
+ { "sqlexec-ssl", { NULL }, 9089, "udp" },
+ { "websm", { NULL }, 9090, "tcp" },
+ { "websm", { NULL }, 9090, "udp" },
+ { "xmltec-xmlmail", { NULL }, 9091, "tcp" },
+ { "xmltec-xmlmail", { NULL }, 9091, "udp" },
+ { "XmlIpcRegSvc", { NULL }, 9092, "tcp" },
+ { "XmlIpcRegSvc", { NULL }, 9092, "udp" },
+ { "hp-pdl-datastr", { NULL }, 9100, "tcp" },
+ { "hp-pdl-datastr", { NULL }, 9100, "udp" },
+ { "pdl-datastream", { NULL }, 9100, "tcp" },
+ { "pdl-datastream", { NULL }, 9100, "udp" },
+ { "bacula-dir", { NULL }, 9101, "tcp" },
+ { "bacula-dir", { NULL }, 9101, "udp" },
+ { "bacula-fd", { NULL }, 9102, "tcp" },
+ { "bacula-fd", { NULL }, 9102, "udp" },
+ { "bacula-sd", { NULL }, 9103, "tcp" },
+ { "bacula-sd", { NULL }, 9103, "udp" },
+ { "peerwire", { NULL }, 9104, "tcp" },
+ { "peerwire", { NULL }, 9104, "udp" },
+ { "xadmin", { NULL }, 9105, "tcp" },
+ { "xadmin", { NULL }, 9105, "udp" },
+ { "astergate", { NULL }, 9106, "tcp" },
+ { "astergate-disc", { NULL }, 9106, "udp" },
+ { "astergatefax", { NULL }, 9107, "tcp" },
+ { "mxit", { NULL }, 9119, "tcp" },
+ { "mxit", { NULL }, 9119, "udp" },
+ { "dddp", { NULL }, 9131, "tcp" },
+ { "dddp", { NULL }, 9131, "udp" },
+ { "apani1", { NULL }, 9160, "tcp" },
+ { "apani1", { NULL }, 9160, "udp" },
+ { "apani2", { NULL }, 9161, "tcp" },
+ { "apani2", { NULL }, 9161, "udp" },
+ { "apani3", { NULL }, 9162, "tcp" },
+ { "apani3", { NULL }, 9162, "udp" },
+ { "apani4", { NULL }, 9163, "tcp" },
+ { "apani4", { NULL }, 9163, "udp" },
+ { "apani5", { NULL }, 9164, "tcp" },
+ { "apani5", { NULL }, 9164, "udp" },
+ { "sun-as-jpda", { NULL }, 9191, "tcp" },
+ { "sun-as-jpda", { NULL }, 9191, "udp" },
+ { "wap-wsp", { NULL }, 9200, "tcp" },
+ { "wap-wsp", { NULL }, 9200, "udp" },
+ { "wap-wsp-wtp", { NULL }, 9201, "tcp" },
+ { "wap-wsp-wtp", { NULL }, 9201, "udp" },
+ { "wap-wsp-s", { NULL }, 9202, "tcp" },
+ { "wap-wsp-s", { NULL }, 9202, "udp" },
+ { "wap-wsp-wtp-s", { NULL }, 9203, "tcp" },
+ { "wap-wsp-wtp-s", { NULL }, 9203, "udp" },
+ { "wap-vcard", { NULL }, 9204, "tcp" },
+ { "wap-vcard", { NULL }, 9204, "udp" },
+ { "wap-vcal", { NULL }, 9205, "tcp" },
+ { "wap-vcal", { NULL }, 9205, "udp" },
+ { "wap-vcard-s", { NULL }, 9206, "tcp" },
+ { "wap-vcard-s", { NULL }, 9206, "udp" },
+ { "wap-vcal-s", { NULL }, 9207, "tcp" },
+ { "wap-vcal-s", { NULL }, 9207, "udp" },
+ { "rjcdb-vcards", { NULL }, 9208, "tcp" },
+ { "rjcdb-vcards", { NULL }, 9208, "udp" },
+ { "almobile-system", { NULL }, 9209, "tcp" },
+ { "almobile-system", { NULL }, 9209, "udp" },
+ { "oma-mlp", { NULL }, 9210, "tcp" },
+ { "oma-mlp", { NULL }, 9210, "udp" },
+ { "oma-mlp-s", { NULL }, 9211, "tcp" },
+ { "oma-mlp-s", { NULL }, 9211, "udp" },
+ { "serverviewdbms", { NULL }, 9212, "tcp" },
+ { "serverviewdbms", { NULL }, 9212, "udp" },
+ { "serverstart", { NULL }, 9213, "tcp" },
+ { "serverstart", { NULL }, 9213, "udp" },
+ { "ipdcesgbs", { NULL }, 9214, "tcp" },
+ { "ipdcesgbs", { NULL }, 9214, "udp" },
+ { "insis", { NULL }, 9215, "tcp" },
+ { "insis", { NULL }, 9215, "udp" },
+ { "acme", { NULL }, 9216, "tcp" },
+ { "acme", { NULL }, 9216, "udp" },
+ { "fsc-port", { NULL }, 9217, "tcp" },
+ { "fsc-port", { NULL }, 9217, "udp" },
+ { "teamcoherence", { NULL }, 9222, "tcp" },
+ { "teamcoherence", { NULL }, 9222, "udp" },
+ { "mon", { NULL }, 9255, "tcp" },
+ { "mon", { NULL }, 9255, "udp" },
+ { "pegasus", { NULL }, 9278, "tcp" },
+ { "pegasus", { NULL }, 9278, "udp" },
+ { "pegasus-ctl", { NULL }, 9279, "tcp" },
+ { "pegasus-ctl", { NULL }, 9279, "udp" },
+ { "pgps", { NULL }, 9280, "tcp" },
+ { "pgps", { NULL }, 9280, "udp" },
+ { "swtp-port1", { NULL }, 9281, "tcp" },
+ { "swtp-port1", { NULL }, 9281, "udp" },
+ { "swtp-port2", { NULL }, 9282, "tcp" },
+ { "swtp-port2", { NULL }, 9282, "udp" },
+ { "callwaveiam", { NULL }, 9283, "tcp" },
+ { "callwaveiam", { NULL }, 9283, "udp" },
+ { "visd", { NULL }, 9284, "tcp" },
+ { "visd", { NULL }, 9284, "udp" },
+ { "n2h2server", { NULL }, 9285, "tcp" },
+ { "n2h2server", { NULL }, 9285, "udp" },
+ { "n2receive", { NULL }, 9286, "udp" },
+ { "cumulus", { NULL }, 9287, "tcp" },
+ { "cumulus", { NULL }, 9287, "udp" },
+ { "armtechdaemon", { NULL }, 9292, "tcp" },
+ { "armtechdaemon", { NULL }, 9292, "udp" },
+ { "storview", { NULL }, 9293, "tcp" },
+ { "storview", { NULL }, 9293, "udp" },
+ { "armcenterhttp", { NULL }, 9294, "tcp" },
+ { "armcenterhttp", { NULL }, 9294, "udp" },
+ { "armcenterhttps", { NULL }, 9295, "tcp" },
+ { "armcenterhttps", { NULL }, 9295, "udp" },
+ { "vrace", { NULL }, 9300, "tcp" },
+ { "vrace", { NULL }, 9300, "udp" },
+ { "sphinxql", { NULL }, 9306, "tcp" },
+ { "sphinxapi", { NULL }, 9312, "tcp" },
+ { "secure-ts", { NULL }, 9318, "tcp" },
+ { "secure-ts", { NULL }, 9318, "udp" },
+ { "guibase", { NULL }, 9321, "tcp" },
+ { "guibase", { NULL }, 9321, "udp" },
+ { "mpidcmgr", { NULL }, 9343, "tcp" },
+ { "mpidcmgr", { NULL }, 9343, "udp" },
+ { "mphlpdmc", { NULL }, 9344, "tcp" },
+ { "mphlpdmc", { NULL }, 9344, "udp" },
+ { "ctechlicensing", { NULL }, 9346, "tcp" },
+ { "ctechlicensing", { NULL }, 9346, "udp" },
+ { "fjdmimgr", { NULL }, 9374, "tcp" },
+ { "fjdmimgr", { NULL }, 9374, "udp" },
+ { "boxp", { NULL }, 9380, "tcp" },
+ { "boxp", { NULL }, 9380, "udp" },
+ { "d2dconfig", { NULL }, 9387, "tcp" },
+ { "d2ddatatrans", { NULL }, 9388, "tcp" },
+ { "adws", { NULL }, 9389, "tcp" },
+ { "otp", { NULL }, 9390, "tcp" },
+ { "fjinvmgr", { NULL }, 9396, "tcp" },
+ { "fjinvmgr", { NULL }, 9396, "udp" },
+ { "mpidcagt", { NULL }, 9397, "tcp" },
+ { "mpidcagt", { NULL }, 9397, "udp" },
+ { "sec-t4net-srv", { NULL }, 9400, "tcp" },
+ { "sec-t4net-srv", { NULL }, 9400, "udp" },
+ { "sec-t4net-clt", { NULL }, 9401, "tcp" },
+ { "sec-t4net-clt", { NULL }, 9401, "udp" },
+ { "sec-pc2fax-srv", { NULL }, 9402, "tcp" },
+ { "sec-pc2fax-srv", { NULL }, 9402, "udp" },
+ { "git", { NULL }, 9418, "tcp" },
+ { "git", { NULL }, 9418, "udp" },
+ { "tungsten-https", { NULL }, 9443, "tcp" },
+ { "tungsten-https", { NULL }, 9443, "udp" },
+ { "wso2esb-console", { NULL }, 9444, "tcp" },
+ { "wso2esb-console", { NULL }, 9444, "udp" },
+ { "sntlkeyssrvr", { NULL }, 9450, "tcp" },
+ { "sntlkeyssrvr", { NULL }, 9450, "udp" },
+ { "ismserver", { NULL }, 9500, "tcp" },
+ { "ismserver", { NULL }, 9500, "udp" },
+ { "sma-spw", { NULL }, 9522, "udp" },
+ { "mngsuite", { NULL }, 9535, "tcp" },
+ { "mngsuite", { NULL }, 9535, "udp" },
+ { "laes-bf", { NULL }, 9536, "tcp" },
+ { "laes-bf", { NULL }, 9536, "udp" },
+ { "trispen-sra", { NULL }, 9555, "tcp" },
+ { "trispen-sra", { NULL }, 9555, "udp" },
+ { "ldgateway", { NULL }, 9592, "tcp" },
+ { "ldgateway", { NULL }, 9592, "udp" },
+ { "cba8", { NULL }, 9593, "tcp" },
+ { "cba8", { NULL }, 9593, "udp" },
+ { "msgsys", { NULL }, 9594, "tcp" },
+ { "msgsys", { NULL }, 9594, "udp" },
+ { "pds", { NULL }, 9595, "tcp" },
+ { "pds", { NULL }, 9595, "udp" },
+ { "mercury-disc", { NULL }, 9596, "tcp" },
+ { "mercury-disc", { NULL }, 9596, "udp" },
+ { "pd-admin", { NULL }, 9597, "tcp" },
+ { "pd-admin", { NULL }, 9597, "udp" },
+ { "vscp", { NULL }, 9598, "tcp" },
+ { "vscp", { NULL }, 9598, "udp" },
+ { "robix", { NULL }, 9599, "tcp" },
+ { "robix", { NULL }, 9599, "udp" },
+ { "micromuse-ncpw", { NULL }, 9600, "tcp" },
+ { "micromuse-ncpw", { NULL }, 9600, "udp" },
+ { "streamcomm-ds", { NULL }, 9612, "tcp" },
+ { "streamcomm-ds", { NULL }, 9612, "udp" },
+ { "iadt-tls", { NULL }, 9614, "tcp" },
+ { "erunbook_agent", { NULL }, 9616, "tcp" },
+ { "erunbook_server", { NULL }, 9617, "tcp" },
+ { "condor", { NULL }, 9618, "tcp" },
+ { "condor", { NULL }, 9618, "udp" },
+ { "odbcpathway", { NULL }, 9628, "tcp" },
+ { "odbcpathway", { NULL }, 9628, "udp" },
+ { "uniport", { NULL }, 9629, "tcp" },
+ { "uniport", { NULL }, 9629, "udp" },
+ { "peoctlr", { NULL }, 9630, "tcp" },
+ { "peocoll", { NULL }, 9631, "tcp" },
+ { "mc-comm", { NULL }, 9632, "udp" },
+ { "pqsflows", { NULL }, 9640, "tcp" },
+ { "xmms2", { NULL }, 9667, "tcp" },
+ { "xmms2", { NULL }, 9667, "udp" },
+ { "tec5-sdctp", { NULL }, 9668, "tcp" },
+ { "tec5-sdctp", { NULL }, 9668, "udp" },
+ { "client-wakeup", { NULL }, 9694, "tcp" },
+ { "client-wakeup", { NULL }, 9694, "udp" },
+ { "ccnx", { NULL }, 9695, "tcp" },
+ { "ccnx", { NULL }, 9695, "udp" },
+ { "board-roar", { NULL }, 9700, "tcp" },
+ { "board-roar", { NULL }, 9700, "udp" },
+ { "l5nas-parchan", { NULL }, 9747, "tcp" },
+ { "l5nas-parchan", { NULL }, 9747, "udp" },
+ { "board-voip", { NULL }, 9750, "tcp" },
+ { "board-voip", { NULL }, 9750, "udp" },
+ { "rasadv", { NULL }, 9753, "tcp" },
+ { "rasadv", { NULL }, 9753, "udp" },
+ { "tungsten-http", { NULL }, 9762, "tcp" },
+ { "tungsten-http", { NULL }, 9762, "udp" },
+ { "davsrc", { NULL }, 9800, "tcp" },
+ { "davsrc", { NULL }, 9800, "udp" },
+ { "sstp-2", { NULL }, 9801, "tcp" },
+ { "sstp-2", { NULL }, 9801, "udp" },
+ { "davsrcs", { NULL }, 9802, "tcp" },
+ { "davsrcs", { NULL }, 9802, "udp" },
+ { "sapv1", { NULL }, 9875, "tcp" },
+ { "sapv1", { NULL }, 9875, "udp" },
+ { "sd", { NULL }, 9876, "tcp" },
+ { "sd", { NULL }, 9876, "udp" },
+ { "cyborg-systems", { NULL }, 9888, "tcp" },
+ { "cyborg-systems", { NULL }, 9888, "udp" },
+ { "gt-proxy", { NULL }, 9889, "tcp" },
+ { "gt-proxy", { NULL }, 9889, "udp" },
+ { "monkeycom", { NULL }, 9898, "tcp" },
+ { "monkeycom", { NULL }, 9898, "udp" },
+ { "sctp-tunneling", { NULL }, 9899, "tcp" },
+ { "sctp-tunneling", { NULL }, 9899, "udp" },
+ { "iua", { NULL }, 9900, "tcp" },
+ { "iua", { NULL }, 9900, "udp" },
+ { "iua", { NULL }, 9900, "sctp"},
+ { "enrp", { NULL }, 9901, "udp" },
+ { "enrp-sctp", { NULL }, 9901, "sctp"},
+ { "enrp-sctp-tls", { NULL }, 9902, "sctp"},
+ { "domaintime", { NULL }, 9909, "tcp" },
+ { "domaintime", { NULL }, 9909, "udp" },
+ { "sype-transport", { NULL }, 9911, "tcp" },
+ { "sype-transport", { NULL }, 9911, "udp" },
+ { "apc-9950", { NULL }, 9950, "tcp" },
+ { "apc-9950", { NULL }, 9950, "udp" },
+ { "apc-9951", { NULL }, 9951, "tcp" },
+ { "apc-9951", { NULL }, 9951, "udp" },
+ { "apc-9952", { NULL }, 9952, "tcp" },
+ { "apc-9952", { NULL }, 9952, "udp" },
+ { "acis", { NULL }, 9953, "tcp" },
+ { "acis", { NULL }, 9953, "udp" },
+ { "odnsp", { NULL }, 9966, "tcp" },
+ { "odnsp", { NULL }, 9966, "udp" },
+ { "dsm-scm-target", { NULL }, 9987, "tcp" },
+ { "dsm-scm-target", { NULL }, 9987, "udp" },
+ { "nsesrvr", { NULL }, 9988, "tcp" },
+ { "osm-appsrvr", { NULL }, 9990, "tcp" },
+ { "osm-appsrvr", { NULL }, 9990, "udp" },
+ { "osm-oev", { NULL }, 9991, "tcp" },
+ { "osm-oev", { NULL }, 9991, "udp" },
+ { "palace-1", { NULL }, 9992, "tcp" },
+ { "palace-1", { NULL }, 9992, "udp" },
+ { "palace-2", { NULL }, 9993, "tcp" },
+ { "palace-2", { NULL }, 9993, "udp" },
+ { "palace-3", { NULL }, 9994, "tcp" },
+ { "palace-3", { NULL }, 9994, "udp" },
+ { "palace-4", { NULL }, 9995, "tcp" },
+ { "palace-4", { NULL }, 9995, "udp" },
+ { "palace-5", { NULL }, 9996, "tcp" },
+ { "palace-5", { NULL }, 9996, "udp" },
+ { "palace-6", { NULL }, 9997, "tcp" },
+ { "palace-6", { NULL }, 9997, "udp" },
+ { "distinct32", { NULL }, 9998, "tcp" },
+ { "distinct32", { NULL }, 9998, "udp" },
+ { "distinct", { NULL }, 9999, "tcp" },
+ { "distinct", { NULL }, 9999, "udp" },
+ { "ndmp", { NULL }, 10000, "tcp" },
+ { "ndmp", { NULL }, 10000, "udp" },
+ { "scp-config", { NULL }, 10001, "tcp" },
+ { "scp-config", { NULL }, 10001, "udp" },
+ { "documentum", { NULL }, 10002, "tcp" },
+ { "documentum", { NULL }, 10002, "udp" },
+ { "documentum_s", { NULL }, 10003, "tcp" },
+ { "documentum_s", { NULL }, 10003, "udp" },
+ { "emcrmirccd", { NULL }, 10004, "tcp" },
+ { "emcrmird", { NULL }, 10005, "tcp" },
+ { "mvs-capacity", { NULL }, 10007, "tcp" },
+ { "mvs-capacity", { NULL }, 10007, "udp" },
+ { "octopus", { NULL }, 10008, "tcp" },
+ { "octopus", { NULL }, 10008, "udp" },
+ { "swdtp-sv", { NULL }, 10009, "tcp" },
+ { "swdtp-sv", { NULL }, 10009, "udp" },
+ { "rxapi", { NULL }, 10010, "tcp" },
+ { "zabbix-agent", { NULL }, 10050, "tcp" },
+ { "zabbix-agent", { NULL }, 10050, "udp" },
+ { "zabbix-trapper", { NULL }, 10051, "tcp" },
+ { "zabbix-trapper", { NULL }, 10051, "udp" },
+ { "qptlmd", { NULL }, 10055, "tcp" },
+ { "amanda", { NULL }, 10080, "tcp" },
+ { "amanda", { NULL }, 10080, "udp" },
+ { "famdc", { NULL }, 10081, "tcp" },
+ { "famdc", { NULL }, 10081, "udp" },
+ { "itap-ddtp", { NULL }, 10100, "tcp" },
+ { "itap-ddtp", { NULL }, 10100, "udp" },
+ { "ezmeeting-2", { NULL }, 10101, "tcp" },
+ { "ezmeeting-2", { NULL }, 10101, "udp" },
+ { "ezproxy-2", { NULL }, 10102, "tcp" },
+ { "ezproxy-2", { NULL }, 10102, "udp" },
+ { "ezrelay", { NULL }, 10103, "tcp" },
+ { "ezrelay", { NULL }, 10103, "udp" },
+ { "swdtp", { NULL }, 10104, "tcp" },
+ { "swdtp", { NULL }, 10104, "udp" },
+ { "bctp-server", { NULL }, 10107, "tcp" },
+ { "bctp-server", { NULL }, 10107, "udp" },
+ { "nmea-0183", { NULL }, 10110, "tcp" },
+ { "nmea-0183", { NULL }, 10110, "udp" },
+ { "netiq-endpoint", { NULL }, 10113, "tcp" },
+ { "netiq-endpoint", { NULL }, 10113, "udp" },
+ { "netiq-qcheck", { NULL }, 10114, "tcp" },
+ { "netiq-qcheck", { NULL }, 10114, "udp" },
+ { "netiq-endpt", { NULL }, 10115, "tcp" },
+ { "netiq-endpt", { NULL }, 10115, "udp" },
+ { "netiq-voipa", { NULL }, 10116, "tcp" },
+ { "netiq-voipa", { NULL }, 10116, "udp" },
+ { "iqrm", { NULL }, 10117, "tcp" },
+ { "iqrm", { NULL }, 10117, "udp" },
+ { "bmc-perf-sd", { NULL }, 10128, "tcp" },
+ { "bmc-perf-sd", { NULL }, 10128, "udp" },
+ { "bmc-gms", { NULL }, 10129, "tcp" },
+ { "qb-db-server", { NULL }, 10160, "tcp" },
+ { "qb-db-server", { NULL }, 10160, "udp" },
+ { "snmptls", { NULL }, 10161, "tcp" },
+ { "snmpdtls", { NULL }, 10161, "udp" },
+ { "snmptls-trap", { NULL }, 10162, "tcp" },
+ { "snmpdtls-trap", { NULL }, 10162, "udp" },
+ { "trisoap", { NULL }, 10200, "tcp" },
+ { "trisoap", { NULL }, 10200, "udp" },
+ { "rsms", { NULL }, 10201, "tcp" },
+ { "rscs", { NULL }, 10201, "udp" },
+ { "apollo-relay", { NULL }, 10252, "tcp" },
+ { "apollo-relay", { NULL }, 10252, "udp" },
+ { "axis-wimp-port", { NULL }, 10260, "tcp" },
+ { "axis-wimp-port", { NULL }, 10260, "udp" },
+ { "blocks", { NULL }, 10288, "tcp" },
+ { "blocks", { NULL }, 10288, "udp" },
+ { "cosir", { NULL }, 10321, "tcp" },
+ { "hip-nat-t", { NULL }, 10500, "udp" },
+ { "MOS-lower", { NULL }, 10540, "tcp" },
+ { "MOS-lower", { NULL }, 10540, "udp" },
+ { "MOS-upper", { NULL }, 10541, "tcp" },
+ { "MOS-upper", { NULL }, 10541, "udp" },
+ { "MOS-aux", { NULL }, 10542, "tcp" },
+ { "MOS-aux", { NULL }, 10542, "udp" },
+ { "MOS-soap", { NULL }, 10543, "tcp" },
+ { "MOS-soap", { NULL }, 10543, "udp" },
+ { "MOS-soap-opt", { NULL }, 10544, "tcp" },
+ { "MOS-soap-opt", { NULL }, 10544, "udp" },
+ { "gap", { NULL }, 10800, "tcp" },
+ { "gap", { NULL }, 10800, "udp" },
+ { "lpdg", { NULL }, 10805, "tcp" },
+ { "lpdg", { NULL }, 10805, "udp" },
+ { "nbd", { NULL }, 10809, "tcp" },
+ { "nmc-disc", { NULL }, 10810, "udp" },
+ { "helix", { NULL }, 10860, "tcp" },
+ { "helix", { NULL }, 10860, "udp" },
+ { "rmiaux", { NULL }, 10990, "tcp" },
+ { "rmiaux", { NULL }, 10990, "udp" },
+ { "irisa", { NULL }, 11000, "tcp" },
+ { "irisa", { NULL }, 11000, "udp" },
+ { "metasys", { NULL }, 11001, "tcp" },
+ { "metasys", { NULL }, 11001, "udp" },
+ { "netapp-icmgmt", { NULL }, 11104, "tcp" },
+ { "netapp-icdata", { NULL }, 11105, "tcp" },
+ { "sgi-lk", { NULL }, 11106, "tcp" },
+ { "sgi-lk", { NULL }, 11106, "udp" },
+ { "vce", { NULL }, 11111, "tcp" },
+ { "vce", { NULL }, 11111, "udp" },
+ { "dicom", { NULL }, 11112, "tcp" },
+ { "dicom", { NULL }, 11112, "udp" },
+ { "suncacao-snmp", { NULL }, 11161, "tcp" },
+ { "suncacao-snmp", { NULL }, 11161, "udp" },
+ { "suncacao-jmxmp", { NULL }, 11162, "tcp" },
+ { "suncacao-jmxmp", { NULL }, 11162, "udp" },
+ { "suncacao-rmi", { NULL }, 11163, "tcp" },
+ { "suncacao-rmi", { NULL }, 11163, "udp" },
+ { "suncacao-csa", { NULL }, 11164, "tcp" },
+ { "suncacao-csa", { NULL }, 11164, "udp" },
+ { "suncacao-websvc", { NULL }, 11165, "tcp" },
+ { "suncacao-websvc", { NULL }, 11165, "udp" },
+ { "snss", { NULL }, 11171, "udp" },
+ { "oemcacao-jmxmp", { NULL }, 11172, "tcp" },
+ { "oemcacao-rmi", { NULL }, 11174, "tcp" },
+ { "oemcacao-websvc", { NULL }, 11175, "tcp" },
+ { "smsqp", { NULL }, 11201, "tcp" },
+ { "smsqp", { NULL }, 11201, "udp" },
+ { "wifree", { NULL }, 11208, "tcp" },
+ { "wifree", { NULL }, 11208, "udp" },
+ { "memcache", { NULL }, 11211, "tcp" },
+ { "memcache", { NULL }, 11211, "udp" },
+ { "imip", { NULL }, 11319, "tcp" },
+ { "imip", { NULL }, 11319, "udp" },
+ { "imip-channels", { NULL }, 11320, "tcp" },
+ { "imip-channels", { NULL }, 11320, "udp" },
+ { "arena-server", { NULL }, 11321, "tcp" },
+ { "arena-server", { NULL }, 11321, "udp" },
+ { "atm-uhas", { NULL }, 11367, "tcp" },
+ { "atm-uhas", { NULL }, 11367, "udp" },
+ { "hkp", { NULL }, 11371, "tcp" },
+ { "hkp", { NULL }, 11371, "udp" },
+ { "asgcypresstcps", { NULL }, 11489, "tcp" },
+ { "tempest-port", { NULL }, 11600, "tcp" },
+ { "tempest-port", { NULL }, 11600, "udp" },
+ { "h323callsigalt", { NULL }, 11720, "tcp" },
+ { "h323callsigalt", { NULL }, 11720, "udp" },
+ { "intrepid-ssl", { NULL }, 11751, "tcp" },
+ { "intrepid-ssl", { NULL }, 11751, "udp" },
+ { "xoraya", { NULL }, 11876, "tcp" },
+ { "xoraya", { NULL }, 11876, "udp" },
+ { "x2e-disc", { NULL }, 11877, "udp" },
+ { "sysinfo-sp", { NULL }, 11967, "tcp" },
+ { "sysinfo-sp", { NULL }, 11967, "udp" },
+ { "wmereceiving", { NULL }, 11997, "sctp"},
+ { "wmedistribution", { NULL }, 11998, "sctp"},
+ { "wmereporting", { NULL }, 11999, "sctp"},
+ { "entextxid", { NULL }, 12000, "tcp" },
+ { "entextxid", { NULL }, 12000, "udp" },
+ { "entextnetwk", { NULL }, 12001, "tcp" },
+ { "entextnetwk", { NULL }, 12001, "udp" },
+ { "entexthigh", { NULL }, 12002, "tcp" },
+ { "entexthigh", { NULL }, 12002, "udp" },
+ { "entextmed", { NULL }, 12003, "tcp" },
+ { "entextmed", { NULL }, 12003, "udp" },
+ { "entextlow", { NULL }, 12004, "tcp" },
+ { "entextlow", { NULL }, 12004, "udp" },
+ { "dbisamserver1", { NULL }, 12005, "tcp" },
+ { "dbisamserver1", { NULL }, 12005, "udp" },
+ { "dbisamserver2", { NULL }, 12006, "tcp" },
+ { "dbisamserver2", { NULL }, 12006, "udp" },
+ { "accuracer", { NULL }, 12007, "tcp" },
+ { "accuracer", { NULL }, 12007, "udp" },
+ { "accuracer-dbms", { NULL }, 12008, "tcp" },
+ { "accuracer-dbms", { NULL }, 12008, "udp" },
+ { "edbsrvr", { NULL }, 12010, "tcp" },
+ { "vipera", { NULL }, 12012, "tcp" },
+ { "vipera", { NULL }, 12012, "udp" },
+ { "vipera-ssl", { NULL }, 12013, "tcp" },
+ { "vipera-ssl", { NULL }, 12013, "udp" },
+ { "rets-ssl", { NULL }, 12109, "tcp" },
+ { "rets-ssl", { NULL }, 12109, "udp" },
+ { "nupaper-ss", { NULL }, 12121, "tcp" },
+ { "nupaper-ss", { NULL }, 12121, "udp" },
+ { "cawas", { NULL }, 12168, "tcp" },
+ { "cawas", { NULL }, 12168, "udp" },
+ { "hivep", { NULL }, 12172, "tcp" },
+ { "hivep", { NULL }, 12172, "udp" },
+ { "linogridengine", { NULL }, 12300, "tcp" },
+ { "linogridengine", { NULL }, 12300, "udp" },
+ { "warehouse-sss", { NULL }, 12321, "tcp" },
+ { "warehouse-sss", { NULL }, 12321, "udp" },
+ { "warehouse", { NULL }, 12322, "tcp" },
+ { "warehouse", { NULL }, 12322, "udp" },
+ { "italk", { NULL }, 12345, "tcp" },
+ { "italk", { NULL }, 12345, "udp" },
+ { "tsaf", { NULL }, 12753, "tcp" },
+ { "tsaf", { NULL }, 12753, "udp" },
+ { "i-zipqd", { NULL }, 13160, "tcp" },
+ { "i-zipqd", { NULL }, 13160, "udp" },
+ { "bcslogc", { NULL }, 13216, "tcp" },
+ { "bcslogc", { NULL }, 13216, "udp" },
+ { "rs-pias", { NULL }, 13217, "tcp" },
+ { "rs-pias", { NULL }, 13217, "udp" },
+ { "emc-vcas-tcp", { NULL }, 13218, "tcp" },
+ { "emc-vcas-udp", { NULL }, 13218, "udp" },
+ { "powwow-client", { NULL }, 13223, "tcp" },
+ { "powwow-client", { NULL }, 13223, "udp" },
+ { "powwow-server", { NULL }, 13224, "tcp" },
+ { "powwow-server", { NULL }, 13224, "udp" },
+ { "doip-data", { NULL }, 13400, "tcp" },
+ { "doip-disc", { NULL }, 13400, "udp" },
+ { "bprd", { NULL }, 13720, "tcp" },
+ { "bprd", { NULL }, 13720, "udp" },
+ { "bpdbm", { NULL }, 13721, "tcp" },
+ { "bpdbm", { NULL }, 13721, "udp" },
+ { "bpjava-msvc", { NULL }, 13722, "tcp" },
+ { "bpjava-msvc", { NULL }, 13722, "udp" },
+ { "vnetd", { NULL }, 13724, "tcp" },
+ { "vnetd", { NULL }, 13724, "udp" },
+ { "bpcd", { NULL }, 13782, "tcp" },
+ { "bpcd", { NULL }, 13782, "udp" },
+ { "vopied", { NULL }, 13783, "tcp" },
+ { "vopied", { NULL }, 13783, "udp" },
+ { "nbdb", { NULL }, 13785, "tcp" },
+ { "nbdb", { NULL }, 13785, "udp" },
+ { "nomdb", { NULL }, 13786, "tcp" },
+ { "nomdb", { NULL }, 13786, "udp" },
+ { "dsmcc-config", { NULL }, 13818, "tcp" },
+ { "dsmcc-config", { NULL }, 13818, "udp" },
+ { "dsmcc-session", { NULL }, 13819, "tcp" },
+ { "dsmcc-session", { NULL }, 13819, "udp" },
+ { "dsmcc-passthru", { NULL }, 13820, "tcp" },
+ { "dsmcc-passthru", { NULL }, 13820, "udp" },
+ { "dsmcc-download", { NULL }, 13821, "tcp" },
+ { "dsmcc-download", { NULL }, 13821, "udp" },
+ { "dsmcc-ccp", { NULL }, 13822, "tcp" },
+ { "dsmcc-ccp", { NULL }, 13822, "udp" },
+ { "bmdss", { NULL }, 13823, "tcp" },
+ { "dta-systems", { NULL }, 13929, "tcp" },
+ { "dta-systems", { NULL }, 13929, "udp" },
+ { "medevolve", { NULL }, 13930, "tcp" },
+ { "scotty-ft", { NULL }, 14000, "tcp" },
+ { "scotty-ft", { NULL }, 14000, "udp" },
+ { "sua", { NULL }, 14001, "tcp" },
+ { "sua", { NULL }, 14001, "udp" },
+ { "sua", { NULL }, 14001, "sctp"},
+ { "sage-best-com1", { NULL }, 14033, "tcp" },
+ { "sage-best-com1", { NULL }, 14033, "udp" },
+ { "sage-best-com2", { NULL }, 14034, "tcp" },
+ { "sage-best-com2", { NULL }, 14034, "udp" },
+ { "vcs-app", { NULL }, 14141, "tcp" },
+ { "vcs-app", { NULL }, 14141, "udp" },
+ { "icpp", { NULL }, 14142, "tcp" },
+ { "icpp", { NULL }, 14142, "udp" },
+ { "gcm-app", { NULL }, 14145, "tcp" },
+ { "gcm-app", { NULL }, 14145, "udp" },
+ { "vrts-tdd", { NULL }, 14149, "tcp" },
+ { "vrts-tdd", { NULL }, 14149, "udp" },
+ { "vcscmd", { NULL }, 14150, "tcp" },
+ { "vad", { NULL }, 14154, "tcp" },
+ { "vad", { NULL }, 14154, "udp" },
+ { "cps", { NULL }, 14250, "tcp" },
+ { "cps", { NULL }, 14250, "udp" },
+ { "ca-web-update", { NULL }, 14414, "tcp" },
+ { "ca-web-update", { NULL }, 14414, "udp" },
+ { "hde-lcesrvr-1", { NULL }, 14936, "tcp" },
+ { "hde-lcesrvr-1", { NULL }, 14936, "udp" },
+ { "hde-lcesrvr-2", { NULL }, 14937, "tcp" },
+ { "hde-lcesrvr-2", { NULL }, 14937, "udp" },
+ { "hydap", { NULL }, 15000, "tcp" },
+ { "hydap", { NULL }, 15000, "udp" },
+ { "xpilot", { NULL }, 15345, "tcp" },
+ { "xpilot", { NULL }, 15345, "udp" },
+ { "3link", { NULL }, 15363, "tcp" },
+ { "3link", { NULL }, 15363, "udp" },
+ { "cisco-snat", { NULL }, 15555, "tcp" },
+ { "cisco-snat", { NULL }, 15555, "udp" },
+ { "bex-xr", { NULL }, 15660, "tcp" },
+ { "bex-xr", { NULL }, 15660, "udp" },
+ { "ptp", { NULL }, 15740, "tcp" },
+ { "ptp", { NULL }, 15740, "udp" },
+ { "2ping", { NULL }, 15998, "udp" },
+ { "programmar", { NULL }, 15999, "tcp" },
+ { "fmsas", { NULL }, 16000, "tcp" },
+ { "fmsascon", { NULL }, 16001, "tcp" },
+ { "gsms", { NULL }, 16002, "tcp" },
+ { "alfin", { NULL }, 16003, "udp" },
+ { "jwpc", { NULL }, 16020, "tcp" },
+ { "jwpc-bin", { NULL }, 16021, "tcp" },
+ { "sun-sea-port", { NULL }, 16161, "tcp" },
+ { "sun-sea-port", { NULL }, 16161, "udp" },
+ { "solaris-audit", { NULL }, 16162, "tcp" },
+ { "etb4j", { NULL }, 16309, "tcp" },
+ { "etb4j", { NULL }, 16309, "udp" },
+ { "pduncs", { NULL }, 16310, "tcp" },
+ { "pduncs", { NULL }, 16310, "udp" },
+ { "pdefmns", { NULL }, 16311, "tcp" },
+ { "pdefmns", { NULL }, 16311, "udp" },
+ { "netserialext1", { NULL }, 16360, "tcp" },
+ { "netserialext1", { NULL }, 16360, "udp" },
+ { "netserialext2", { NULL }, 16361, "tcp" },
+ { "netserialext2", { NULL }, 16361, "udp" },
+ { "netserialext3", { NULL }, 16367, "tcp" },
+ { "netserialext3", { NULL }, 16367, "udp" },
+ { "netserialext4", { NULL }, 16368, "tcp" },
+ { "netserialext4", { NULL }, 16368, "udp" },
+ { "connected", { NULL }, 16384, "tcp" },
+ { "connected", { NULL }, 16384, "udp" },
+ { "xoms", { NULL }, 16619, "tcp" },
+ { "newbay-snc-mc", { NULL }, 16900, "tcp" },
+ { "newbay-snc-mc", { NULL }, 16900, "udp" },
+ { "sgcip", { NULL }, 16950, "tcp" },
+ { "sgcip", { NULL }, 16950, "udp" },
+ { "intel-rci-mp", { NULL }, 16991, "tcp" },
+ { "intel-rci-mp", { NULL }, 16991, "udp" },
+ { "amt-soap-http", { NULL }, 16992, "tcp" },
+ { "amt-soap-http", { NULL }, 16992, "udp" },
+ { "amt-soap-https", { NULL }, 16993, "tcp" },
+ { "amt-soap-https", { NULL }, 16993, "udp" },
+ { "amt-redir-tcp", { NULL }, 16994, "tcp" },
+ { "amt-redir-tcp", { NULL }, 16994, "udp" },
+ { "amt-redir-tls", { NULL }, 16995, "tcp" },
+ { "amt-redir-tls", { NULL }, 16995, "udp" },
+ { "isode-dua", { NULL }, 17007, "tcp" },
+ { "isode-dua", { NULL }, 17007, "udp" },
+ { "soundsvirtual", { NULL }, 17185, "tcp" },
+ { "soundsvirtual", { NULL }, 17185, "udp" },
+ { "chipper", { NULL }, 17219, "tcp" },
+ { "chipper", { NULL }, 17219, "udp" },
+ { "integrius-stp", { NULL }, 17234, "tcp" },
+ { "integrius-stp", { NULL }, 17234, "udp" },
+ { "ssh-mgmt", { NULL }, 17235, "tcp" },
+ { "ssh-mgmt", { NULL }, 17235, "udp" },
+ { "db-lsp", { NULL }, 17500, "tcp" },
+ { "db-lsp-disc", { NULL }, 17500, "udp" },
+ { "ea", { NULL }, 17729, "tcp" },
+ { "ea", { NULL }, 17729, "udp" },
+ { "zep", { NULL }, 17754, "tcp" },
+ { "zep", { NULL }, 17754, "udp" },
+ { "zigbee-ip", { NULL }, 17755, "tcp" },
+ { "zigbee-ip", { NULL }, 17755, "udp" },
+ { "zigbee-ips", { NULL }, 17756, "tcp" },
+ { "zigbee-ips", { NULL }, 17756, "udp" },
+ { "sw-orion", { NULL }, 17777, "tcp" },
+ { "biimenu", { NULL }, 18000, "tcp" },
+ { "biimenu", { NULL }, 18000, "udp" },
+ { "radpdf", { NULL }, 18104, "tcp" },
+ { "racf", { NULL }, 18136, "tcp" },
+ { "opsec-cvp", { NULL }, 18181, "tcp" },
+ { "opsec-cvp", { NULL }, 18181, "udp" },
+ { "opsec-ufp", { NULL }, 18182, "tcp" },
+ { "opsec-ufp", { NULL }, 18182, "udp" },
+ { "opsec-sam", { NULL }, 18183, "tcp" },
+ { "opsec-sam", { NULL }, 18183, "udp" },
+ { "opsec-lea", { NULL }, 18184, "tcp" },
+ { "opsec-lea", { NULL }, 18184, "udp" },
+ { "opsec-omi", { NULL }, 18185, "tcp" },
+ { "opsec-omi", { NULL }, 18185, "udp" },
+ { "ohsc", { NULL }, 18186, "tcp" },
+ { "ohsc", { NULL }, 18186, "udp" },
+ { "opsec-ela", { NULL }, 18187, "tcp" },
+ { "opsec-ela", { NULL }, 18187, "udp" },
+ { "checkpoint-rtm", { NULL }, 18241, "tcp" },
+ { "checkpoint-rtm", { NULL }, 18241, "udp" },
+ { "gv-pf", { NULL }, 18262, "tcp" },
+ { "gv-pf", { NULL }, 18262, "udp" },
+ { "ac-cluster", { NULL }, 18463, "tcp" },
+ { "ac-cluster", { NULL }, 18463, "udp" },
+ { "rds-ib", { NULL }, 18634, "tcp" },
+ { "rds-ib", { NULL }, 18634, "udp" },
+ { "rds-ip", { NULL }, 18635, "tcp" },
+ { "rds-ip", { NULL }, 18635, "udp" },
+ { "ique", { NULL }, 18769, "tcp" },
+ { "ique", { NULL }, 18769, "udp" },
+ { "infotos", { NULL }, 18881, "tcp" },
+ { "infotos", { NULL }, 18881, "udp" },
+ { "apc-necmp", { NULL }, 18888, "tcp" },
+ { "apc-necmp", { NULL }, 18888, "udp" },
+ { "igrid", { NULL }, 19000, "tcp" },
+ { "igrid", { NULL }, 19000, "udp" },
+ { "j-link", { NULL }, 19020, "tcp" },
+ { "opsec-uaa", { NULL }, 19191, "tcp" },
+ { "opsec-uaa", { NULL }, 19191, "udp" },
+ { "ua-secureagent", { NULL }, 19194, "tcp" },
+ { "ua-secureagent", { NULL }, 19194, "udp" },
+ { "keysrvr", { NULL }, 19283, "tcp" },
+ { "keysrvr", { NULL }, 19283, "udp" },
+ { "keyshadow", { NULL }, 19315, "tcp" },
+ { "keyshadow", { NULL }, 19315, "udp" },
+ { "mtrgtrans", { NULL }, 19398, "tcp" },
+ { "mtrgtrans", { NULL }, 19398, "udp" },
+ { "hp-sco", { NULL }, 19410, "tcp" },
+ { "hp-sco", { NULL }, 19410, "udp" },
+ { "hp-sca", { NULL }, 19411, "tcp" },
+ { "hp-sca", { NULL }, 19411, "udp" },
+ { "hp-sessmon", { NULL }, 19412, "tcp" },
+ { "hp-sessmon", { NULL }, 19412, "udp" },
+ { "fxuptp", { NULL }, 19539, "tcp" },
+ { "fxuptp", { NULL }, 19539, "udp" },
+ { "sxuptp", { NULL }, 19540, "tcp" },
+ { "sxuptp", { NULL }, 19540, "udp" },
+ { "jcp", { NULL }, 19541, "tcp" },
+ { "jcp", { NULL }, 19541, "udp" },
+ { "iec-104-sec", { NULL }, 19998, "tcp" },
+ { "dnp-sec", { NULL }, 19999, "tcp" },
+ { "dnp-sec", { NULL }, 19999, "udp" },
+ { "dnp", { NULL }, 20000, "tcp" },
+ { "dnp", { NULL }, 20000, "udp" },
+ { "microsan", { NULL }, 20001, "tcp" },
+ { "microsan", { NULL }, 20001, "udp" },
+ { "commtact-http", { NULL }, 20002, "tcp" },
+ { "commtact-http", { NULL }, 20002, "udp" },
+ { "commtact-https", { NULL }, 20003, "tcp" },
+ { "commtact-https", { NULL }, 20003, "udp" },
+ { "openwebnet", { NULL }, 20005, "tcp" },
+ { "openwebnet", { NULL }, 20005, "udp" },
+ { "ss-idi-disc", { NULL }, 20012, "udp" },
+ { "ss-idi", { NULL }, 20013, "tcp" },
+ { "opendeploy", { NULL }, 20014, "tcp" },
+ { "opendeploy", { NULL }, 20014, "udp" },
+ { "nburn_id", { NULL }, 20034, "tcp" },
+ { "nburn_id", { NULL }, 20034, "udp" },
+ { "tmophl7mts", { NULL }, 20046, "tcp" },
+ { "tmophl7mts", { NULL }, 20046, "udp" },
+ { "mountd", { NULL }, 20048, "tcp" },
+ { "mountd", { NULL }, 20048, "udp" },
+ { "nfsrdma", { NULL }, 20049, "tcp" },
+ { "nfsrdma", { NULL }, 20049, "udp" },
+ { "nfsrdma", { NULL }, 20049, "sctp"},
+ { "tolfab", { NULL }, 20167, "tcp" },
+ { "tolfab", { NULL }, 20167, "udp" },
+ { "ipdtp-port", { NULL }, 20202, "tcp" },
+ { "ipdtp-port", { NULL }, 20202, "udp" },
+ { "ipulse-ics", { NULL }, 20222, "tcp" },
+ { "ipulse-ics", { NULL }, 20222, "udp" },
+ { "emwavemsg", { NULL }, 20480, "tcp" },
+ { "emwavemsg", { NULL }, 20480, "udp" },
+ { "track", { NULL }, 20670, "tcp" },
+ { "track", { NULL }, 20670, "udp" },
+ { "athand-mmp", { NULL }, 20999, "tcp" },
+ { "athand-mmp", { NULL }, 20999, "udp" },
+ { "irtrans", { NULL }, 21000, "tcp" },
+ { "irtrans", { NULL }, 21000, "udp" },
+ { "dfserver", { NULL }, 21554, "tcp" },
+ { "dfserver", { NULL }, 21554, "udp" },
+ { "vofr-gateway", { NULL }, 21590, "tcp" },
+ { "vofr-gateway", { NULL }, 21590, "udp" },
+ { "tvpm", { NULL }, 21800, "tcp" },
+ { "tvpm", { NULL }, 21800, "udp" },
+ { "webphone", { NULL }, 21845, "tcp" },
+ { "webphone", { NULL }, 21845, "udp" },
+ { "netspeak-is", { NULL }, 21846, "tcp" },
+ { "netspeak-is", { NULL }, 21846, "udp" },
+ { "netspeak-cs", { NULL }, 21847, "tcp" },
+ { "netspeak-cs", { NULL }, 21847, "udp" },
+ { "netspeak-acd", { NULL }, 21848, "tcp" },
+ { "netspeak-acd", { NULL }, 21848, "udp" },
+ { "netspeak-cps", { NULL }, 21849, "tcp" },
+ { "netspeak-cps", { NULL }, 21849, "udp" },
+ { "snapenetio", { NULL }, 22000, "tcp" },
+ { "snapenetio", { NULL }, 22000, "udp" },
+ { "optocontrol", { NULL }, 22001, "tcp" },
+ { "optocontrol", { NULL }, 22001, "udp" },
+ { "optohost002", { NULL }, 22002, "tcp" },
+ { "optohost002", { NULL }, 22002, "udp" },
+ { "optohost003", { NULL }, 22003, "tcp" },
+ { "optohost003", { NULL }, 22003, "udp" },
+ { "optohost004", { NULL }, 22004, "tcp" },
+ { "optohost004", { NULL }, 22004, "udp" },
+ { "optohost004", { NULL }, 22005, "tcp" },
+ { "optohost004", { NULL }, 22005, "udp" },
+ { "dcap", { NULL }, 22125, "tcp" },
+ { "gsidcap", { NULL }, 22128, "tcp" },
+ { "wnn6", { NULL }, 22273, "tcp" },
+ { "wnn6", { NULL }, 22273, "udp" },
+ { "cis", { NULL }, 22305, "tcp" },
+ { "cis", { NULL }, 22305, "udp" },
+ { "cis-secure", { NULL }, 22343, "tcp" },
+ { "cis-secure", { NULL }, 22343, "udp" },
+ { "WibuKey", { NULL }, 22347, "tcp" },
+ { "WibuKey", { NULL }, 22347, "udp" },
+ { "CodeMeter", { NULL }, 22350, "tcp" },
+ { "CodeMeter", { NULL }, 22350, "udp" },
+ { "vocaltec-wconf", { NULL }, 22555, "tcp" },
+ { "vocaltec-phone", { NULL }, 22555, "udp" },
+ { "talikaserver", { NULL }, 22763, "tcp" },
+ { "talikaserver", { NULL }, 22763, "udp" },
+ { "aws-brf", { NULL }, 22800, "tcp" },
+ { "aws-brf", { NULL }, 22800, "udp" },
+ { "brf-gw", { NULL }, 22951, "tcp" },
+ { "brf-gw", { NULL }, 22951, "udp" },
+ { "inovaport1", { NULL }, 23000, "tcp" },
+ { "inovaport1", { NULL }, 23000, "udp" },
+ { "inovaport2", { NULL }, 23001, "tcp" },
+ { "inovaport2", { NULL }, 23001, "udp" },
+ { "inovaport3", { NULL }, 23002, "tcp" },
+ { "inovaport3", { NULL }, 23002, "udp" },
+ { "inovaport4", { NULL }, 23003, "tcp" },
+ { "inovaport4", { NULL }, 23003, "udp" },
+ { "inovaport5", { NULL }, 23004, "tcp" },
+ { "inovaport5", { NULL }, 23004, "udp" },
+ { "inovaport6", { NULL }, 23005, "tcp" },
+ { "inovaport6", { NULL }, 23005, "udp" },
+ { "s102", { NULL }, 23272, "udp" },
+ { "elxmgmt", { NULL }, 23333, "tcp" },
+ { "elxmgmt", { NULL }, 23333, "udp" },
+ { "novar-dbase", { NULL }, 23400, "tcp" },
+ { "novar-dbase", { NULL }, 23400, "udp" },
+ { "novar-alarm", { NULL }, 23401, "tcp" },
+ { "novar-alarm", { NULL }, 23401, "udp" },
+ { "novar-global", { NULL }, 23402, "tcp" },
+ { "novar-global", { NULL }, 23402, "udp" },
+ { "aequus", { NULL }, 23456, "tcp" },
+ { "aequus-alt", { NULL }, 23457, "tcp" },
+ { "med-ltp", { NULL }, 24000, "tcp" },
+ { "med-ltp", { NULL }, 24000, "udp" },
+ { "med-fsp-rx", { NULL }, 24001, "tcp" },
+ { "med-fsp-rx", { NULL }, 24001, "udp" },
+ { "med-fsp-tx", { NULL }, 24002, "tcp" },
+ { "med-fsp-tx", { NULL }, 24002, "udp" },
+ { "med-supp", { NULL }, 24003, "tcp" },
+ { "med-supp", { NULL }, 24003, "udp" },
+ { "med-ovw", { NULL }, 24004, "tcp" },
+ { "med-ovw", { NULL }, 24004, "udp" },
+ { "med-ci", { NULL }, 24005, "tcp" },
+ { "med-ci", { NULL }, 24005, "udp" },
+ { "med-net-svc", { NULL }, 24006, "tcp" },
+ { "med-net-svc", { NULL }, 24006, "udp" },
+ { "filesphere", { NULL }, 24242, "tcp" },
+ { "filesphere", { NULL }, 24242, "udp" },
+ { "vista-4gl", { NULL }, 24249, "tcp" },
+ { "vista-4gl", { NULL }, 24249, "udp" },
+ { "ild", { NULL }, 24321, "tcp" },
+ { "ild", { NULL }, 24321, "udp" },
+ { "intel_rci", { NULL }, 24386, "tcp" },
+ { "intel_rci", { NULL }, 24386, "udp" },
+ { "tonidods", { NULL }, 24465, "tcp" },
+ { "tonidods", { NULL }, 24465, "udp" },
+ { "binkp", { NULL }, 24554, "tcp" },
+ { "binkp", { NULL }, 24554, "udp" },
+ { "canditv", { NULL }, 24676, "tcp" },
+ { "canditv", { NULL }, 24676, "udp" },
+ { "flashfiler", { NULL }, 24677, "tcp" },
+ { "flashfiler", { NULL }, 24677, "udp" },
+ { "proactivate", { NULL }, 24678, "tcp" },
+ { "proactivate", { NULL }, 24678, "udp" },
+ { "tcc-http", { NULL }, 24680, "tcp" },
+ { "tcc-http", { NULL }, 24680, "udp" },
+ { "cslg", { NULL }, 24754, "tcp" },
+ { "find", { NULL }, 24922, "tcp" },
+ { "find", { NULL }, 24922, "udp" },
+ { "icl-twobase1", { NULL }, 25000, "tcp" },
+ { "icl-twobase1", { NULL }, 25000, "udp" },
+ { "icl-twobase2", { NULL }, 25001, "tcp" },
+ { "icl-twobase2", { NULL }, 25001, "udp" },
+ { "icl-twobase3", { NULL }, 25002, "tcp" },
+ { "icl-twobase3", { NULL }, 25002, "udp" },
+ { "icl-twobase4", { NULL }, 25003, "tcp" },
+ { "icl-twobase4", { NULL }, 25003, "udp" },
+ { "icl-twobase5", { NULL }, 25004, "tcp" },
+ { "icl-twobase5", { NULL }, 25004, "udp" },
+ { "icl-twobase6", { NULL }, 25005, "tcp" },
+ { "icl-twobase6", { NULL }, 25005, "udp" },
+ { "icl-twobase7", { NULL }, 25006, "tcp" },
+ { "icl-twobase7", { NULL }, 25006, "udp" },
+ { "icl-twobase8", { NULL }, 25007, "tcp" },
+ { "icl-twobase8", { NULL }, 25007, "udp" },
+ { "icl-twobase9", { NULL }, 25008, "tcp" },
+ { "icl-twobase9", { NULL }, 25008, "udp" },
+ { "icl-twobase10", { NULL }, 25009, "tcp" },
+ { "icl-twobase10", { NULL }, 25009, "udp" },
+ { "rna", { NULL }, 25471, "sctp"},
+ { "sauterdongle", { NULL }, 25576, "tcp" },
+ { "vocaltec-hos", { NULL }, 25793, "tcp" },
+ { "vocaltec-hos", { NULL }, 25793, "udp" },
+ { "tasp-net", { NULL }, 25900, "tcp" },
+ { "tasp-net", { NULL }, 25900, "udp" },
+ { "niobserver", { NULL }, 25901, "tcp" },
+ { "niobserver", { NULL }, 25901, "udp" },
+ { "nilinkanalyst", { NULL }, 25902, "tcp" },
+ { "nilinkanalyst", { NULL }, 25902, "udp" },
+ { "niprobe", { NULL }, 25903, "tcp" },
+ { "niprobe", { NULL }, 25903, "udp" },
+ { "quake", { NULL }, 26000, "tcp" },
+ { "quake", { NULL }, 26000, "udp" },
+ { "scscp", { NULL }, 26133, "tcp" },
+ { "scscp", { NULL }, 26133, "udp" },
+ { "wnn6-ds", { NULL }, 26208, "tcp" },
+ { "wnn6-ds", { NULL }, 26208, "udp" },
+ { "ezproxy", { NULL }, 26260, "tcp" },
+ { "ezproxy", { NULL }, 26260, "udp" },
+ { "ezmeeting", { NULL }, 26261, "tcp" },
+ { "ezmeeting", { NULL }, 26261, "udp" },
+ { "k3software-svr", { NULL }, 26262, "tcp" },
+ { "k3software-svr", { NULL }, 26262, "udp" },
+ { "k3software-cli", { NULL }, 26263, "tcp" },
+ { "k3software-cli", { NULL }, 26263, "udp" },
+ { "exoline-tcp", { NULL }, 26486, "tcp" },
+ { "exoline-udp", { NULL }, 26486, "udp" },
+ { "exoconfig", { NULL }, 26487, "tcp" },
+ { "exoconfig", { NULL }, 26487, "udp" },
+ { "exonet", { NULL }, 26489, "tcp" },
+ { "exonet", { NULL }, 26489, "udp" },
+ { "imagepump", { NULL }, 27345, "tcp" },
+ { "imagepump", { NULL }, 27345, "udp" },
+ { "jesmsjc", { NULL }, 27442, "tcp" },
+ { "jesmsjc", { NULL }, 27442, "udp" },
+ { "kopek-httphead", { NULL }, 27504, "tcp" },
+ { "kopek-httphead", { NULL }, 27504, "udp" },
+ { "ars-vista", { NULL }, 27782, "tcp" },
+ { "ars-vista", { NULL }, 27782, "udp" },
+ { "tw-auth-key", { NULL }, 27999, "tcp" },
+ { "tw-auth-key", { NULL }, 27999, "udp" },
+ { "nxlmd", { NULL }, 28000, "tcp" },
+ { "nxlmd", { NULL }, 28000, "udp" },
+ { "pqsp", { NULL }, 28001, "tcp" },
+ { "siemensgsm", { NULL }, 28240, "tcp" },
+ { "siemensgsm", { NULL }, 28240, "udp" },
+ { "sgsap", { NULL }, 29118, "sctp"},
+ { "otmp", { NULL }, 29167, "tcp" },
+ { "otmp", { NULL }, 29167, "udp" },
+ { "sbcap", { NULL }, 29168, "sctp"},
+ { "iuhsctpassoc", { NULL }, 29169, "sctp"},
+ { "pago-services1", { NULL }, 30001, "tcp" },
+ { "pago-services1", { NULL }, 30001, "udp" },
+ { "pago-services2", { NULL }, 30002, "tcp" },
+ { "pago-services2", { NULL }, 30002, "udp" },
+ { "kingdomsonline", { NULL }, 30260, "tcp" },
+ { "kingdomsonline", { NULL }, 30260, "udp" },
+ { "ovobs", { NULL }, 30999, "tcp" },
+ { "ovobs", { NULL }, 30999, "udp" },
+ { "autotrac-acp", { NULL }, 31020, "tcp" },
+ { "yawn", { NULL }, 31029, "udp" },
+ { "xqosd", { NULL }, 31416, "tcp" },
+ { "xqosd", { NULL }, 31416, "udp" },
+ { "tetrinet", { NULL }, 31457, "tcp" },
+ { "tetrinet", { NULL }, 31457, "udp" },
+ { "lm-mon", { NULL }, 31620, "tcp" },
+ { "lm-mon", { NULL }, 31620, "udp" },
+ { "dsx_monitor", { NULL }, 31685, "tcp" },
+ { "gamesmith-port", { NULL }, 31765, "tcp" },
+ { "gamesmith-port", { NULL }, 31765, "udp" },
+ { "iceedcp_tx", { NULL }, 31948, "tcp" },
+ { "iceedcp_tx", { NULL }, 31948, "udp" },
+ { "iceedcp_rx", { NULL }, 31949, "tcp" },
+ { "iceedcp_rx", { NULL }, 31949, "udp" },
+ { "iracinghelper", { NULL }, 32034, "tcp" },
+ { "iracinghelper", { NULL }, 32034, "udp" },
+ { "t1distproc60", { NULL }, 32249, "tcp" },
+ { "t1distproc60", { NULL }, 32249, "udp" },
+ { "apm-link", { NULL }, 32483, "tcp" },
+ { "apm-link", { NULL }, 32483, "udp" },
+ { "sec-ntb-clnt", { NULL }, 32635, "tcp" },
+ { "sec-ntb-clnt", { NULL }, 32635, "udp" },
+ { "DMExpress", { NULL }, 32636, "tcp" },
+ { "DMExpress", { NULL }, 32636, "udp" },
+ { "filenet-powsrm", { NULL }, 32767, "tcp" },
+ { "filenet-powsrm", { NULL }, 32767, "udp" },
+ { "filenet-tms", { NULL }, 32768, "tcp" },
+ { "filenet-tms", { NULL }, 32768, "udp" },
+ { "filenet-rpc", { NULL }, 32769, "tcp" },
+ { "filenet-rpc", { NULL }, 32769, "udp" },
+ { "filenet-nch", { NULL }, 32770, "tcp" },
+ { "filenet-nch", { NULL }, 32770, "udp" },
+ { "filenet-rmi", { NULL }, 32771, "tcp" },
+ { "filenet-rmi", { NULL }, 32771, "udp" },
+ { "filenet-pa", { NULL }, 32772, "tcp" },
+ { "filenet-pa", { NULL }, 32772, "udp" },
+ { "filenet-cm", { NULL }, 32773, "tcp" },
+ { "filenet-cm", { NULL }, 32773, "udp" },
+ { "filenet-re", { NULL }, 32774, "tcp" },
+ { "filenet-re", { NULL }, 32774, "udp" },
+ { "filenet-pch", { NULL }, 32775, "tcp" },
+ { "filenet-pch", { NULL }, 32775, "udp" },
+ { "filenet-peior", { NULL }, 32776, "tcp" },
+ { "filenet-peior", { NULL }, 32776, "udp" },
+ { "filenet-obrok", { NULL }, 32777, "tcp" },
+ { "filenet-obrok", { NULL }, 32777, "udp" },
+ { "mlsn", { NULL }, 32801, "tcp" },
+ { "mlsn", { NULL }, 32801, "udp" },
+ { "retp", { NULL }, 32811, "tcp" },
+ { "idmgratm", { NULL }, 32896, "tcp" },
+ { "idmgratm", { NULL }, 32896, "udp" },
+ { "aurora-balaena", { NULL }, 33123, "tcp" },
+ { "aurora-balaena", { NULL }, 33123, "udp" },
+ { "diamondport", { NULL }, 33331, "tcp" },
+ { "diamondport", { NULL }, 33331, "udp" },
+ { "dgi-serv", { NULL }, 33333, "tcp" },
+ { "traceroute", { NULL }, 33434, "tcp" },
+ { "traceroute", { NULL }, 33434, "udp" },
+ { "snip-slave", { NULL }, 33656, "tcp" },
+ { "snip-slave", { NULL }, 33656, "udp" },
+ { "turbonote-2", { NULL }, 34249, "tcp" },
+ { "turbonote-2", { NULL }, 34249, "udp" },
+ { "p-net-local", { NULL }, 34378, "tcp" },
+ { "p-net-local", { NULL }, 34378, "udp" },
+ { "p-net-remote", { NULL }, 34379, "tcp" },
+ { "p-net-remote", { NULL }, 34379, "udp" },
+ { "dhanalakshmi", { NULL }, 34567, "tcp" },
+ { "profinet-rt", { NULL }, 34962, "tcp" },
+ { "profinet-rt", { NULL }, 34962, "udp" },
+ { "profinet-rtm", { NULL }, 34963, "tcp" },
+ { "profinet-rtm", { NULL }, 34963, "udp" },
+ { "profinet-cm", { NULL }, 34964, "tcp" },
+ { "profinet-cm", { NULL }, 34964, "udp" },
+ { "ethercat", { NULL }, 34980, "tcp" },
+ { "ethercat", { NULL }, 34980, "udp" },
+ { "allpeers", { NULL }, 36001, "tcp" },
+ { "allpeers", { NULL }, 36001, "udp" },
+ { "s1-control", { NULL }, 36412, "sctp"},
+ { "x2-control", { NULL }, 36422, "sctp"},
+ { "m2ap", { NULL }, 36443, "sctp"},
+ { "m3ap", { NULL }, 36444, "sctp"},
+ { "kastenxpipe", { NULL }, 36865, "tcp" },
+ { "kastenxpipe", { NULL }, 36865, "udp" },
+ { "neckar", { NULL }, 37475, "tcp" },
+ { "neckar", { NULL }, 37475, "udp" },
+ { "unisys-eportal", { NULL }, 37654, "tcp" },
+ { "unisys-eportal", { NULL }, 37654, "udp" },
+ { "galaxy7-data", { NULL }, 38201, "tcp" },
+ { "galaxy7-data", { NULL }, 38201, "udp" },
+ { "fairview", { NULL }, 38202, "tcp" },
+ { "fairview", { NULL }, 38202, "udp" },
+ { "agpolicy", { NULL }, 38203, "tcp" },
+ { "agpolicy", { NULL }, 38203, "udp" },
+ { "turbonote-1", { NULL }, 39681, "tcp" },
+ { "turbonote-1", { NULL }, 39681, "udp" },
+ { "safetynetp", { NULL }, 40000, "tcp" },
+ { "safetynetp", { NULL }, 40000, "udp" },
+ { "cscp", { NULL }, 40841, "tcp" },
+ { "cscp", { NULL }, 40841, "udp" },
+ { "csccredir", { NULL }, 40842, "tcp" },
+ { "csccredir", { NULL }, 40842, "udp" },
+ { "csccfirewall", { NULL }, 40843, "tcp" },
+ { "csccfirewall", { NULL }, 40843, "udp" },
+ { "ortec-disc", { NULL }, 40853, "udp" },
+ { "fs-qos", { NULL }, 41111, "tcp" },
+ { "fs-qos", { NULL }, 41111, "udp" },
+ { "tentacle", { NULL }, 41121, "tcp" },
+ { "crestron-cip", { NULL }, 41794, "tcp" },
+ { "crestron-cip", { NULL }, 41794, "udp" },
+ { "crestron-ctp", { NULL }, 41795, "tcp" },
+ { "crestron-ctp", { NULL }, 41795, "udp" },
+ { "candp", { NULL }, 42508, "tcp" },
+ { "candp", { NULL }, 42508, "udp" },
+ { "candrp", { NULL }, 42509, "tcp" },
+ { "candrp", { NULL }, 42509, "udp" },
+ { "caerpc", { NULL }, 42510, "tcp" },
+ { "caerpc", { NULL }, 42510, "udp" },
+ { "reachout", { NULL }, 43188, "tcp" },
+ { "reachout", { NULL }, 43188, "udp" },
+ { "ndm-agent-port", { NULL }, 43189, "tcp" },
+ { "ndm-agent-port", { NULL }, 43189, "udp" },
+ { "ip-provision", { NULL }, 43190, "tcp" },
+ { "ip-provision", { NULL }, 43190, "udp" },
+ { "noit-transport", { NULL }, 43191, "tcp" },
+ { "ew-mgmt", { NULL }, 43440, "tcp" },
+ { "ew-disc-cmd", { NULL }, 43440, "udp" },
+ { "ciscocsdb", { NULL }, 43441, "tcp" },
+ { "ciscocsdb", { NULL }, 43441, "udp" },
+ { "pmcd", { NULL }, 44321, "tcp" },
+ { "pmcd", { NULL }, 44321, "udp" },
+ { "pmcdproxy", { NULL }, 44322, "tcp" },
+ { "pmcdproxy", { NULL }, 44322, "udp" },
+ { "pcp", { NULL }, 44323, "udp" },
+ { "rbr-debug", { NULL }, 44553, "tcp" },
+ { "rbr-debug", { NULL }, 44553, "udp" },
+ { "EtherNet/IP-2", { NULL }, 44818, "tcp" },
+ { "EtherNet/IP-2", { NULL }, 44818, "udp" },
+ { "invision-ag", { NULL }, 45054, "tcp" },
+ { "invision-ag", { NULL }, 45054, "udp" },
+ { "eba", { NULL }, 45678, "tcp" },
+ { "eba", { NULL }, 45678, "udp" },
+ { "qdb2service", { NULL }, 45825, "tcp" },
+ { "qdb2service", { NULL }, 45825, "udp" },
+ { "ssr-servermgr", { NULL }, 45966, "tcp" },
+ { "ssr-servermgr", { NULL }, 45966, "udp" },
+ { "mediabox", { NULL }, 46999, "tcp" },
+ { "mediabox", { NULL }, 46999, "udp" },
+ { "mbus", { NULL }, 47000, "tcp" },
+ { "mbus", { NULL }, 47000, "udp" },
+ { "winrm", { NULL }, 47001, "tcp" },
+ { "dbbrowse", { NULL }, 47557, "tcp" },
+ { "dbbrowse", { NULL }, 47557, "udp" },
+ { "directplaysrvr", { NULL }, 47624, "tcp" },
+ { "directplaysrvr", { NULL }, 47624, "udp" },
+ { "ap", { NULL }, 47806, "tcp" },
+ { "ap", { NULL }, 47806, "udp" },
+ { "bacnet", { NULL }, 47808, "tcp" },
+ { "bacnet", { NULL }, 47808, "udp" },
+ { "nimcontroller", { NULL }, 48000, "tcp" },
+ { "nimcontroller", { NULL }, 48000, "udp" },
+ { "nimspooler", { NULL }, 48001, "tcp" },
+ { "nimspooler", { NULL }, 48001, "udp" },
+ { "nimhub", { NULL }, 48002, "tcp" },
+ { "nimhub", { NULL }, 48002, "udp" },
+ { "nimgtw", { NULL }, 48003, "tcp" },
+ { "nimgtw", { NULL }, 48003, "udp" },
+ { "nimbusdb", { NULL }, 48004, "tcp" },
+ { "nimbusdbctrl", { NULL }, 48005, "tcp" },
+ { "3gpp-cbsp", { NULL }, 48049, "tcp" },
+ { "isnetserv", { NULL }, 48128, "tcp" },
+ { "isnetserv", { NULL }, 48128, "udp" },
+ { "blp5", { NULL }, 48129, "tcp" },
+ { "blp5", { NULL }, 48129, "udp" },
+ { "com-bardac-dw", { NULL }, 48556, "tcp" },
+ { "com-bardac-dw", { NULL }, 48556, "udp" },
+ { "iqobject", { NULL }, 48619, "tcp" },
+ { "iqobject", { NULL }, 48619, "udp" },
+# endif /* USE_IANA_REGISTERED_PORTS */
+ { NULL, { NULL }, 0, NULL }
+};
+
+struct servent *getservbyport(int port, const char *proto)
+{
+ unsigned short u_port;
+ const char *protocol = NULL;
+ int error = 0;
+ size_t i;
+
+ u_port = ntohs((unsigned short)port);
+
+ if (proto) {
+ switch (ares_strlen(proto)) {
+ case 3:
+ if (!strncasecmp(proto, "tcp", 3)) {
+ protocol = "tcp";
+ } else if (!strncasecmp(proto, "udp", 3)) {
+ protocol = "udp";
+ } else {
+ error = WSAEFAULT;
+ }
+ break;
+ case 4:
+ if (!strncasecmp(proto, "sctp", 4)) {
+ protocol = "sctp";
+ } else if (!strncasecmp(proto, "dccp", 4)) {
+ protocol = "dccp";
+ } else {
+ error = WSAEFAULT;
+ }
+ break;
+ default:
+ error = WSAEFAULT;
+ }
+ }
+
+ if (!error) {
+ for (i = 0; i < (sizeof(IANAports) / sizeof(IANAports[0])) - 1; i++) {
+ if (u_port == IANAports[i].s_port) {
+ if (!protocol || !strcasecmp(protocol, IANAports[i].s_proto)) {
+ return (struct servent *)&IANAports[i];
+ }
+ }
+ }
+ error = WSANO_DATA;
+ }
+
+ SET_SOCKERRNO(error);
+ return NULL;
+}
+
+#endif /* _WIN32_WCE */
diff --git a/subprojects/c-ares/src/lib/ares_platform.h b/subprojects/c-ares/src/lib/ares_platform.h
@@ -0,0 +1,52 @@
+/* MIT License
+ *
+ * Copyright (c) 1998 Massachusetts Institute of Technology
+ * Copyright (c) 2004 Daniel Stenberg
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice (including the next
+ * paragraph) shall be included in all copies or substantial portions of the
+ * Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ *
+ * SPDX-License-Identifier: MIT
+ */
+#ifndef HEADER_CARES_PLATFORM_H
+#define HEADER_CARES_PLATFORM_H
+
+#include "ares_setup.h"
+
+#if defined(WIN32) && !defined(MSDOS)
+
+typedef enum {
+ WIN_UNKNOWN,
+ WIN_3X,
+ WIN_9X,
+ WIN_NT,
+ WIN_CE
+} win_platform;
+
+win_platform ares__getplatform(void);
+
+#endif
+
+#if defined(_WIN32_WCE)
+
+struct servent *getservbyport(int port, const char *proto);
+
+#endif
+
+#endif /* HEADER_CARES_PLATFORM_H */
diff --git a/subprojects/c-ares/src/lib/ares_private.h b/subprojects/c-ares/src/lib/ares_private.h
@@ -0,0 +1,600 @@
+/* MIT License
+ *
+ * Copyright (c) 1998 Massachusetts Institute of Technology
+ * Copyright (c) 2010 Daniel Stenberg
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice (including the next
+ * paragraph) shall be included in all copies or substantial portions of the
+ * Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ *
+ * SPDX-License-Identifier: MIT
+ */
+#ifndef __ARES_PRIVATE_H
+#define __ARES_PRIVATE_H
+
+/*
+ * Define WIN32 when build target is Win32 API
+ */
+
+#if (defined(_WIN32) || defined(__WIN32__)) && !defined(WIN32)
+# define WIN32
+#endif
+
+#ifdef HAVE_NETINET_IN_H
+# include <netinet/in.h>
+#endif
+
+#ifdef WATT32
+# include <tcp.h>
+# include <sys/ioctl.h>
+#endif
+
+#define DEFAULT_TIMEOUT 2000 /* milliseconds */
+#define DEFAULT_TRIES 3
+#ifndef INADDR_NONE
+# define INADDR_NONE 0xffffffff
+#endif
+
+/* By using a double cast, we can get rid of the bogus warning of
+ * warning: cast from 'const struct sockaddr *' to 'const struct sockaddr_in6 *'
+ * increases required alignment from 1 to 4 [-Wcast-align]
+ */
+#define CARES_INADDR_CAST(type, var) ((type)((void *)var))
+
+#if defined(WIN32) && !defined(WATT32)
+
+# define WIN_NS_9X "System\\CurrentControlSet\\Services\\VxD\\MSTCP"
+# define WIN_NS_NT_KEY "System\\CurrentControlSet\\Services\\Tcpip\\Parameters"
+# define WIN_DNSCLIENT "Software\\Policies\\Microsoft\\System\\DNSClient"
+# define WIN_NT_DNSCLIENT \
+ "Software\\Policies\\Microsoft\\Windows NT\\DNSClient"
+# define NAMESERVER "NameServer"
+# define DHCPNAMESERVER "DhcpNameServer"
+# define DATABASEPATH "DatabasePath"
+# define WIN_PATH_HOSTS "\\hosts"
+# define SEARCHLIST_KEY "SearchList"
+# define PRIMARYDNSSUFFIX_KEY "PrimaryDNSSuffix"
+# define INTERFACES_KEY "Interfaces"
+# define DOMAIN_KEY "Domain"
+# define DHCPDOMAIN_KEY "DhcpDomain"
+# define PATH_RESOLV_CONF ""
+#elif defined(WATT32)
+
+# define PATH_RESOLV_CONF "/dev/ENV/etc/resolv.conf"
+W32_FUNC const char *_w32_GetHostsFile(void);
+
+#elif defined(NETWARE)
+
+# define PATH_RESOLV_CONF "sys:/etc/resolv.cfg"
+# define PATH_HOSTS "sys:/etc/hosts"
+
+#elif defined(__riscos__)
+
+# define PATH_RESOLV_CONF ""
+# define PATH_HOSTS "InetDBase:Hosts"
+
+#elif defined(__HAIKU__)
+
+# define PATH_RESOLV_CONF "/system/settings/network/resolv.conf"
+# define PATH_HOSTS "/system/settings/network/hosts"
+
+#else
+
+# define PATH_RESOLV_CONF "/etc/resolv.conf"
+# ifdef ETC_INET
+# define PATH_HOSTS "/etc/inet/hosts"
+# else
+# define PATH_HOSTS "/etc/hosts"
+# endif
+
+#endif
+
+#include "ares_ipv6.h"
+
+struct ares_rand_state;
+typedef struct ares_rand_state ares_rand_state;
+
+#include "ares__llist.h"
+#include "ares__slist.h"
+#include "ares__htable_strvp.h"
+#include "ares__htable_szvp.h"
+#include "ares__htable_asvp.h"
+#include "ares__buf.h"
+#include "ares_dns_private.h"
+#include "ares__iface_ips.h"
+
+#ifndef HAVE_GETENV
+# include "ares_getenv.h"
+# define getenv(ptr) ares_getenv(ptr)
+#endif
+
+#include "ares_str.h"
+#include "ares_strsplit.h"
+
+#ifndef HAVE_STRCASECMP
+# include "ares_strcasecmp.h"
+# define strcasecmp(p1, p2) ares_strcasecmp(p1, p2)
+#endif
+
+#ifndef HAVE_STRNCASECMP
+# include "ares_strcasecmp.h"
+# define strncasecmp(p1, p2, n) ares_strncasecmp(p1, p2, n)
+#endif
+
+/********* EDNS defines section ******/
+#define EDNSPACKETSZ \
+ 1280 /* Reasonable UDP payload size, as suggested \
+ in RFC2671 */
+#define MAXENDSSZ 4096 /* Maximum (local) limit for edns packet size */
+#define EDNSFIXEDSZ 11 /* Size of EDNS header */
+
+/********* EDNS defines section ******/
+
+
+struct query;
+
+struct server_state;
+
+struct server_connection {
+ struct server_state *server;
+ ares_socket_t fd;
+ ares_bool_t is_tcp;
+ /* total number of queries run on this connection since it was established */
+ size_t total_queries;
+ /* list of outstanding queries to this connection */
+ ares__llist_t *queries_to_conn;
+};
+
+struct server_state {
+ /* Configuration */
+ size_t idx; /* index for server in system configuration */
+ struct ares_addr addr;
+ unsigned short udp_port; /* host byte order */
+ unsigned short tcp_port; /* host byte order */
+ char ll_iface[64]; /* IPv6 Link Local Interface */
+ unsigned int ll_scope; /* IPv6 Link Local Scope */
+
+ size_t consec_failures; /* Consecutive query failure count
+ * can be hard errors or timeouts
+ */
+ ares__llist_t *connections;
+ struct server_connection *tcp_conn;
+
+ /* TCP buffer since multiple responses can come back in one read, or partial
+ * in a read */
+ ares__buf_t *tcp_parser;
+
+ /* TCP output queue */
+ ares__buf_t *tcp_send;
+
+ /* Link back to owning channel */
+ ares_channel_t *channel;
+};
+
+/* State to represent a DNS query */
+struct query {
+ /* Query ID from qbuf, for faster lookup, and current timeout */
+ unsigned short qid; /* host byte order */
+ struct timeval timeout;
+ ares_channel_t *channel;
+
+ /*
+ * Node object for each list entry the query belongs to in order to
+ * make removal operations O(1).
+ */
+ ares__slist_node_t *node_queries_by_timeout;
+ ares__llist_node_t *node_queries_to_conn;
+ ares__llist_node_t *node_all_queries;
+
+ /* connection handle query is associated with */
+ struct server_connection *conn;
+
+ /* Arguments passed to ares_send() */
+ unsigned char *qbuf;
+ size_t qlen;
+
+ ares_callback callback;
+ void *arg;
+
+ /* Query status */
+ size_t try_count; /* Number of times we tried this query already. */
+ ares_bool_t using_tcp;
+ ares_status_t error_status;
+ size_t timeouts; /* number of timeouts we saw for this request */
+ ares_bool_t no_retries; /* do not perform any additional retries, this is set
+ * when a query is to be canceled */
+};
+
+struct apattern {
+ struct ares_addr addr;
+ unsigned char mask;
+};
+
+struct ares__qcache;
+typedef struct ares__qcache ares__qcache_t;
+
+struct ares_hosts_file;
+typedef struct ares_hosts_file ares_hosts_file_t;
+
+struct ares__thread_mutex;
+typedef struct ares__thread_mutex ares__thread_mutex_t;
+
+struct ares_channeldata {
+ /* Configuration data */
+ unsigned int flags;
+ size_t timeout; /* in milliseconds */
+ size_t tries;
+ size_t ndots;
+ size_t maxtimeout; /* in milliseconds */
+ ares_bool_t rotate;
+ unsigned short udp_port; /* stored in network order */
+ unsigned short tcp_port; /* stored in network order */
+ int socket_send_buffer_size; /* setsockopt takes int */
+ int socket_receive_buffer_size; /* setsockopt takes int */
+ char **domains;
+ size_t ndomains;
+ struct apattern *sortlist;
+ size_t nsort;
+ char *lookups;
+ size_t ednspsz;
+ unsigned int qcache_max_ttl;
+ unsigned int optmask;
+
+ /* For binding to local devices and/or IP addresses. Leave
+ * them null/zero for no binding.
+ */
+ char local_dev_name[32];
+ unsigned int local_ip4;
+ unsigned char local_ip6[16];
+
+ /* Thread safety lock */
+ ares__thread_mutex_t *lock;
+
+ /* Server addresses and communications state. Sorted by least consecutive
+ * failures, followed by the configuration order if failures are equal. */
+ ares__slist_t *servers;
+
+ /* random state to use when generating new ids and generating retry penalties
+ */
+ ares_rand_state *rand_state;
+
+ /* All active queries in a single list */
+ ares__llist_t *all_queries;
+ /* Queries bucketed by qid, for quickly dispatching DNS responses: */
+ ares__htable_szvp_t *queries_by_qid;
+
+ /* Queries bucketed by timeout, for quickly handling timeouts: */
+ ares__slist_t *queries_by_timeout;
+
+ /* Map linked list node member for connection to file descriptor. We use
+ * the node instead of the connection object itself so we can quickly look
+ * up a connection and remove it if necessary (as otherwise we'd have to
+ * scan all connections) */
+ ares__htable_asvp_t *connnode_by_socket;
+
+ ares_sock_state_cb sock_state_cb;
+ void *sock_state_cb_data;
+
+ ares_sock_create_callback sock_create_cb;
+ void *sock_create_cb_data;
+
+ ares_sock_config_callback sock_config_cb;
+ void *sock_config_cb_data;
+
+ const struct ares_socket_functions *sock_funcs;
+ void *sock_func_cb_data;
+
+ /* Path for resolv.conf file, configurable via ares_options */
+ char *resolvconf_path;
+
+ /* Path for hosts file, configurable via ares_options */
+ char *hosts_path;
+
+ /* Maximum UDP queries per connection allowed */
+ size_t udp_max_queries;
+
+ /* Cache of local hosts file */
+ ares_hosts_file_t *hf;
+
+ /* Query Cache */
+ ares__qcache_t *qcache;
+};
+
+/* Does the domain end in ".onion" or ".onion."? Case-insensitive. */
+ares_bool_t ares__is_onion_domain(const char *name);
+
+/* Memory management functions */
+extern void *(*ares_malloc)(size_t size);
+extern void *(*ares_realloc)(void *ptr, size_t size);
+extern void (*ares_free)(void *ptr);
+void *ares_malloc_zero(size_t size);
+void *ares_realloc_zero(void *ptr, size_t orig_size, size_t new_size);
+
+/* return true if now is exactly check time or later */
+ares_bool_t ares__timedout(const struct timeval *now,
+ const struct timeval *check);
+
+/* Returns one of the normal ares status codes like ARES_SUCCESS */
+ares_status_t ares__send_query(struct query *query, struct timeval *now);
+ares_status_t ares__requeue_query(struct query *query, struct timeval *now);
+
+/* Identical to ares_query, but returns a normal ares return code like
+ * ARES_SUCCESS, and can be passed the qid by reference which will be
+ * filled in on ARES_SUCCESS */
+ares_status_t ares_query_qid(ares_channel_t *channel, const char *name,
+ int dnsclass, int type, ares_callback callback,
+ void *arg, unsigned short *qid);
+/* Identical to ares_send() except returns normal ares return codes like
+ * ARES_SUCCESS */
+ares_status_t ares_send_ex(ares_channel_t *channel, const unsigned char *qbuf,
+ size_t qlen, ares_callback callback, void *arg,
+ unsigned short *qid);
+void ares__close_connection(struct server_connection *conn);
+void ares__close_sockets(struct server_state *server);
+void ares__check_cleanup_conn(const ares_channel_t *channel,
+ struct server_connection *conn);
+ares_status_t ares__read_line(FILE *fp, char **buf, size_t *bufsize);
+void ares__free_query(struct query *query);
+
+ares_rand_state *ares__init_rand_state(void);
+void ares__destroy_rand_state(ares_rand_state *state);
+void ares__rand_bytes(ares_rand_state *state, unsigned char *buf, size_t len);
+
+unsigned short ares__generate_new_id(ares_rand_state *state);
+struct timeval ares__tvnow(void);
+void ares__timeval_remaining(struct timeval *remaining,
+ const struct timeval *now,
+ const struct timeval *tout);
+ares_status_t ares__expand_name_validated(const unsigned char *encoded,
+ const unsigned char *abuf,
+ size_t alen, char **s, size_t *enclen,
+ ares_bool_t is_hostname);
+ares_status_t ares__expand_name_for_response(const unsigned char *encoded,
+ const unsigned char *abuf,
+ size_t alen, char **s,
+ size_t *enclen,
+ ares_bool_t is_hostname);
+ares_status_t ares_expand_string_ex(const unsigned char *encoded,
+ const unsigned char *abuf, size_t alen,
+ unsigned char **s, size_t *enclen);
+ares_status_t ares__init_servers_state(ares_channel_t *channel);
+ares_status_t ares__init_by_options(ares_channel_t *channel,
+ const struct ares_options *options,
+ int optmask);
+ares_status_t ares__init_by_sysconfig(ares_channel_t *channel);
+
+typedef struct {
+ ares__llist_t *sconfig;
+ struct apattern *sortlist;
+ size_t nsortlist;
+ char **domains;
+ size_t ndomains;
+ char *lookups;
+ size_t ndots;
+ size_t tries;
+ ares_bool_t rotate;
+ size_t timeout_ms;
+} ares_sysconfig_t;
+
+ares_status_t ares__init_by_environment(ares_sysconfig_t *sysconfig);
+
+ares_status_t ares__init_sysconfig_files(const ares_channel_t *channel,
+ ares_sysconfig_t *sysconfig);
+ares_status_t ares__parse_sortlist(struct apattern **sortlist, size_t *nsort,
+ const char *str);
+
+void ares__destroy_servers_state(ares_channel_t *channel);
+ares_status_t ares__single_domain(const ares_channel_t *channel,
+ const char *name, char **s);
+ares_status_t ares__cat_domain(const char *name, const char *domain, char **s);
+ares_status_t ares__sortaddrinfo(ares_channel_t *channel,
+ struct ares_addrinfo_node *ai_node);
+
+void ares__freeaddrinfo_nodes(struct ares_addrinfo_node *ai_node);
+ares_bool_t ares__is_localhost(const char *name);
+
+struct ares_addrinfo_node *
+ ares__append_addrinfo_node(struct ares_addrinfo_node **ai_node);
+void ares__addrinfo_cat_nodes(struct ares_addrinfo_node **head,
+ struct ares_addrinfo_node *tail);
+
+void ares__freeaddrinfo_cnames(struct ares_addrinfo_cname *ai_cname);
+
+struct ares_addrinfo_cname *
+ ares__append_addrinfo_cname(struct ares_addrinfo_cname **ai_cname);
+
+ares_status_t ares_append_ai_node(int aftype, unsigned short port,
+ unsigned int ttl, const void *adata,
+ struct ares_addrinfo_node **nodes);
+
+void ares__addrinfo_cat_cnames(struct ares_addrinfo_cname **head,
+ struct ares_addrinfo_cname *tail);
+
+ares_status_t ares__parse_into_addrinfo(const unsigned char *abuf, size_t alen,
+ ares_bool_t cname_only_is_enodata,
+ unsigned short port,
+ struct ares_addrinfo *ai);
+
+ares_status_t ares__addrinfo2hostent(const struct ares_addrinfo *ai, int family,
+ struct hostent **host);
+ares_status_t ares__addrinfo2addrttl(const struct ares_addrinfo *ai, int family,
+ size_t req_naddrttls,
+ struct ares_addrttl *addrttls,
+ struct ares_addr6ttl *addr6ttls,
+ size_t *naddrttls);
+ares_status_t ares__addrinfo_localhost(const char *name, unsigned short port,
+ const struct ares_addrinfo_hints *hints,
+ struct ares_addrinfo *ai);
+ares_status_t ares__open_connection(ares_channel_t *channel,
+ struct server_state *server,
+ ares_bool_t is_tcp);
+ares_socket_t ares__open_socket(ares_channel_t *channel, int af, int type,
+ int protocol);
+ares_ssize_t ares__socket_write(ares_channel_t *channel, ares_socket_t s,
+ const void *data, size_t len);
+ares_ssize_t ares__socket_recvfrom(ares_channel_t *channel, ares_socket_t s,
+ void *data, size_t data_len, int flags,
+ struct sockaddr *from,
+ ares_socklen_t *from_len);
+ares_ssize_t ares__socket_recv(ares_channel_t *channel, ares_socket_t s,
+ void *data, size_t data_len);
+void ares__close_socket(ares_channel, ares_socket_t);
+int ares__connect_socket(ares_channel_t *channel, ares_socket_t sockfd,
+ const struct sockaddr *addr, ares_socklen_t addrlen);
+ares_bool_t ares__is_hostnamech(int ch);
+void ares__destroy_server(struct server_state *server);
+
+ares_status_t ares__servers_update(ares_channel_t *channel,
+ ares__llist_t *server_list,
+ ares_bool_t user_specified);
+ares_status_t ares__sconfig_append(ares__llist_t **sconfig,
+ const struct ares_addr *addr,
+ unsigned short udp_port,
+ unsigned short tcp_port,
+ const char *ll_iface);
+ares_status_t ares__sconfig_append_fromstr(ares__llist_t **sconfig,
+ const char *str,
+ ares_bool_t ignore_invalid);
+ares_status_t ares_in_addr_to_server_config_llist(const struct in_addr *servers,
+ size_t nservers,
+ ares__llist_t **llist);
+
+struct ares_hosts_entry;
+typedef struct ares_hosts_entry ares_hosts_entry_t;
+
+void ares__hosts_file_destroy(ares_hosts_file_t *hf);
+ares_status_t ares__hosts_search_ipaddr(ares_channel_t *channel,
+ ares_bool_t use_env, const char *ipaddr,
+ const ares_hosts_entry_t **entry);
+ares_status_t ares__hosts_search_host(ares_channel_t *channel,
+ ares_bool_t use_env, const char *host,
+ const ares_hosts_entry_t **entry);
+ares_status_t ares__hosts_entry_to_hostent(const ares_hosts_entry_t *entry,
+ int family,
+ struct hostent **hostent);
+ares_status_t ares__hosts_entry_to_addrinfo(const ares_hosts_entry_t *entry,
+ const char *name, int family,
+ unsigned short port,
+ ares_bool_t want_cnames,
+ struct ares_addrinfo *ai);
+ares_bool_t ares__isprint(int ch);
+
+
+/*! Parse a compressed DNS name as defined in RFC1035 starting at the current
+ * offset within the buffer.
+ *
+ * It is assumed that either a const buffer is being used, or before
+ * the message processing was started that ares__buf_reclaim() was called.
+ *
+ * \param[in] buf Initialized buffer object
+ * \param[out] name Pointer passed by reference to be filled in with
+ * allocated string of the parsed name that must be
+ * ares_free()'d by the caller.
+ * \param[in] is_hostname if ARES_TRUE, will validate the character set for
+ * a valid hostname or will return error.
+ * \return ARES_SUCCESS on success
+ */
+ares_status_t ares__dns_name_parse(ares__buf_t *buf, char **name,
+ ares_bool_t is_hostname);
+
+/*! Write the DNS name to the buffer in the DNS domain-name syntax as a
+ * series of labels. The maximum domain name length is 255 characters with
+ * each label being a maximum of 63 characters. If the validate_hostname
+ * flag is set, it will strictly validate the character set.
+ *
+ * \param[in,out] buf Initialized buffer object to write name to
+ * \param[in,out] list Pointer passed by reference to maintain a list of
+ * domain name to indexes used for name compression.
+ * Pass NULL (not by reference) if name compression isn't
+ * desired. Otherwise the list will be automatically
+ * created upon first entry.
+ * \param[in] validate_hostname Validate the hostname character set.
+ * \param[in] name Name to write out, it may have escape
+ * sequences.
+ * \return ARES_SUCCESS on success, most likely ARES_EBADNAME if the name is
+ * bad.
+ */
+ares_status_t ares__dns_name_write(ares__buf_t *buf, ares__llist_t **list,
+ ares_bool_t validate_hostname,
+ const char *name);
+
+#define ARES_SWAP_BYTE(a, b) \
+ do { \
+ unsigned char swapByte = *(a); \
+ *(a) = *(b); \
+ *(b) = swapByte; \
+ } while (0)
+
+#define SOCK_STATE_CALLBACK(c, s, r, w) \
+ do { \
+ if ((c)->sock_state_cb) { \
+ (c)->sock_state_cb((c)->sock_state_cb_data, (s), (r), (w)); \
+ } \
+ } while (0)
+
+#define ARES_CONFIG_CHECK(x) \
+ (x && x->lookups && ares__slist_len(x->servers) > 0 && x->ndots > 0 && \
+ x->timeout > 0 && x->tries > 0)
+
+ares_bool_t ares__subnet_match(const struct ares_addr *addr,
+ const struct ares_addr *subnet,
+ unsigned char netmask);
+ares_bool_t ares__addr_is_linklocal(const struct ares_addr *addr);
+
+size_t ares__round_up_pow2(size_t n);
+size_t ares__log2(size_t n);
+size_t ares__pow(size_t x, size_t y);
+size_t ares__count_digits(size_t n);
+size_t ares__count_hexdigits(size_t n);
+unsigned char ares__count_bits_u8(unsigned char x);
+void ares__qcache_destroy(ares__qcache_t *cache);
+ares_status_t ares__qcache_create(ares_rand_state *rand_state,
+ unsigned int max_ttl,
+ ares__qcache_t **cache_out);
+void ares__qcache_flush(ares__qcache_t *cache);
+ares_status_t ares_qcache_insert(ares_channel_t *channel,
+ const struct timeval *now,
+ const struct query *query,
+ ares_dns_record_t *dnsrec);
+ares_status_t ares_qcache_fetch(ares_channel_t *channel,
+ const struct timeval *now,
+ const unsigned char *qbuf, size_t qlen,
+ unsigned char **abuf, size_t *alen);
+
+ares_status_t ares__channel_threading_init(ares_channel_t *channel);
+void ares__channel_threading_destroy(ares_channel_t *channel);
+void ares__channel_lock(ares_channel_t *channel);
+void ares__channel_unlock(ares_channel_t *channel);
+
+#ifdef _MSC_VER
+typedef __int64 ares_int64_t;
+typedef unsigned __int64 ares_uint64_t;
+#else
+typedef long long ares_int64_t;
+typedef unsigned long long ares_uint64_t;
+#endif
+
+#ifdef _WIN32
+# define HOSTENT_ADDRTYPE_TYPE short
+# define HOSTENT_LENGTH_TYPE short
+#else
+# define HOSTENT_ADDRTYPE_TYPE int
+# define HOSTENT_LENGTH_TYPE int
+#endif
+
+#endif /* __ARES_PRIVATE_H */
diff --git a/subprojects/c-ares/src/lib/ares_process.c b/subprojects/c-ares/src/lib/ares_process.c
@@ -0,0 +1,1151 @@
+/* MIT License
+ *
+ * Copyright (c) 1998 Massachusetts Institute of Technology
+ * Copyright (c) 2010 Daniel Stenberg
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice (including the next
+ * paragraph) shall be included in all copies or substantial portions of the
+ * Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ *
+ * SPDX-License-Identifier: MIT
+ */
+
+#include "ares_setup.h"
+
+
+#ifdef HAVE_STRINGS_H
+# include <strings.h>
+#endif
+#ifdef HAVE_SYS_IOCTL_H
+# include <sys/ioctl.h>
+#endif
+#ifdef NETWARE
+# include <sys/filio.h>
+#endif
+#ifdef HAVE_STDINT_H
+# include <stdint.h>
+#endif
+
+#include <assert.h>
+#include <fcntl.h>
+#include <limits.h>
+
+#include "ares.h"
+#include "ares_private.h"
+#include "ares_nameser.h"
+#include "ares_dns.h"
+
+static ares_bool_t try_again(int errnum);
+static void write_tcp_data(ares_channel_t *channel, fd_set *write_fds,
+ ares_socket_t write_fd);
+static void read_packets(ares_channel_t *channel, fd_set *read_fds,
+ ares_socket_t read_fd, struct timeval *now);
+static void process_timeouts(ares_channel_t *channel, struct timeval *now);
+static ares_status_t process_answer(ares_channel_t *channel,
+ const unsigned char *abuf, size_t alen,
+ struct server_connection *conn,
+ ares_bool_t tcp, struct timeval *now);
+static void handle_conn_error(struct server_connection *conn,
+ ares_bool_t critical_failure);
+
+static ares_bool_t same_questions(const ares_dns_record_t *qrec,
+ const ares_dns_record_t *arec);
+static ares_bool_t same_address(const struct sockaddr *sa,
+ const struct ares_addr *aa);
+static void end_query(const ares_channel_t *channel, struct query *query,
+ ares_status_t status, const unsigned char *abuf,
+ size_t alen);
+
+static void server_increment_failures(struct server_state *server)
+{
+ ares__slist_node_t *node;
+ const ares_channel_t *channel = server->channel;
+
+ node = ares__slist_node_find(channel->servers, server);
+ if (node == NULL) {
+ return;
+ }
+ server->consec_failures++;
+ ares__slist_node_reinsert(node);
+}
+
+static void server_set_good(struct server_state *server)
+{
+ ares__slist_node_t *node;
+ const ares_channel_t *channel = server->channel;
+
+ if (!server->consec_failures) {
+ return;
+ }
+
+ node = ares__slist_node_find(channel->servers, server);
+ if (node == NULL) {
+ return;
+ }
+
+ server->consec_failures = 0;
+ ares__slist_node_reinsert(node);
+}
+
+/* return true if now is exactly check time or later */
+ares_bool_t ares__timedout(const struct timeval *now,
+ const struct timeval *check)
+{
+ ares_int64_t secs = ((ares_int64_t)now->tv_sec - (ares_int64_t)check->tv_sec);
+
+ if (secs > 0) {
+ return ARES_TRUE; /* yes, timed out */
+ }
+ if (secs < 0) {
+ return ARES_FALSE; /* nope, not timed out */
+ }
+
+ /* if the full seconds were identical, check the sub second parts */
+ return ((ares_int64_t)now->tv_usec - (ares_int64_t)check->tv_usec) >= 0
+ ? ARES_TRUE
+ : ARES_FALSE;
+}
+
+/* add the specific number of milliseconds to the time in the first argument */
+static void timeadd(struct timeval *now, size_t millisecs)
+{
+ now->tv_sec += (time_t)millisecs / 1000;
+ now->tv_usec += (time_t)((millisecs % 1000) * 1000);
+
+ if (now->tv_usec >= 1000000) {
+ ++(now->tv_sec);
+ now->tv_usec -= 1000000;
+ }
+}
+
+/*
+ * generic process function
+ */
+static void processfds(ares_channel_t *channel, fd_set *read_fds,
+ ares_socket_t read_fd, fd_set *write_fds,
+ ares_socket_t write_fd)
+{
+ struct timeval now;
+
+ if (channel == NULL) {
+ return;
+ }
+
+ ares__channel_lock(channel);
+
+ now = ares__tvnow();
+ read_packets(channel, read_fds, read_fd, &now);
+ process_timeouts(channel, &now);
+ /* Write last as the other 2 operations might have triggered writes */
+ write_tcp_data(channel, write_fds, write_fd);
+
+ ares__channel_unlock(channel);
+}
+
+/* Something interesting happened on the wire, or there was a timeout.
+ * See what's up and respond accordingly.
+ */
+void ares_process(ares_channel_t *channel, fd_set *read_fds, fd_set *write_fds)
+{
+ processfds(channel, read_fds, ARES_SOCKET_BAD, write_fds, ARES_SOCKET_BAD);
+}
+
+/* Something interesting happened on the wire, or there was a timeout.
+ * See what's up and respond accordingly.
+ */
+void ares_process_fd(ares_channel_t *channel,
+ ares_socket_t read_fd, /* use ARES_SOCKET_BAD or valid
+ file descriptors */
+ ares_socket_t write_fd)
+{
+ processfds(channel, NULL, read_fd, NULL, write_fd);
+}
+
+/* Return 1 if the specified error number describes a readiness error, or 0
+ * otherwise. This is mostly for HP-UX, which could return EAGAIN or
+ * EWOULDBLOCK. See this man page
+ *
+ * http://devrsrc1.external.hp.com/STKS/cgi-bin/man2html?
+ * manpage=/usr/share/man/man2.Z/send.2
+ */
+static ares_bool_t try_again(int errnum)
+{
+#if !defined EWOULDBLOCK && !defined EAGAIN
+# error "Neither EWOULDBLOCK nor EAGAIN defined"
+#endif
+
+#ifdef EWOULDBLOCK
+ if (errnum == EWOULDBLOCK) {
+ return ARES_TRUE;
+ }
+#endif
+
+#if defined EAGAIN && EAGAIN != EWOULDBLOCK
+ if (errnum == EAGAIN) {
+ return ARES_TRUE;
+ }
+#endif
+
+ return ARES_FALSE;
+}
+
+/* If any TCP sockets select true for writing, write out queued data
+ * we have for them.
+ */
+static void write_tcp_data(ares_channel_t *channel, fd_set *write_fds,
+ ares_socket_t write_fd)
+{
+ ares__slist_node_t *node;
+
+ if (!write_fds && (write_fd == ARES_SOCKET_BAD)) {
+ /* no possible action */
+ return;
+ }
+
+ for (node = ares__slist_node_first(channel->servers); node != NULL;
+ node = ares__slist_node_next(node)) {
+ struct server_state *server = ares__slist_node_val(node);
+ const unsigned char *data;
+ size_t data_len;
+ ares_ssize_t count;
+
+ /* Make sure server has data to send and is selected in write_fds or
+ write_fd. */
+ if (ares__buf_len(server->tcp_send) == 0 || server->tcp_conn == NULL) {
+ continue;
+ }
+
+ if (write_fds) {
+ if (!FD_ISSET(server->tcp_conn->fd, write_fds)) {
+ continue;
+ }
+ } else {
+ if (server->tcp_conn->fd != write_fd) {
+ continue;
+ }
+ }
+
+ if (write_fds) {
+ /* If there's an error and we close this socket, then open
+ * another with the same fd to talk to another server, then we
+ * don't want to think that it was the new socket that was
+ * ready. This is not disastrous, but is likely to result in
+ * extra system calls and confusion. */
+ FD_CLR(server->tcp_conn->fd, write_fds);
+ }
+
+ data = ares__buf_peek(server->tcp_send, &data_len);
+ count = ares__socket_write(channel, server->tcp_conn->fd, data, data_len);
+ if (count <= 0) {
+ if (!try_again(SOCKERRNO)) {
+ handle_conn_error(server->tcp_conn, ARES_TRUE);
+ }
+ continue;
+ }
+
+ /* Strip data written from the buffer */
+ ares__buf_consume(server->tcp_send, (size_t)count);
+
+ /* Notify state callback all data is written */
+ if (ares__buf_len(server->tcp_send) == 0) {
+ SOCK_STATE_CALLBACK(channel, server->tcp_conn->fd, 1, 0);
+ }
+ }
+}
+
+/* If any TCP socket selects true for reading, read some data,
+ * allocate a buffer if we finish reading the length word, and process
+ * a packet if we finish reading one.
+ */
+static void read_tcp_data(ares_channel_t *channel,
+ struct server_connection *conn, struct timeval *now)
+{
+ ares_ssize_t count;
+ struct server_state *server = conn->server;
+
+ /* Fetch buffer to store data we are reading */
+ size_t ptr_len = 65535;
+ unsigned char *ptr;
+
+ ptr = ares__buf_append_start(server->tcp_parser, &ptr_len);
+
+ if (ptr == NULL) {
+ handle_conn_error(conn, ARES_FALSE /* not critical to connection */);
+ return; /* bail out on malloc failure. TODO: make this
+ function return error codes */
+ }
+
+ /* Read from socket */
+ count = ares__socket_recv(channel, conn->fd, ptr, ptr_len);
+ if (count <= 0) {
+ ares__buf_append_finish(server->tcp_parser, 0);
+ if (!(count == -1 && try_again(SOCKERRNO))) {
+ handle_conn_error(conn, ARES_TRUE);
+ }
+ return;
+ }
+
+ /* Record amount of data read */
+ ares__buf_append_finish(server->tcp_parser, (size_t)count);
+
+ /* Process all queued answers */
+ while (1) {
+ unsigned short dns_len = 0;
+ const unsigned char *data = NULL;
+ size_t data_len = 0;
+ ares_status_t status;
+
+ /* Tag so we can roll back */
+ ares__buf_tag(server->tcp_parser);
+
+ /* Read length indicator */
+ if (ares__buf_fetch_be16(server->tcp_parser, &dns_len) != ARES_SUCCESS) {
+ ares__buf_tag_rollback(server->tcp_parser);
+ break;
+ }
+
+ /* Not enough data for a full response yet */
+ if (ares__buf_consume(server->tcp_parser, dns_len) != ARES_SUCCESS) {
+ ares__buf_tag_rollback(server->tcp_parser);
+ break;
+ }
+
+ /* Can't fail except for misuse */
+ data = ares__buf_tag_fetch(server->tcp_parser, &data_len);
+ if (data == NULL) {
+ ares__buf_tag_clear(server->tcp_parser);
+ break;
+ }
+
+ /* Strip off 2 bytes length */
+ data += 2;
+ data_len -= 2;
+
+ /* We finished reading this answer; process it */
+ status = process_answer(channel, data, data_len, conn, ARES_TRUE, now);
+ if (status != ARES_SUCCESS) {
+ handle_conn_error(conn, ARES_TRUE);
+ return;
+ }
+
+ /* Since we processed the answer, clear the tag so space can be reclaimed */
+ ares__buf_tag_clear(server->tcp_parser);
+ }
+
+ ares__check_cleanup_conn(channel, conn);
+}
+
+static int socket_list_append(ares_socket_t **socketlist, ares_socket_t fd,
+ size_t *alloc_cnt, size_t *num)
+{
+ if (*num >= *alloc_cnt) {
+ /* Grow by powers of 2 */
+ size_t new_alloc = (*alloc_cnt) << 1;
+ ares_socket_t *new_list =
+ ares_realloc(socketlist, new_alloc * sizeof(*new_list));
+ if (new_list == NULL) {
+ return 0;
+ }
+ *alloc_cnt = new_alloc;
+ *socketlist = new_list;
+ }
+
+ (*socketlist)[(*num)++] = fd;
+ return 1;
+}
+
+static ares_socket_t *channel_socket_list(const ares_channel_t *channel,
+ size_t *num)
+{
+ size_t alloc_cnt = 1 << 4;
+ ares_socket_t *out = ares_malloc(alloc_cnt * sizeof(*out));
+ ares__slist_node_t *snode;
+
+ *num = 0;
+
+ if (out == NULL) {
+ return NULL;
+ }
+
+ for (snode = ares__slist_node_first(channel->servers); snode != NULL;
+ snode = ares__slist_node_next(snode)) {
+ struct server_state *server = ares__slist_node_val(snode);
+ ares__llist_node_t *node;
+
+ for (node = ares__llist_node_first(server->connections); node != NULL;
+ node = ares__llist_node_next(node)) {
+ const struct server_connection *conn = ares__llist_node_val(node);
+
+ if (conn->fd == ARES_SOCKET_BAD) {
+ continue;
+ }
+
+ if (!socket_list_append(&out, conn->fd, &alloc_cnt, num)) {
+ goto fail;
+ }
+ }
+ }
+
+ return out;
+
+fail:
+ ares_free(out);
+ *num = 0;
+ return NULL;
+}
+
+/* If any UDP sockets select true for reading, process them. */
+static void read_udp_packets_fd(ares_channel_t *channel,
+ struct server_connection *conn,
+ struct timeval *now)
+{
+ ares_ssize_t read_len;
+ unsigned char buf[MAXENDSSZ + 1];
+
+#ifdef HAVE_RECVFROM
+ ares_socklen_t fromlen;
+
+ union {
+ struct sockaddr sa;
+ struct sockaddr_in sa4;
+ struct sockaddr_in6 sa6;
+ } from;
+
+ memset(&from, 0, sizeof(from));
+#endif
+
+ /* To reduce event loop overhead, read and process as many
+ * packets as we can. */
+ do {
+ if (conn->fd == ARES_SOCKET_BAD) {
+ read_len = -1;
+ } else {
+ if (conn->server->addr.family == AF_INET) {
+ fromlen = sizeof(from.sa4);
+ } else {
+ fromlen = sizeof(from.sa6);
+ }
+ read_len = ares__socket_recvfrom(channel, conn->fd, (void *)buf,
+ sizeof(buf), 0, &from.sa, &fromlen);
+ }
+
+ if (read_len == 0) {
+ /* UDP is connectionless, so result code of 0 is a 0-length UDP
+ * packet, and not an indication the connection is closed like on
+ * tcp */
+ continue;
+ } else if (read_len < 0) {
+ if (try_again(SOCKERRNO)) {
+ break;
+ }
+
+ handle_conn_error(conn, ARES_TRUE);
+ return;
+#ifdef HAVE_RECVFROM
+ } else if (!same_address(&from.sa, &conn->server->addr)) {
+ /* The address the response comes from does not match the address we
+ * sent the request to. Someone may be attempting to perform a cache
+ * poisoning attack. */
+ continue;
+#endif
+
+ } else {
+ process_answer(channel, buf, (size_t)read_len, conn, ARES_FALSE, now);
+ }
+
+ /* Try to read again only if *we* set up the socket, otherwise it may be
+ * a blocking socket and would cause recvfrom to hang. */
+ } while (read_len >= 0 && channel->sock_funcs == NULL);
+
+ ares__check_cleanup_conn(channel, conn);
+}
+
+static void read_packets(ares_channel_t *channel, fd_set *read_fds,
+ ares_socket_t read_fd, struct timeval *now)
+{
+ size_t i;
+ ares_socket_t *socketlist = NULL;
+ size_t num_sockets = 0;
+ struct server_connection *conn = NULL;
+ ares__llist_node_t *node = NULL;
+
+ if (!read_fds && (read_fd == ARES_SOCKET_BAD)) {
+ /* no possible action */
+ return;
+ }
+
+ /* Single socket specified */
+ if (!read_fds) {
+ node = ares__htable_asvp_get_direct(channel->connnode_by_socket, read_fd);
+ if (node == NULL) {
+ return;
+ }
+
+ conn = ares__llist_node_val(node);
+
+ if (conn->is_tcp) {
+ read_tcp_data(channel, conn, now);
+ } else {
+ read_udp_packets_fd(channel, conn, now);
+ }
+
+ return;
+ }
+
+ /* There is no good way to iterate across an fd_set, instead we must pull a
+ * list of all known fds, and iterate across that checking against the fd_set.
+ */
+ socketlist = channel_socket_list(channel, &num_sockets);
+
+ for (i = 0; i < num_sockets; i++) {
+ if (!FD_ISSET(socketlist[i], read_fds)) {
+ continue;
+ }
+
+ /* If there's an error and we close this socket, then open
+ * another with the same fd to talk to another server, then we
+ * don't want to think that it was the new socket that was
+ * ready. This is not disastrous, but is likely to result in
+ * extra system calls and confusion. */
+ FD_CLR(socketlist[i], read_fds);
+
+ node =
+ ares__htable_asvp_get_direct(channel->connnode_by_socket, socketlist[i]);
+ if (node == NULL) {
+ return;
+ }
+
+ conn = ares__llist_node_val(node);
+
+ if (conn->is_tcp) {
+ read_tcp_data(channel, conn, now);
+ } else {
+ read_udp_packets_fd(channel, conn, now);
+ }
+ }
+
+ ares_free(socketlist);
+}
+
+/* If any queries have timed out, note the timeout and move them on. */
+static void process_timeouts(ares_channel_t *channel, struct timeval *now)
+{
+ ares__slist_node_t *node =
+ ares__slist_node_first(channel->queries_by_timeout);
+ while (node != NULL) {
+ struct query *query = ares__slist_node_val(node);
+ /* Node might be removed, cache next */
+ ares__slist_node_t *next = ares__slist_node_next(node);
+ struct server_connection *conn;
+ /* Since this is sorted, as soon as we hit a query that isn't timed out,
+ * break */
+ if (!ares__timedout(now, &query->timeout)) {
+ break;
+ }
+
+ query->error_status = ARES_ETIMEOUT;
+ query->timeouts++;
+
+ conn = query->conn;
+ server_increment_failures(conn->server);
+ ares__requeue_query(query, now);
+ ares__check_cleanup_conn(channel, conn);
+
+ node = next;
+ }
+}
+
+static ares_status_t rewrite_without_edns(ares_dns_record_t *qdnsrec,
+ struct query *query)
+{
+ ares_status_t status;
+ size_t i;
+ ares_bool_t found_opt_rr = ARES_FALSE;
+ unsigned char *msg = NULL;
+ size_t msglen = 0;
+
+ /* Find and remove the OPT RR record */
+ for (i = 0; i < ares_dns_record_rr_cnt(qdnsrec, ARES_SECTION_ADDITIONAL);
+ i++) {
+ const ares_dns_rr_t *rr;
+ rr = ares_dns_record_rr_get(qdnsrec, ARES_SECTION_ADDITIONAL, i);
+ if (ares_dns_rr_get_type(rr) == ARES_REC_TYPE_OPT) {
+ ares_dns_record_rr_del(qdnsrec, ARES_SECTION_ADDITIONAL, i);
+ found_opt_rr = ARES_TRUE;
+ break;
+ }
+ }
+
+ if (!found_opt_rr) {
+ status = ARES_EFORMERR;
+ goto done;
+ }
+
+ /* Rewrite the DNS message */
+ status = ares_dns_write(qdnsrec, &msg, &msglen);
+ if (status != ARES_SUCCESS) {
+ goto done;
+ }
+
+ ares_free(query->qbuf);
+ query->qbuf = msg;
+ query->qlen = msglen;
+
+done:
+ return status;
+}
+
+/* Handle an answer from a server. This must NEVER cleanup the
+ * server connection! Return something other than ARES_SUCCESS to cause
+ * the connection to be terminated after this call. */
+static ares_status_t process_answer(ares_channel_t *channel,
+ const unsigned char *abuf, size_t alen,
+ struct server_connection *conn,
+ ares_bool_t tcp, struct timeval *now)
+{
+ struct query *query;
+ /* Cache these as once ares__send_query() gets called, it may end up
+ * invalidating the connection all-together */
+ struct server_state *server = conn->server;
+ ares_dns_record_t *rdnsrec = NULL;
+ ares_dns_record_t *qdnsrec = NULL;
+ ares_status_t status;
+
+ /* Parse the response */
+ status = ares_dns_parse(abuf, alen, 0, &rdnsrec);
+ if (status != ARES_SUCCESS) {
+ /* Malformations are never accepted */
+ status = ARES_EBADRESP;
+ goto cleanup;
+ }
+
+ /* Find the query corresponding to this packet. The queries are
+ * hashed/bucketed by query id, so this lookup should be quick.
+ */
+ query = ares__htable_szvp_get_direct(channel->queries_by_qid,
+ ares_dns_record_get_id(rdnsrec));
+ if (!query) {
+ /* We may have stopped listening for this query, that's ok */
+ status = ARES_SUCCESS;
+ goto cleanup;
+ }
+
+ /* Parse the question we sent as we use it to compare */
+ status = ares_dns_parse(query->qbuf, query->qlen, 0, &qdnsrec);
+ if (status != ARES_SUCCESS) {
+ end_query(channel, query, status, NULL, 0);
+ goto cleanup;
+ }
+
+ /* Both the query id and the questions must be the same. We will drop any
+ * replies that aren't for the same query as this is considered invalid. */
+ if (!same_questions(qdnsrec, rdnsrec)) {
+ /* Possible qid conflict due to delayed response, that's ok */
+ status = ARES_SUCCESS;
+ goto cleanup;
+ }
+
+ /* At this point we know we've received an answer for this query, so we should
+ * remove it from the connection's queue so we can possibly invalidate the
+ * connection. Delay cleaning up the connection though as we may enqueue
+ * something new. */
+ ares__llist_node_destroy(query->node_queries_to_conn);
+ query->node_queries_to_conn = NULL;
+
+ /* If we use EDNS and server answers with FORMERR without an OPT RR, the
+ * protocol extension is not understood by the responder. We must retry the
+ * query without EDNS enabled. */
+ if (ares_dns_record_get_rcode(rdnsrec) == ARES_RCODE_FORMERR &&
+ ares_dns_has_opt_rr(qdnsrec) && !ares_dns_has_opt_rr(rdnsrec)) {
+ status = rewrite_without_edns(qdnsrec, query);
+ if (status != ARES_SUCCESS) {
+ end_query(channel, query, status, NULL, 0);
+ goto cleanup;
+ }
+
+ ares__send_query(query, now);
+ status = ARES_SUCCESS;
+ goto cleanup;
+ }
+
+ /* If we got a truncated UDP packet and are not ignoring truncation,
+ * don't accept the packet, and switch the query to TCP if we hadn't
+ * done so already.
+ */
+ if (ares_dns_record_get_flags(rdnsrec) & ARES_FLAG_TC && !tcp &&
+ !(channel->flags & ARES_FLAG_IGNTC)) {
+ query->using_tcp = ARES_TRUE;
+ ares__send_query(query, now);
+ status = ARES_SUCCESS; /* Switched to TCP is ok */
+ goto cleanup;
+ }
+
+ /* If we aren't passing through all error packets, discard packets
+ * with SERVFAIL, NOTIMP, or REFUSED response codes.
+ */
+ if (!(channel->flags & ARES_FLAG_NOCHECKRESP)) {
+ ares_dns_rcode_t rcode = ares_dns_record_get_rcode(rdnsrec);
+ if (rcode == ARES_RCODE_SERVFAIL || rcode == ARES_RCODE_NOTIMP ||
+ rcode == ARES_RCODE_REFUSED) {
+ switch (rcode) {
+ case ARES_RCODE_SERVFAIL:
+ query->error_status = ARES_ESERVFAIL;
+ break;
+ case ARES_RCODE_NOTIMP:
+ query->error_status = ARES_ENOTIMP;
+ break;
+ case ARES_RCODE_REFUSED:
+ query->error_status = ARES_EREFUSED;
+ break;
+ default:
+ break;
+ }
+ server_increment_failures(server);
+ ares__requeue_query(query, now);
+
+ /* Should any of these cause a connection termination?
+ * Maybe SERVER_FAILURE? */
+ status = ARES_SUCCESS;
+ goto cleanup;
+ }
+ }
+
+ /* If cache insertion was successful, it took ownership. We ignore
+ * other cache insertion failures. */
+ if (ares_qcache_insert(channel, now, query, rdnsrec) == ARES_SUCCESS) {
+ rdnsrec = NULL;
+ }
+
+ server_set_good(server);
+ end_query(channel, query, ARES_SUCCESS, abuf, alen);
+
+ status = ARES_SUCCESS;
+
+cleanup:
+ ares_dns_record_destroy(rdnsrec);
+ ares_dns_record_destroy(qdnsrec);
+ return status;
+}
+
+static void handle_conn_error(struct server_connection *conn,
+ ares_bool_t critical_failure)
+{
+ struct server_state *server = conn->server;
+
+ /* Increment failures first before requeue so it is unlikely to requeue
+ * to the same server */
+ if (critical_failure) {
+ server_increment_failures(server);
+ }
+
+ /* This will requeue any connections automatically */
+ ares__close_connection(conn);
+}
+
+ares_status_t ares__requeue_query(struct query *query, struct timeval *now)
+{
+ const ares_channel_t *channel = query->channel;
+ size_t max_tries = ares__slist_len(channel->servers) * channel->tries;
+
+ query->try_count++;
+
+ if (query->try_count < max_tries && !query->no_retries) {
+ return ares__send_query(query, now);
+ }
+
+ /* If we are here, all attempts to perform query failed. */
+ if (query->error_status == ARES_SUCCESS) {
+ query->error_status = ARES_ETIMEOUT;
+ }
+
+ end_query(channel, query, query->error_status, NULL, 0);
+ return ARES_ETIMEOUT;
+}
+
+/* Pick a random server from the list, we first get a random number in the
+ * range of the number of servers, then scan until we find that server in
+ * the list */
+static struct server_state *ares__random_server(ares_channel_t *channel)
+{
+ unsigned char c;
+ size_t cnt;
+ size_t idx;
+ ares__slist_node_t *node;
+ size_t num_servers = ares__slist_len(channel->servers);
+
+ /* Silence coverity, not possible */
+ if (num_servers == 0) {
+ return NULL;
+ }
+
+ ares__rand_bytes(channel->rand_state, &c, 1);
+
+ cnt = c;
+ idx = cnt % num_servers;
+
+ cnt = 0;
+ for (node = ares__slist_node_first(channel->servers); node != NULL;
+ node = ares__slist_node_next(node)) {
+ if (cnt == idx) {
+ return ares__slist_node_val(node);
+ }
+
+ cnt++;
+ }
+
+ return NULL;
+}
+
+static ares_status_t ares__append_tcpbuf(struct server_state *server,
+ const struct query *query)
+{
+ ares_status_t status;
+
+ status = ares__buf_append_be16(server->tcp_send, (unsigned short)query->qlen);
+ if (status != ARES_SUCCESS) {
+ return status;
+ }
+ return ares__buf_append(server->tcp_send, query->qbuf, query->qlen);
+}
+
+static size_t ares__calc_query_timeout(const struct query *query)
+{
+ const ares_channel_t *channel = query->channel;
+ size_t timeplus = channel->timeout;
+ size_t rounds;
+ size_t num_servers = ares__slist_len(channel->servers);
+
+ if (num_servers == 0) {
+ return 0;
+ }
+
+ /* For each trip through the entire server list, we want to double the
+ * retry from the last retry */
+ rounds = (query->try_count / num_servers);
+
+ if (rounds > 0) {
+ timeplus <<= rounds;
+ }
+
+ if (channel->maxtimeout && timeplus > channel->maxtimeout) {
+ timeplus = channel->maxtimeout;
+ }
+
+ /* Add some jitter to the retry timeout.
+ *
+ * Jitter is needed in situation when resolve requests are performed
+ * simultaneously from multiple hosts and DNS server throttle these requests.
+ * Adding randomness allows to avoid synchronisation of retries.
+ *
+ * Value of timeplus adjusted randomly to the range [0.5 * timeplus,
+ * timeplus].
+ */
+ if (rounds > 0) {
+ unsigned short r;
+ float delta_multiplier;
+
+ ares__rand_bytes(channel->rand_state, (unsigned char *)&r, sizeof(r));
+ delta_multiplier = ((float)r / USHRT_MAX) * 0.5f;
+ timeplus -= (size_t)((float)timeplus * delta_multiplier);
+ }
+
+ /* We want explicitly guarantee that timeplus is greater or equal to timeout
+ * specified in channel options. */
+ if (timeplus < channel->timeout) {
+ timeplus = channel->timeout;
+ }
+
+ return timeplus;
+}
+
+ares_status_t ares__send_query(struct query *query, struct timeval *now)
+{
+ ares_channel_t *channel = query->channel;
+ struct server_state *server;
+ struct server_connection *conn;
+ size_t timeplus;
+ ares_status_t status;
+ ares_bool_t new_connection = ARES_FALSE;
+
+ query->conn = NULL;
+
+ /* Choose the server to send the query to */
+ if (channel->rotate) {
+ server = ares__random_server(channel);
+ } else {
+ /* Pull first */
+ server = ares__slist_first_val(channel->servers);
+ }
+
+ if (server == NULL) {
+ end_query(channel, query, ARES_ESERVFAIL /* ? */, NULL, 0);
+ return ARES_ECONNREFUSED;
+ }
+
+ if (query->using_tcp) {
+ size_t prior_len = 0;
+ /* Make sure the TCP socket for this server is set up and queue
+ * a send request.
+ */
+ if (server->tcp_conn == NULL) {
+ new_connection = ARES_TRUE;
+ status = ares__open_connection(channel, server, ARES_TRUE);
+ switch (status) {
+ /* Good result, continue on */
+ case ARES_SUCCESS:
+ break;
+
+ /* These conditions are retryable as they are server-specific
+ * error codes */
+ case ARES_ECONNREFUSED:
+ case ARES_EBADFAMILY:
+ server_increment_failures(server);
+ query->error_status = status;
+ return ares__requeue_query(query, now);
+
+ /* Anything else is not retryable, likely ENOMEM */
+ default:
+ end_query(channel, query, status, NULL, 0);
+ return status;
+ }
+ }
+
+ conn = server->tcp_conn;
+
+ prior_len = ares__buf_len(server->tcp_send);
+
+ status = ares__append_tcpbuf(server, query);
+ if (status != ARES_SUCCESS) {
+ end_query(channel, query, status, NULL, 0);
+
+ /* Only safe to kill connection if it was new, otherwise it should be
+ * cleaned up by another process later */
+ if (new_connection) {
+ ares__close_connection(conn);
+ }
+ return status;
+ }
+
+ if (prior_len == 0) {
+ SOCK_STATE_CALLBACK(channel, conn->fd, 1, 1);
+ }
+
+ } else {
+ ares__llist_node_t *node = ares__llist_node_first(server->connections);
+
+ /* Don't use the found connection if we've gone over the maximum number
+ * of queries. Also, skip over the TCP connection if it is the first in
+ * the list */
+ if (node != NULL) {
+ conn = ares__llist_node_val(node);
+ if (conn->is_tcp) {
+ node = NULL;
+ } else if (channel->udp_max_queries > 0 &&
+ conn->total_queries >= channel->udp_max_queries) {
+ node = NULL;
+ }
+ }
+
+ if (node == NULL) {
+ new_connection = ARES_TRUE;
+ status = ares__open_connection(channel, server, ARES_FALSE);
+ switch (status) {
+ /* Good result, continue on */
+ case ARES_SUCCESS:
+ break;
+
+ /* These conditions are retryable as they are server-specific
+ * error codes */
+ case ARES_ECONNREFUSED:
+ case ARES_EBADFAMILY:
+ server_increment_failures(server);
+ query->error_status = status;
+ return ares__requeue_query(query, now);
+
+ /* Anything else is not retryable, likely ENOMEM */
+ default:
+ end_query(channel, query, status, NULL, 0);
+ return status;
+ }
+ node = ares__llist_node_first(server->connections);
+ }
+
+ conn = ares__llist_node_val(node);
+ if (ares__socket_write(channel, conn->fd, query->qbuf, query->qlen) == -1) {
+ /* FIXME: Handle EAGAIN here since it likely can happen. */
+ server_increment_failures(server);
+ status = ares__requeue_query(query, now);
+
+ /* Only safe to kill connection if it was new, otherwise it should be
+ * cleaned up by another process later */
+ if (new_connection) {
+ ares__close_connection(conn);
+ }
+
+ return status;
+ }
+ }
+
+ timeplus = ares__calc_query_timeout(query);
+
+ /* Keep track of queries bucketed by timeout, so we can process
+ * timeout events quickly.
+ */
+ ares__slist_node_destroy(query->node_queries_by_timeout);
+ query->timeout = *now;
+ timeadd(&query->timeout, timeplus);
+ query->node_queries_by_timeout =
+ ares__slist_insert(channel->queries_by_timeout, query);
+ if (!query->node_queries_by_timeout) {
+ end_query(channel, query, ARES_ENOMEM, NULL, 0);
+ /* Only safe to kill connection if it was new, otherwise it should be
+ * cleaned up by another process later */
+ if (new_connection) {
+ ares__close_connection(conn);
+ }
+ return ARES_ENOMEM;
+ }
+
+ /* Keep track of queries bucketed by connection, so we can process errors
+ * quickly. */
+ ares__llist_node_destroy(query->node_queries_to_conn);
+ query->node_queries_to_conn =
+ ares__llist_insert_last(conn->queries_to_conn, query);
+
+ if (query->node_queries_to_conn == NULL) {
+ end_query(channel, query, ARES_ENOMEM, NULL, 0);
+ /* Only safe to kill connection if it was new, otherwise it should be
+ * cleaned up by another process later */
+ if (new_connection) {
+ ares__close_connection(conn);
+ }
+ return ARES_ENOMEM;
+ }
+
+ query->conn = conn;
+ conn->total_queries++;
+ return ARES_SUCCESS;
+}
+
+static ares_bool_t same_questions(const ares_dns_record_t *qrec,
+ const ares_dns_record_t *arec)
+{
+ size_t i;
+ ares_bool_t rv = ARES_FALSE;
+
+
+ if (ares_dns_record_query_cnt(qrec) != ares_dns_record_query_cnt(arec)) {
+ goto done;
+ }
+
+ for (i = 0; i < ares_dns_record_query_cnt(qrec); i++) {
+ const char *qname = NULL;
+ const char *aname = NULL;
+ ares_dns_rec_type_t qtype;
+ ares_dns_rec_type_t atype;
+ ares_dns_class_t qclass;
+ ares_dns_class_t aclass;
+
+ if (ares_dns_record_query_get(qrec, i, &qname, &qtype, &qclass) !=
+ ARES_SUCCESS ||
+ qname == NULL) {
+ goto done;
+ }
+
+ if (ares_dns_record_query_get(arec, i, &aname, &atype, &aclass) !=
+ ARES_SUCCESS ||
+ aname == NULL) {
+ goto done;
+ }
+ if (strcasecmp(qname, aname) != 0 || qtype != atype || qclass != aclass) {
+ goto done;
+ }
+ }
+
+ rv = ARES_TRUE;
+
+done:
+ return rv;
+}
+
+static ares_bool_t same_address(const struct sockaddr *sa,
+ const struct ares_addr *aa)
+{
+ const void *addr1;
+ const void *addr2;
+
+ if (sa->sa_family == aa->family) {
+ switch (aa->family) {
+ case AF_INET:
+ addr1 = &aa->addr.addr4;
+ addr2 = &(CARES_INADDR_CAST(struct sockaddr_in *, sa))->sin_addr;
+ if (memcmp(addr1, addr2, sizeof(aa->addr.addr4)) == 0) {
+ return ARES_TRUE; /* match */
+ }
+ break;
+ case AF_INET6:
+ addr1 = &aa->addr.addr6;
+ addr2 = &(CARES_INADDR_CAST(struct sockaddr_in6 *, sa))->sin6_addr;
+ if (memcmp(addr1, addr2, sizeof(aa->addr.addr6)) == 0) {
+ return ARES_TRUE; /* match */
+ }
+ break;
+ default:
+ break; /* LCOV_EXCL_LINE */
+ }
+ }
+ return ARES_FALSE; /* different */
+}
+
+static void ares_detach_query(struct query *query)
+{
+ /* Remove the query from all the lists in which it is linked */
+ ares__htable_szvp_remove(query->channel->queries_by_qid, query->qid);
+ ares__slist_node_destroy(query->node_queries_by_timeout);
+ ares__llist_node_destroy(query->node_queries_to_conn);
+ ares__llist_node_destroy(query->node_all_queries);
+ query->node_queries_by_timeout = NULL;
+ query->node_queries_to_conn = NULL;
+ query->node_all_queries = NULL;
+}
+
+static void end_query(const ares_channel_t *channel, struct query *query,
+ ares_status_t status, const unsigned char *abuf,
+ size_t alen)
+{
+ (void)channel;
+
+ /* Invoke the callback. */
+ query->callback(query->arg, (int)status, (int)query->timeouts,
+ /* due to prior design flaws, abuf isn't meant to be modified,
+ * but bad prototypes, ugh. Lets cast off constfor compat. */
+ (unsigned char *)((void *)((size_t)abuf)), (int)alen);
+ ares__free_query(query);
+}
+
+void ares__free_query(struct query *query)
+{
+ ares_detach_query(query);
+ /* Zero out some important stuff, to help catch bugs */
+ query->callback = NULL;
+ query->arg = NULL;
+ /* Deallocate the memory associated with the query */
+ ares_free(query->qbuf);
+
+ ares_free(query);
+}
diff --git a/subprojects/c-ares/src/lib/ares_qcache.c b/subprojects/c-ares/src/lib/ares_qcache.c
@@ -0,0 +1,455 @@
+/* MIT License
+ *
+ * Copyright (c) 2023 Brad House
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice (including the next
+ * paragraph) shall be included in all copies or substantial portions of the
+ * Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ *
+ * SPDX-License-Identifier: MIT
+ */
+#include "ares_setup.h"
+#include "ares.h"
+#include "ares_private.h"
+
+struct ares__qcache {
+ ares__htable_strvp_t *cache;
+ ares__slist_t *expire;
+ unsigned int max_ttl;
+};
+
+typedef struct {
+ char *key;
+ ares_dns_record_t *dnsrec;
+ time_t expire_ts;
+ time_t insert_ts;
+} ares__qcache_entry_t;
+
+static char *ares__qcache_calc_key(const ares_dns_record_t *dnsrec)
+{
+ ares__buf_t *buf = ares__buf_create();
+ size_t i;
+ ares_status_t status;
+ ares_dns_flags_t flags;
+
+ if (dnsrec == NULL || buf == NULL) {
+ return NULL;
+ }
+
+ /* Format is OPCODE|FLAGS[|QTYPE1|QCLASS1|QNAME1]... */
+
+ status = ares__buf_append_str(
+ buf, ares_dns_opcode_tostr(ares_dns_record_get_opcode(dnsrec)));
+ if (status != ARES_SUCCESS) {
+ goto fail;
+ }
+
+ status = ares__buf_append_byte(buf, '|');
+ if (status != ARES_SUCCESS) {
+ goto fail;
+ }
+
+ flags = ares_dns_record_get_flags(dnsrec);
+ /* Only care about RD and CD */
+ if (flags & ARES_FLAG_RD) {
+ status = ares__buf_append_str(buf, "rd");
+ if (status != ARES_SUCCESS) {
+ goto fail;
+ }
+ }
+ if (flags & ARES_FLAG_CD) {
+ status = ares__buf_append_str(buf, "cd");
+ if (status != ARES_SUCCESS) {
+ goto fail;
+ }
+ }
+
+ for (i = 0; i < ares_dns_record_query_cnt(dnsrec); i++) {
+ const char *name;
+ ares_dns_rec_type_t qtype;
+ ares_dns_class_t qclass;
+
+ status = ares_dns_record_query_get(dnsrec, i, &name, &qtype, &qclass);
+ if (status != ARES_SUCCESS) {
+ goto fail;
+ }
+
+ status = ares__buf_append_byte(buf, '|');
+ if (status != ARES_SUCCESS) {
+ goto fail;
+ }
+
+ status = ares__buf_append_str(buf, ares_dns_rec_type_tostr(qtype));
+ if (status != ARES_SUCCESS) {
+ goto fail;
+ }
+
+ status = ares__buf_append_byte(buf, '|');
+ if (status != ARES_SUCCESS) {
+ goto fail;
+ }
+
+ status = ares__buf_append_str(buf, ares_dns_class_tostr(qclass));
+ if (status != ARES_SUCCESS) {
+ goto fail;
+ }
+
+ status = ares__buf_append_byte(buf, '|');
+ if (status != ARES_SUCCESS) {
+ goto fail;
+ }
+
+ status = ares__buf_append_str(buf, name);
+ if (status != ARES_SUCCESS) {
+ goto fail;
+ }
+ }
+
+ return ares__buf_finish_str(buf, NULL);
+
+fail:
+ ares__buf_destroy(buf);
+ return NULL;
+}
+
+static void ares__qcache_expire(ares__qcache_t *cache,
+ const struct timeval *now)
+{
+ ares__slist_node_t *node;
+
+ if (cache == NULL) {
+ return;
+ }
+
+ while ((node = ares__slist_node_first(cache->expire)) != NULL) {
+ const ares__qcache_entry_t *entry = ares__slist_node_val(node);
+ if (entry->expire_ts > now->tv_sec) {
+ break;
+ }
+
+ ares__htable_strvp_remove(cache->cache, entry->key);
+ ares__slist_node_destroy(node);
+ }
+}
+
+void ares__qcache_flush(ares__qcache_t *cache)
+{
+ struct timeval now;
+ memset(&now, 0, sizeof(now));
+ ares__qcache_expire(cache, &now);
+}
+
+void ares__qcache_destroy(ares__qcache_t *cache)
+{
+ if (cache == NULL) {
+ return;
+ }
+
+ ares__htable_strvp_destroy(cache->cache);
+ ares__slist_destroy(cache->expire);
+ ares_free(cache);
+}
+
+static int ares__qcache_entry_sort_cb(const void *arg1, const void *arg2)
+{
+ const ares__qcache_entry_t *entry1 = arg1;
+ const ares__qcache_entry_t *entry2 = arg2;
+
+ if (entry1->expire_ts > entry2->expire_ts) {
+ return 1;
+ }
+
+ if (entry1->expire_ts < entry2->expire_ts) {
+ return -1;
+ }
+
+ return 0;
+}
+
+static void ares__qcache_entry_destroy_cb(void *arg)
+{
+ ares__qcache_entry_t *entry = arg;
+ if (entry == NULL) {
+ return;
+ }
+
+ ares_free(entry->key);
+ ares_dns_record_destroy(entry->dnsrec);
+ ares_free(entry);
+}
+
+ares_status_t ares__qcache_create(ares_rand_state *rand_state,
+ unsigned int max_ttl,
+ ares__qcache_t **cache_out)
+{
+ ares_status_t status = ARES_SUCCESS;
+ ares__qcache_t *cache;
+
+ cache = ares_malloc_zero(sizeof(*cache));
+ if (cache == NULL) {
+ status = ARES_ENOMEM;
+ goto done;
+ }
+
+ cache->cache = ares__htable_strvp_create(NULL);
+ if (cache->cache == NULL) {
+ status = ARES_ENOMEM;
+ goto done;
+ }
+
+ cache->expire = ares__slist_create(rand_state, ares__qcache_entry_sort_cb,
+ ares__qcache_entry_destroy_cb);
+ if (cache->expire == NULL) {
+ status = ARES_ENOMEM;
+ goto done;
+ }
+
+ cache->max_ttl = max_ttl;
+
+done:
+ if (status != ARES_SUCCESS) {
+ *cache_out = NULL;
+ ares__qcache_destroy(cache);
+ return status;
+ }
+
+ *cache_out = cache;
+ return status;
+}
+
+static unsigned int ares__qcache_calc_minttl(ares_dns_record_t *dnsrec)
+{
+ unsigned int minttl = 0xFFFFFFFF;
+ size_t sect;
+
+ for (sect = ARES_SECTION_ANSWER; sect <= ARES_SECTION_ADDITIONAL; sect++) {
+ size_t i;
+ for (i = 0; i < ares_dns_record_rr_cnt(dnsrec, (ares_dns_section_t)sect);
+ i++) {
+ const ares_dns_rr_t *rr =
+ ares_dns_record_rr_get(dnsrec, (ares_dns_section_t)sect, i);
+ ares_dns_rec_type_t type = ares_dns_rr_get_type(rr);
+ unsigned int ttl = ares_dns_rr_get_ttl(rr);
+ if (type == ARES_REC_TYPE_OPT || type == ARES_REC_TYPE_SOA) {
+ continue;
+ }
+
+ if (ttl < minttl) {
+ minttl = ttl;
+ }
+ }
+ }
+
+ return minttl;
+}
+
+static unsigned int ares__qcache_soa_minimum(ares_dns_record_t *dnsrec)
+{
+ size_t i;
+
+ /* RFC 2308 Section 5 says its the minimum of MINIMUM and the TTL of the
+ * record. */
+ for (i = 0; i < ares_dns_record_rr_cnt(dnsrec, ARES_SECTION_AUTHORITY); i++) {
+ const ares_dns_rr_t *rr =
+ ares_dns_record_rr_get(dnsrec, ARES_SECTION_AUTHORITY, i);
+ ares_dns_rec_type_t type = ares_dns_rr_get_type(rr);
+ unsigned int ttl;
+ unsigned int minimum;
+
+ if (type != ARES_REC_TYPE_SOA) {
+ continue;
+ }
+
+ minimum = ares_dns_rr_get_u32(rr, ARES_RR_SOA_MINIMUM);
+ ttl = ares_dns_rr_get_ttl(rr);
+
+ if (ttl > minimum) {
+ return minimum;
+ }
+ return ttl;
+ }
+
+ return 0;
+}
+
+static char *ares__qcache_calc_key_frombuf(const unsigned char *qbuf,
+ size_t qlen)
+{
+ ares_status_t status;
+ ares_dns_record_t *dnsrec = NULL;
+ char *key = NULL;
+
+ status = ares_dns_parse(qbuf, qlen, 0, &dnsrec);
+ if (status != ARES_SUCCESS) {
+ goto done;
+ }
+
+ key = ares__qcache_calc_key(dnsrec);
+
+done:
+ ares_dns_record_destroy(dnsrec);
+ return key;
+}
+
+/* On success, takes ownership of dnsrec */
+static ares_status_t ares__qcache_insert(ares__qcache_t *qcache,
+ ares_dns_record_t *dnsrec,
+ const unsigned char *qbuf, size_t qlen,
+ const struct timeval *now)
+{
+ ares__qcache_entry_t *entry;
+ unsigned int ttl;
+ ares_dns_rcode_t rcode = ares_dns_record_get_rcode(dnsrec);
+ ares_dns_flags_t flags = ares_dns_record_get_flags(dnsrec);
+
+ if (qcache == NULL || dnsrec == NULL) {
+ return ARES_EFORMERR;
+ }
+
+ /* Only save NOERROR or NXDOMAIN */
+ if (rcode != ARES_RCODE_NOERROR && rcode != ARES_RCODE_NXDOMAIN) {
+ return ARES_ENOTIMP;
+ }
+
+ /* Don't save truncated queries */
+ if (flags & ARES_FLAG_TC) {
+ return ARES_ENOTIMP;
+ }
+
+ /* Look at SOA for NXDOMAIN for minimum */
+ if (rcode == ARES_RCODE_NXDOMAIN) {
+ ttl = ares__qcache_soa_minimum(dnsrec);
+ } else {
+ ttl = ares__qcache_calc_minttl(dnsrec);
+ }
+
+ /* Don't cache something that is already expired */
+ if (ttl == 0) {
+ return ARES_EREFUSED;
+ }
+
+ if (ttl > qcache->max_ttl) {
+ ttl = qcache->max_ttl;
+ }
+
+ entry = ares_malloc_zero(sizeof(*entry));
+ if (entry == NULL) {
+ goto fail;
+ }
+
+ entry->dnsrec = dnsrec;
+ entry->expire_ts = now->tv_sec + (time_t)ttl;
+ entry->insert_ts = now->tv_sec;
+
+ /* We can't guarantee the server responded with the same flags as the
+ * request had, so we have to re-parse the request in order to generate the
+ * key for caching, but we'll only do this once we know for sure we really
+ * want to cache it */
+ entry->key = ares__qcache_calc_key_frombuf(qbuf, qlen);
+ if (entry->key == NULL) {
+ goto fail;
+ }
+
+ if (!ares__htable_strvp_insert(qcache->cache, entry->key, entry)) {
+ goto fail;
+ }
+
+ if (ares__slist_insert(qcache->expire, entry) == NULL) {
+ goto fail;
+ }
+
+ return ARES_SUCCESS;
+
+fail:
+ if (entry != NULL && entry->key != NULL) {
+ ares__htable_strvp_remove(qcache->cache, entry->key);
+ ares_free(entry->key);
+ ares_free(entry);
+ }
+ return ARES_ENOMEM;
+}
+
+static ares_status_t ares__qcache_fetch(ares__qcache_t *qcache,
+ const ares_dns_record_t *dnsrec,
+ const struct timeval *now,
+ unsigned char **buf, size_t *buf_len)
+{
+ char *key = NULL;
+ ares__qcache_entry_t *entry;
+ ares_status_t status;
+
+ if (qcache == NULL || dnsrec == NULL) {
+ return ARES_EFORMERR;
+ }
+
+ ares__qcache_expire(qcache, now);
+
+ key = ares__qcache_calc_key(dnsrec);
+ if (key == NULL) {
+ status = ARES_ENOMEM;
+ goto done;
+ }
+
+ entry = ares__htable_strvp_get_direct(qcache->cache, key);
+ if (entry == NULL) {
+ status = ARES_ENOTFOUND;
+ goto done;
+ }
+
+ ares_dns_record_write_ttl_decrement(
+ entry->dnsrec, (unsigned int)(now->tv_sec - entry->insert_ts));
+
+ status = ares_dns_write(entry->dnsrec, buf, buf_len);
+
+done:
+ ares_free(key);
+ return status;
+}
+
+ares_status_t ares_qcache_insert(ares_channel_t *channel,
+ const struct timeval *now,
+ const struct query *query,
+ ares_dns_record_t *dnsrec)
+{
+ return ares__qcache_insert(channel->qcache, dnsrec, query->qbuf, query->qlen,
+ now);
+}
+
+ares_status_t ares_qcache_fetch(ares_channel_t *channel,
+ const struct timeval *now,
+ const unsigned char *qbuf, size_t qlen,
+ unsigned char **abuf, size_t *alen)
+{
+ ares_status_t status;
+ ares_dns_record_t *dnsrec = NULL;
+
+ if (channel->qcache == NULL) {
+ return ARES_ENOTFOUND;
+ }
+
+ status = ares_dns_parse(qbuf, qlen, 0, &dnsrec);
+ if (status != ARES_SUCCESS) {
+ goto done;
+ }
+
+ status = ares__qcache_fetch(channel->qcache, dnsrec, now, abuf, alen);
+
+done:
+ ares_dns_record_destroy(dnsrec);
+ return status;
+}
diff --git a/subprojects/c-ares/src/lib/ares_query.c b/subprojects/c-ares/src/lib/ares_query.c
@@ -0,0 +1,139 @@
+/* MIT License
+ *
+ * Copyright (c) 1998 Massachusetts Institute of Technology
+ * Copyright (c) The c-ares project and its contributors
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice (including the next
+ * paragraph) shall be included in all copies or substantial portions of the
+ * Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ *
+ * SPDX-License-Identifier: MIT
+ */
+
+#include "ares_setup.h"
+
+#ifdef HAVE_NETINET_IN_H
+# include <netinet/in.h>
+#endif
+
+#include "ares_nameser.h"
+
+#include "ares.h"
+#include "ares_dns.h"
+#include "ares_private.h"
+
+struct qquery {
+ ares_callback callback;
+ void *arg;
+};
+
+static void qcallback(void *arg, int status, int timeouts, unsigned char *abuf,
+ int alen);
+
+ares_status_t ares_query_qid(ares_channel_t *channel, const char *name,
+ int dnsclass, int type, ares_callback callback,
+ void *arg, unsigned short *qid)
+{
+ struct qquery *qquery;
+ unsigned char *qbuf;
+ int qlen;
+ int rd;
+ ares_status_t status;
+
+ /* Compose the query. */
+ rd = !(channel->flags & ARES_FLAG_NORECURSE);
+ status = (ares_status_t)ares_create_query(
+ name, dnsclass, type, 0, rd, &qbuf, &qlen,
+ (channel->flags & ARES_FLAG_EDNS) ? (int)channel->ednspsz : 0);
+ if (status != ARES_SUCCESS) {
+ if (qbuf != NULL) {
+ ares_free(qbuf);
+ }
+ callback(arg, (int)status, 0, NULL, 0);
+ return status;
+ }
+
+ /* Allocate and fill in the query structure. */
+ qquery = ares_malloc(sizeof(struct qquery));
+ if (!qquery) {
+ ares_free_string(qbuf);
+ callback(arg, ARES_ENOMEM, 0, NULL, 0);
+ return ARES_ENOMEM;
+ }
+ qquery->callback = callback;
+ qquery->arg = arg;
+
+ /* Send it off. qcallback will be called when we get an answer. */
+ status = ares_send_ex(channel, qbuf, (size_t)qlen, qcallback, qquery, qid);
+ ares_free_string(qbuf);
+
+ return status;
+}
+
+void ares_query(ares_channel_t *channel, const char *name, int dnsclass,
+ int type, ares_callback callback, void *arg)
+{
+ if (channel == NULL) {
+ return;
+ }
+ ares__channel_lock(channel);
+ ares_query_qid(channel, name, dnsclass, type, callback, arg, NULL);
+ ares__channel_unlock(channel);
+}
+
+static void qcallback(void *arg, int status, int timeouts, unsigned char *abuf,
+ int alen)
+{
+ struct qquery *qquery = (struct qquery *)arg;
+ size_t ancount;
+ int rcode;
+
+ if (status != ARES_SUCCESS) {
+ qquery->callback(qquery->arg, status, timeouts, abuf, alen);
+ } else {
+ /* Pull the response code and answer count from the packet. */
+ rcode = DNS_HEADER_RCODE(abuf);
+ ancount = DNS_HEADER_ANCOUNT(abuf);
+
+ /* Convert errors. */
+ switch (rcode) {
+ case NOERROR:
+ status = (ancount > 0) ? ARES_SUCCESS : ARES_ENODATA;
+ break;
+ case FORMERR:
+ status = ARES_EFORMERR;
+ break;
+ case SERVFAIL:
+ status = ARES_ESERVFAIL;
+ break;
+ case NXDOMAIN:
+ status = ARES_ENOTFOUND;
+ break;
+ case NOTIMP:
+ status = ARES_ENOTIMP;
+ break;
+ case REFUSED:
+ status = ARES_EREFUSED;
+ break;
+ default:
+ break;
+ }
+ qquery->callback(qquery->arg, status, timeouts, abuf, alen);
+ }
+ ares_free(qquery);
+}
diff --git a/subprojects/c-ares/src/lib/ares_rand.c b/subprojects/c-ares/src/lib/ares_rand.c
@@ -0,0 +1,346 @@
+/* MIT License
+ *
+ * Copyright (c) 2023 Brad House
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice (including the next
+ * paragraph) shall be included in all copies or substantial portions of the
+ * Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ *
+ * SPDX-License-Identifier: MIT
+ */
+
+#include "ares_setup.h"
+#include "ares.h"
+#include "ares_private.h"
+#include <stdlib.h>
+#ifdef HAVE_SYS_RANDOM_H
+# include <sys/random.h>
+#endif
+
+
+typedef enum {
+ ARES_RAND_OS = 1 << 0, /* OS-provided such as RtlGenRandom or arc4random */
+ ARES_RAND_FILE = 1 << 1, /* OS file-backed random number generator */
+ ARES_RAND_RC4 = 1 << 2, /* Internal RC4 based PRNG */
+} ares_rand_backend;
+
+#define ARES_RC4_KEY_LEN 32 /* 256 bits */
+
+typedef struct ares_rand_rc4 {
+ unsigned char S[256];
+ size_t i;
+ size_t j;
+} ares_rand_rc4;
+
+static unsigned int ares_u32_from_ptr(void *addr)
+{
+ if (sizeof(void *) == 8) {
+ return (unsigned int)((((ares_uint64_t)addr >> 32) & 0xFFFFFFFF) |
+ ((ares_uint64_t)addr & 0xFFFFFFFF));
+ }
+ return (unsigned int)((size_t)addr & 0xFFFFFFFF);
+}
+
+/* initialize an rc4 key as the last possible fallback. */
+static void ares_rc4_generate_key(ares_rand_rc4 *rc4_state, unsigned char *key,
+ size_t key_len)
+{
+ size_t i;
+ size_t len = 0;
+ unsigned int data;
+ struct timeval tv;
+
+ if (key_len != ARES_RC4_KEY_LEN) {
+ return;
+ }
+
+ /* Randomness is hard to come by. Maybe the system randomizes heap and stack
+ * addresses. Maybe the current timestamp give us some randomness. Use
+ * rc4_state (heap), &i (stack), and ares__tvnow()
+ */
+ data = ares_u32_from_ptr(rc4_state);
+ memcpy(key + len, &data, sizeof(data));
+ len += sizeof(data);
+
+ data = ares_u32_from_ptr(&i);
+ memcpy(key + len, &data, sizeof(data));
+ len += sizeof(data);
+
+ tv = ares__tvnow();
+ data = (unsigned int)((tv.tv_sec | tv.tv_usec) & 0xFFFFFFFF);
+ memcpy(key + len, &data, sizeof(data));
+ len += sizeof(data);
+
+ srand(ares_u32_from_ptr(rc4_state) | ares_u32_from_ptr(&i) |
+ (unsigned int)((tv.tv_sec | tv.tv_usec) & 0xFFFFFFFF));
+
+ for (i = len; i < key_len; i++) {
+ key[i] = (unsigned char)(rand() % 256); /* LCOV_EXCL_LINE */
+ }
+}
+
+static void ares_rc4_init(ares_rand_rc4 *rc4_state)
+{
+ unsigned char key[ARES_RC4_KEY_LEN];
+ size_t i;
+ size_t j;
+
+ ares_rc4_generate_key(rc4_state, key, sizeof(key));
+
+ for (i = 0; i < sizeof(rc4_state->S); i++) {
+ rc4_state->S[i] = i & 0xFF;
+ }
+
+ for (i = 0, j = 0; i < 256; i++) {
+ j = (j + rc4_state->S[i] + key[i % sizeof(key)]) % 256;
+ ARES_SWAP_BYTE(&rc4_state->S[i], &rc4_state->S[j]);
+ }
+
+ rc4_state->i = 0;
+ rc4_state->j = 0;
+}
+
+/* Just outputs the key schedule, no need to XOR with any data since we have
+ * none */
+static void ares_rc4_prng(ares_rand_rc4 *rc4_state, unsigned char *buf,
+ size_t len)
+{
+ unsigned char *S = rc4_state->S;
+ size_t i = rc4_state->i;
+ size_t j = rc4_state->j;
+ size_t cnt;
+
+ for (cnt = 0; cnt < len; cnt++) {
+ i = (i + 1) % 256;
+ j = (j + S[i]) % 256;
+
+ ARES_SWAP_BYTE(&S[i], &S[j]);
+ buf[cnt] = S[(S[i] + S[j]) % 256];
+ }
+
+ rc4_state->i = i;
+ rc4_state->j = j;
+}
+
+struct ares_rand_state {
+ ares_rand_backend type;
+ ares_rand_backend bad_backends;
+
+ union {
+ FILE *rand_file;
+ ares_rand_rc4 rc4;
+ } state;
+
+ /* Since except for RC4, random data will likely result in a syscall, lets
+ * pre-pull 256 bytes at a time. Every query will pull 2 bytes off this so
+ * that means we should only need a syscall every 128 queries. 256bytes
+ * appears to be a sweet spot that may be able to be served without
+ * interruption */
+ unsigned char cache[256];
+ size_t cache_remaining;
+};
+
+/* Define RtlGenRandom = SystemFunction036. This is in advapi32.dll. There is
+ * no need to dynamically load this, other software used widely does not.
+ * http://blogs.msdn.com/michael_howard/archive/2005/01/14/353379.aspx
+ * https://docs.microsoft.com/en-us/windows/win32/api/ntsecapi/nf-ntsecapi-rtlgenrandom
+ */
+#ifdef _WIN32
+BOOLEAN WINAPI SystemFunction036(PVOID RandomBuffer, ULONG RandomBufferLength);
+# ifndef RtlGenRandom
+# define RtlGenRandom(a, b) SystemFunction036(a, b)
+# endif
+#endif
+
+
+static ares_bool_t ares__init_rand_engine(ares_rand_state *state)
+{
+ state->cache_remaining = 0;
+
+#if defined(HAVE_ARC4RANDOM_BUF) || defined(HAVE_GETRANDOM) || defined(_WIN32)
+ if (!(state->bad_backends & ARES_RAND_OS)) {
+ state->type = ARES_RAND_OS;
+ return ARES_TRUE;
+ }
+#endif
+
+#if defined(CARES_RANDOM_FILE)
+ if (!(state->bad_backends & ARES_RAND_FILE)) {
+ state->type = ARES_RAND_FILE;
+ state->state.rand_file = fopen(CARES_RANDOM_FILE, "rb");
+ if (state->state.rand_file) {
+ setvbuf(state->state.rand_file, NULL, _IONBF, 0);
+ return ARES_TRUE;
+ }
+ }
+ /* Fall-Thru on failure to RC4 */
+#endif
+
+ state->type = ARES_RAND_RC4;
+ ares_rc4_init(&state->state.rc4);
+
+ /* Currently cannot fail */
+ return ARES_TRUE;
+}
+
+ares_rand_state *ares__init_rand_state(void)
+{
+ ares_rand_state *state = NULL;
+
+ state = ares_malloc_zero(sizeof(*state));
+ if (!state) {
+ return NULL;
+ }
+
+ if (!ares__init_rand_engine(state)) {
+ ares_free(state);
+ return NULL;
+ }
+
+ return state;
+}
+
+static void ares__clear_rand_state(ares_rand_state *state)
+{
+ if (!state) {
+ return;
+ }
+
+ switch (state->type) {
+ case ARES_RAND_OS:
+ break;
+ case ARES_RAND_FILE:
+ fclose(state->state.rand_file);
+ break;
+ case ARES_RAND_RC4:
+ break;
+ }
+}
+
+static void ares__reinit_rand(ares_rand_state *state)
+{
+ ares__clear_rand_state(state);
+ ares__init_rand_engine(state);
+}
+
+void ares__destroy_rand_state(ares_rand_state *state)
+{
+ if (!state) {
+ return;
+ }
+
+ ares__clear_rand_state(state);
+ ares_free(state);
+}
+
+static void ares__rand_bytes_fetch(ares_rand_state *state, unsigned char *buf,
+ size_t len)
+{
+ while (1) {
+ size_t bytes_read = 0;
+
+ switch (state->type) {
+ case ARES_RAND_OS:
+#ifdef _WIN32
+ RtlGenRandom(buf, (ULONG)len);
+ return;
+#elif defined(HAVE_ARC4RANDOM_BUF)
+ arc4random_buf(buf, len);
+ return;
+#elif defined(HAVE_GETRANDOM)
+ while (1) {
+ size_t n = len - bytes_read;
+ /* getrandom() on Linux always succeeds and is never
+ * interrupted by a signal when requesting <= 256 bytes.
+ */
+ ssize_t rv = getrandom(buf + bytes_read, n > 256 ? 256 : n, 0);
+ if (rv <= 0) {
+ /* We need to fall back to another backend */
+ if (errno == ENOSYS) {
+ state->bad_backends |= ARES_RAND_OS;
+ break;
+ }
+ continue; /* Just retry. */
+ }
+
+ bytes_read += (size_t)rv;
+ if (bytes_read == len) {
+ return;
+ }
+ }
+ break;
+#else
+ /* Shouldn't be possible to be here */
+ break;
+#endif
+
+ case ARES_RAND_FILE:
+ while (1) {
+ size_t rv = fread(buf + bytes_read, 1, len - bytes_read,
+ state->state.rand_file);
+ if (rv == 0) {
+ break; /* critical error, will reinit rand state */
+ }
+
+ bytes_read += rv;
+ if (bytes_read == len) {
+ return;
+ }
+ }
+ break;
+
+ case ARES_RAND_RC4:
+ ares_rc4_prng(&state->state.rc4, buf, len);
+ return;
+ }
+
+ /* If we didn't return before we got here, that means we had a critical rand
+ * failure and need to reinitialized */
+ ares__reinit_rand(state);
+ }
+}
+
+void ares__rand_bytes(ares_rand_state *state, unsigned char *buf, size_t len)
+{
+ /* See if we need to refill the cache to serve the request, but if len is
+ * excessive, we're not going to update our cache or serve from cache */
+ if (len > state->cache_remaining && len < sizeof(state->cache)) {
+ size_t fetch_size = sizeof(state->cache) - state->cache_remaining;
+ ares__rand_bytes_fetch(state, state->cache, fetch_size);
+ state->cache_remaining = sizeof(state->cache);
+ }
+
+ /* Serve from cache */
+ if (len <= state->cache_remaining) {
+ size_t offset = sizeof(state->cache) - state->cache_remaining;
+ memcpy(buf, state->cache + offset, len);
+ state->cache_remaining -= len;
+ return;
+ }
+
+ /* Serve direct due to excess size of request */
+ ares__rand_bytes_fetch(state, buf, len);
+}
+
+unsigned short ares__generate_new_id(ares_rand_state *state)
+{
+ unsigned short r = 0;
+
+ ares__rand_bytes(state, (unsigned char *)&r, sizeof(r));
+ return r;
+}
diff --git a/subprojects/c-ares/src/lib/ares_search.c b/subprojects/c-ares/src/lib/ares_search.c
@@ -0,0 +1,348 @@
+/* MIT License
+ *
+ * Copyright (c) 1998 Massachusetts Institute of Technology
+ * Copyright (c) The c-ares project and its contributors
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice (including the next
+ * paragraph) shall be included in all copies or substantial portions of the
+ * Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ *
+ * SPDX-License-Identifier: MIT
+ */
+
+#include "ares_setup.h"
+
+#ifdef HAVE_STRINGS_H
+# include <strings.h>
+#endif
+
+#include "ares.h"
+#include "ares_private.h"
+
+struct search_query {
+ /* Arguments passed to ares_search */
+ ares_channel_t *channel;
+ char *name; /* copied into an allocated buffer */
+ int dnsclass;
+ int type;
+ ares_callback callback;
+ void *arg;
+ char **domains; /* duplicate for ares_reinit() safety */
+ size_t ndomains;
+
+ int status_as_is; /* error status from trying as-is */
+ size_t next_domain; /* next search domain to try */
+ ares_bool_t trying_as_is; /* current query is for name as-is */
+ size_t timeouts; /* number of timeouts we saw for this request */
+ ares_bool_t ever_got_nodata; /* did we ever get ARES_ENODATA along the way? */
+};
+
+static void search_callback(void *arg, int status, int timeouts,
+ unsigned char *abuf, int alen);
+static void end_squery(struct search_query *squery, ares_status_t status,
+ unsigned char *abuf, size_t alen);
+
+static void ares_search_int(ares_channel_t *channel, const char *name,
+ int dnsclass, int type, ares_callback callback,
+ void *arg)
+{
+ struct search_query *squery;
+ char *s;
+ const char *p;
+ ares_status_t status;
+ size_t ndots;
+
+ /* Per RFC 7686, reject queries for ".onion" domain names with NXDOMAIN. */
+ if (ares__is_onion_domain(name)) {
+ callback(arg, ARES_ENOTFOUND, 0, NULL, 0);
+ return;
+ }
+
+ /* If name only yields one domain to search, then we don't have
+ * to keep extra state, so just do an ares_query().
+ */
+ status = ares__single_domain(channel, name, &s);
+ if (status != ARES_SUCCESS) {
+ callback(arg, (int)status, 0, NULL, 0);
+ return;
+ }
+ if (s) {
+ ares_query(channel, s, dnsclass, type, callback, arg);
+ ares_free(s);
+ return;
+ }
+
+ /* Allocate a search_query structure to hold the state necessary for
+ * doing multiple lookups.
+ */
+ squery = ares_malloc_zero(sizeof(*squery));
+ if (!squery) {
+ callback(arg, ARES_ENOMEM, 0, NULL, 0);
+ return;
+ }
+ squery->channel = channel;
+ squery->name = ares_strdup(name);
+ if (!squery->name) {
+ ares_free(squery);
+ callback(arg, ARES_ENOMEM, 0, NULL, 0);
+ return;
+ }
+
+ /* Duplicate domains for safety during ares_reinit() */
+ if (channel->ndomains) {
+ squery->domains =
+ ares__strsplit_duplicate(channel->domains, channel->ndomains);
+ if (squery->domains == NULL) {
+ ares_free(squery->name);
+ ares_free(squery);
+ callback(arg, ARES_ENOMEM, 0, NULL, 0);
+ return;
+ }
+ squery->ndomains = channel->ndomains;
+ }
+
+ squery->dnsclass = dnsclass;
+ squery->type = type;
+ squery->status_as_is = -1;
+ squery->callback = callback;
+ squery->arg = arg;
+ squery->timeouts = 0;
+ squery->ever_got_nodata = ARES_FALSE;
+
+ /* Count the number of dots in name. */
+ ndots = 0;
+ for (p = name; *p; p++) {
+ if (*p == '.') {
+ ndots++;
+ }
+ }
+
+ /* If ndots is at least the channel ndots threshold (usually 1),
+ * then we try the name as-is first. Otherwise, we try the name
+ * as-is last.
+ */
+ if (ndots >= channel->ndots || squery->ndomains == 0) {
+ /* Try the name as-is first. */
+ squery->next_domain = 0;
+ squery->trying_as_is = ARES_TRUE;
+ ares_query(channel, name, dnsclass, type, search_callback, squery);
+ } else {
+ /* Try the name as-is last; start with the first search domain. */
+ squery->next_domain = 1;
+ squery->trying_as_is = ARES_FALSE;
+ status = ares__cat_domain(name, squery->domains[0], &s);
+ if (status == ARES_SUCCESS) {
+ ares_query(channel, s, dnsclass, type, search_callback, squery);
+ ares_free(s);
+ } else {
+ /* failed, free the malloc()ed memory */
+ ares_free(squery->name);
+ ares_free(squery);
+ callback(arg, (int)status, 0, NULL, 0);
+ }
+ }
+}
+
+void ares_search(ares_channel_t *channel, const char *name, int dnsclass,
+ int type, ares_callback callback, void *arg)
+{
+ if (channel == NULL) {
+ return;
+ }
+ ares__channel_lock(channel);
+ ares_search_int(channel, name, dnsclass, type, callback, arg);
+ ares__channel_unlock(channel);
+}
+
+static void search_callback(void *arg, int status, int timeouts,
+ unsigned char *abuf, int alen)
+{
+ struct search_query *squery = (struct search_query *)arg;
+ ares_channel_t *channel = squery->channel;
+ char *s;
+
+ squery->timeouts += (size_t)timeouts;
+
+ /* Stop searching unless we got a non-fatal error. */
+ if (status != ARES_ENODATA && status != ARES_ESERVFAIL &&
+ status != ARES_ENOTFOUND) {
+ end_squery(squery, (ares_status_t)status, abuf, (size_t)alen);
+ } else {
+ /* Save the status if we were trying as-is. */
+ if (squery->trying_as_is) {
+ squery->status_as_is = status;
+ }
+
+ /*
+ * If we ever get ARES_ENODATA along the way, record that; if the search
+ * should run to the very end and we got at least one ARES_ENODATA,
+ * then callers like ares_gethostbyname() may want to try a T_A search
+ * even if the last domain we queried for T_AAAA resource records
+ * returned ARES_ENOTFOUND.
+ */
+ if (status == ARES_ENODATA) {
+ squery->ever_got_nodata = ARES_TRUE;
+ }
+
+ if (squery->next_domain < squery->ndomains) {
+ ares_status_t mystatus;
+ /* Try the next domain. */
+ mystatus = ares__cat_domain(squery->name,
+ squery->domains[squery->next_domain], &s);
+ if (mystatus != ARES_SUCCESS) {
+ end_squery(squery, mystatus, NULL, 0);
+ } else {
+ squery->trying_as_is = ARES_FALSE;
+ squery->next_domain++;
+ ares_query(channel, s, squery->dnsclass, squery->type, search_callback,
+ squery);
+ ares_free(s);
+ }
+ } else if (squery->status_as_is == -1) {
+ /* Try the name as-is at the end. */
+ squery->trying_as_is = ARES_TRUE;
+ ares_query(channel, squery->name, squery->dnsclass, squery->type,
+ search_callback, squery);
+ } else {
+ if (squery->status_as_is == ARES_ENOTFOUND && squery->ever_got_nodata) {
+ end_squery(squery, ARES_ENODATA, NULL, 0);
+ } else {
+ end_squery(squery, (ares_status_t)squery->status_as_is, NULL, 0);
+ }
+ }
+ }
+}
+
+static void end_squery(struct search_query *squery, ares_status_t status,
+ unsigned char *abuf, size_t alen)
+{
+ squery->callback(squery->arg, (int)status, (int)squery->timeouts, abuf,
+ (int)alen);
+ ares__strsplit_free(squery->domains, squery->ndomains);
+ ares_free(squery->name);
+ ares_free(squery);
+}
+
+/* Concatenate two domains. */
+ares_status_t ares__cat_domain(const char *name, const char *domain, char **s)
+{
+ size_t nlen = ares_strlen(name);
+ size_t dlen = ares_strlen(domain);
+
+ *s = ares_malloc(nlen + 1 + dlen + 1);
+ if (!*s) {
+ return ARES_ENOMEM;
+ }
+ memcpy(*s, name, nlen);
+ (*s)[nlen] = '.';
+ if (strcmp(domain, ".") == 0) {
+ /* Avoid appending the root domain to the separator, which would set *s to
+ an ill-formed value (ending in two consecutive dots). */
+ dlen = 0;
+ }
+ memcpy(*s + nlen + 1, domain, dlen);
+ (*s)[nlen + 1 + dlen] = 0;
+ return ARES_SUCCESS;
+}
+
+/* Determine if this name only yields one query. If it does, set *s to
+ * the string we should query, in an allocated buffer. If not, set *s
+ * to NULL.
+ */
+ares_status_t ares__single_domain(const ares_channel_t *channel,
+ const char *name, char **s)
+{
+ size_t len = ares_strlen(name);
+ const char *hostaliases;
+ FILE *fp;
+ char *line = NULL;
+ ares_status_t status;
+ size_t linesize;
+ const char *p;
+ const char *q;
+ int error;
+
+ /* If the name contains a trailing dot, then the single query is the name
+ * sans the trailing dot.
+ */
+ if ((len > 0) && (name[len - 1] == '.')) {
+ *s = ares_strdup(name);
+ return (*s) ? ARES_SUCCESS : ARES_ENOMEM;
+ }
+
+ if (!(channel->flags & ARES_FLAG_NOALIASES) && !strchr(name, '.')) {
+ /* The name might be a host alias. */
+ hostaliases = getenv("HOSTALIASES");
+ if (hostaliases) {
+ fp = fopen(hostaliases, "r");
+ if (fp) {
+ while ((status = ares__read_line(fp, &line, &linesize)) ==
+ ARES_SUCCESS) {
+ if (strncasecmp(line, name, len) != 0 || !ISSPACE(line[len])) {
+ continue;
+ }
+ p = line + len;
+ while (ISSPACE(*p)) {
+ p++;
+ }
+ if (*p) {
+ q = p + 1;
+ while (*q && !ISSPACE(*q)) {
+ q++;
+ }
+ *s = ares_malloc((size_t)(q - p + 1));
+ if (*s) {
+ memcpy(*s, p, (size_t)(q - p));
+ (*s)[q - p] = 0;
+ }
+ ares_free(line);
+ fclose(fp);
+ return (*s) ? ARES_SUCCESS : ARES_ENOMEM;
+ }
+ }
+ ares_free(line);
+ fclose(fp);
+ if (status != ARES_SUCCESS && status != ARES_EOF) {
+ return status;
+ }
+ } else {
+ error = ERRNO;
+ switch (error) {
+ case ENOENT:
+ case ESRCH:
+ break;
+ default:
+ DEBUGF(fprintf(stderr, "fopen() failed with error: %d %s\n", error,
+ strerror(error)));
+ DEBUGF(fprintf(stderr, "Error opening file: %s\n", hostaliases));
+ *s = NULL;
+ return ARES_EFILE;
+ }
+ }
+ }
+ }
+
+ if (channel->flags & ARES_FLAG_NOSEARCH || channel->ndomains == 0) {
+ /* No domain search to do; just try the name as-is. */
+ *s = ares_strdup(name);
+ return (*s) ? ARES_SUCCESS : ARES_ENOMEM;
+ }
+
+ *s = NULL;
+ return ARES_SUCCESS;
+}
diff --git a/subprojects/c-ares/src/lib/ares_send.c b/subprojects/c-ares/src/lib/ares_send.c
@@ -0,0 +1,165 @@
+/* MIT License
+ *
+ * Copyright (c) 1998 Massachusetts Institute of Technology
+ * Copyright (c) The c-ares project and its contributors
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice (including the next
+ * paragraph) shall be included in all copies or substantial portions of the
+ * Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ *
+ * SPDX-License-Identifier: MIT
+ */
+
+#include "ares_setup.h"
+
+#ifdef HAVE_NETINET_IN_H
+# include <netinet/in.h>
+#endif
+
+#include "ares_nameser.h"
+
+#include "ares.h"
+#include "ares_dns.h"
+#include "ares_private.h"
+
+static unsigned short generate_unique_qid(ares_channel_t *channel)
+{
+ unsigned short id;
+
+ do {
+ id = ares__generate_new_id(channel->rand_state);
+ } while (ares__htable_szvp_get(channel->queries_by_qid, id, NULL));
+
+ return id;
+}
+
+ares_status_t ares_send_ex(ares_channel_t *channel, const unsigned char *qbuf,
+ size_t qlen, ares_callback callback, void *arg,
+ unsigned short *qid)
+{
+ struct query *query;
+ size_t packetsz;
+ struct timeval now = ares__tvnow();
+ ares_status_t status;
+ unsigned short id = generate_unique_qid(channel);
+ unsigned char *abuf = NULL;
+ size_t alen = 0;
+
+ /* Verify that the query is at least long enough to hold the header. */
+ if (qlen < HFIXEDSZ || qlen >= (1 << 16)) {
+ callback(arg, ARES_EBADQUERY, 0, NULL, 0);
+ return ARES_EBADQUERY;
+ }
+ if (ares__slist_len(channel->servers) == 0) {
+ callback(arg, ARES_ESERVFAIL, 0, NULL, 0);
+ return ARES_ESERVFAIL;
+ }
+
+ /* Check query cache */
+ status = ares_qcache_fetch(channel, &now, qbuf, qlen, &abuf, &alen);
+ if (status != ARES_ENOTFOUND) {
+ /* ARES_SUCCESS means we retrieved the cache, anything else is a critical
+ * failure, all result in termination */
+ callback(arg, (int)status, 0, abuf, (int)alen);
+ ares_free(abuf);
+ return status;
+ }
+
+ /* Allocate space for query and allocated fields. */
+ query = ares_malloc(sizeof(struct query));
+ if (!query) {
+ callback(arg, ARES_ENOMEM, 0, NULL, 0);
+ return ARES_ENOMEM;
+ }
+ memset(query, 0, sizeof(*query));
+
+ query->channel = channel;
+ query->qbuf = ares_malloc(qlen);
+ if (!query->qbuf) {
+ ares_free(query);
+ callback(arg, ARES_ENOMEM, 0, NULL, 0);
+ return ARES_ENOMEM;
+ }
+
+ query->qid = id;
+ query->timeout.tv_sec = 0;
+ query->timeout.tv_usec = 0;
+
+ /* Ignore first 2 bytes, assign our own query id */
+ query->qbuf[0] = (unsigned char)((id >> 8) & 0xFF);
+ query->qbuf[1] = (unsigned char)(id & 0xFF);
+ memcpy(query->qbuf + 2, qbuf + 2, qlen - 2);
+ query->qlen = qlen;
+
+ /* Fill in query arguments. */
+ query->callback = callback;
+ query->arg = arg;
+
+ /* Initialize query status. */
+ query->try_count = 0;
+
+ packetsz = (channel->flags & ARES_FLAG_EDNS) ? channel->ednspsz : PACKETSZ;
+ query->using_tcp = (channel->flags & ARES_FLAG_USEVC) || qlen > packetsz;
+
+ query->error_status = ARES_SUCCESS;
+ query->timeouts = 0;
+
+ /* Initialize our list nodes. */
+ query->node_queries_by_timeout = NULL;
+ query->node_queries_to_conn = NULL;
+
+ /* Chain the query into the list of all queries. */
+ query->node_all_queries =
+ ares__llist_insert_last(channel->all_queries, query);
+ if (query->node_all_queries == NULL) {
+ callback(arg, ARES_ENOMEM, 0, NULL, 0);
+ ares__free_query(query);
+ return ARES_ENOMEM;
+ }
+
+ /* Keep track of queries bucketed by qid, so we can process DNS
+ * responses quickly.
+ */
+ if (!ares__htable_szvp_insert(channel->queries_by_qid, query->qid, query)) {
+ callback(arg, ARES_ENOMEM, 0, NULL, 0);
+ ares__free_query(query);
+ return ARES_ENOMEM;
+ }
+
+ /* Perform the first query action. */
+
+ status = ares__send_query(query, &now);
+ if (status == ARES_SUCCESS && qid) {
+ *qid = id;
+ }
+ return status;
+}
+
+void ares_send(ares_channel_t *channel, const unsigned char *qbuf, int qlen,
+ ares_callback callback, void *arg)
+{
+ if (channel == NULL) {
+ return;
+ }
+
+ ares__channel_lock(channel);
+
+ ares_send_ex(channel, qbuf, (size_t)qlen, callback, arg, NULL);
+
+ ares__channel_unlock(channel);
+}
diff --git a/subprojects/c-ares/src/lib/ares_setup.h b/subprojects/c-ares/src/lib/ares_setup.h
@@ -0,0 +1,246 @@
+/* MIT License
+ *
+ * Copyright (c) 2004 Daniel Stenberg
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice (including the next
+ * paragraph) shall be included in all copies or substantial portions of the
+ * Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ *
+ * SPDX-License-Identifier: MIT
+ */
+#ifndef HEADER_CARES_SETUP_H
+#define HEADER_CARES_SETUP_H
+
+/*
+ * Define WIN32 when build target is Win32 API
+ */
+
+#if (defined(_WIN32) || defined(__WIN32__)) && !defined(WIN32)
+# define WIN32
+#endif
+
+/*
+ * Include configuration script results or hand-crafted
+ * configuration file for platforms which lack config tool.
+ */
+
+#ifdef HAVE_CONFIG_H
+# include "ares_config.h"
+#else
+
+# ifdef WIN32
+# include "config-win32.h"
+# endif
+
+#endif /* HAVE_CONFIG_H */
+
+/* ================================================================ */
+/* Definition of preprocessor macros/symbols which modify compiler */
+/* behaviour or generated code characteristics must be done here, */
+/* as appropriate, before any system header file is included. It is */
+/* also possible to have them defined in the config file included */
+/* before this point. As a result of all this we frown inclusion of */
+/* system header files in our config files, avoid this at any cost. */
+/* ================================================================ */
+
+/*
+ * AIX 4.3 and newer needs _THREAD_SAFE defined to build
+ * proper reentrant code. Others may also need it.
+ */
+
+#ifdef NEED_THREAD_SAFE
+# ifndef _THREAD_SAFE
+# define _THREAD_SAFE
+# endif
+#endif
+
+/*
+ * Tru64 needs _REENTRANT set for a few function prototypes and
+ * things to appear in the system header files. Unixware needs it
+ * to build proper reentrant code. Others may also need it.
+ */
+
+#ifdef NEED_REENTRANT
+# ifndef _REENTRANT
+# define _REENTRANT
+# endif
+#endif
+
+/* ================================================================ */
+/* If you need to include a system header file for your platform, */
+/* please, do it beyond the point further indicated in this file. */
+/* ================================================================ */
+
+/*
+ * c-ares external interface definitions are also used internally,
+ * and might also include required system header files to define them.
+ */
+
+#include <ares_build.h>
+
+/*
+ * Compile time sanity checks must also be done when building the library.
+ */
+
+#include <ares_rules.h>
+
+/* ================================================================= */
+/* No system header file shall be included in this file before this */
+/* point. The only allowed ones are those included from ares_build.h */
+/* ================================================================= */
+
+/*
+ * Include header files for windows builds before redefining anything.
+ * Use this preproessor block only to include or exclude windows.h,
+ * winsock2.h, ws2tcpip.h or winsock.h. Any other windows thing belongs
+ * to any other further and independent block. Under Cygwin things work
+ * just as under linux (e.g. <sys/socket.h>) and the winsock headers should
+ * never be included when __CYGWIN__ is defined. configure script takes
+ * care of this, not defining HAVE_WINDOWS_H, HAVE_WINSOCK_H, HAVE_WINSOCK2_H,
+ * neither HAVE_WS2TCPIP_H when __CYGWIN__ is defined.
+ */
+
+#ifdef HAVE_WINDOWS_H
+# ifndef WIN32_LEAN_AND_MEAN
+# define WIN32_LEAN_AND_MEAN
+# endif
+# include <windows.h>
+# ifdef HAVE_WINSOCK2_H
+# include <winsock2.h>
+# ifdef HAVE_WS2TCPIP_H
+# include <ws2tcpip.h>
+# endif
+# else
+# ifdef HAVE_WINSOCK_H
+# include <winsock.h>
+# endif
+# endif
+#endif
+
+/*
+ * Define USE_WINSOCK to 2 if we have and use WINSOCK2 API, else
+ * define USE_WINSOCK to 1 if we have and use WINSOCK API, else
+ * undefine USE_WINSOCK.
+ */
+
+#ifdef USE_WINSOCK
+# undef USE_WINSOCK
+#endif
+#ifdef HAVE_WINSOCK2_H
+# define USE_WINSOCK 2
+#else
+# ifdef HAVE_WINSOCK_H
+# define USE_WINSOCK 1
+# endif
+#endif
+
+/*
+ * Work-arounds for systems without configure support
+ */
+
+#ifndef HAVE_CONFIG_H
+
+# if !defined(HAVE_SYS_TIME_H) && !defined(_MSC_VER) && !defined(__WATCOMC__)
+# define HAVE_SYS_TIME_H
+# endif
+
+# if !defined(HAVE_UNISTD_H) && !defined(_MSC_VER)
+# define HAVE_UNISTD_H 1
+# endif
+
+# if !defined(HAVE_SYS_UIO_H) && !defined(WIN32) && !defined(MSDOS)
+# define HAVE_SYS_UIO_H
+# endif
+
+#endif /* HAVE_CONFIG_H */
+
+/*
+ * Arg 2 type for gethostname in case it hasn't been defined in config file.
+ */
+
+#ifndef GETHOSTNAME_TYPE_ARG2
+# ifdef USE_WINSOCK
+# define GETHOSTNAME_TYPE_ARG2 int
+# else
+# define GETHOSTNAME_TYPE_ARG2 size_t
+# endif
+#endif
+
+#ifdef __POCC__
+# include <sys/types.h>
+# include <unistd.h>
+# define ESRCH 3
+#endif
+
+/*
+ * Android does have the arpa/nameser.h header which is detected by configure
+ * but it appears to be empty with recent NDK r7b / r7c, so we undefine here.
+ * z/OS does have the arpa/nameser.h header which is detected by configure
+ * but it is not fully implemented and missing identifiers, so udefine here.
+ */
+#if (defined(ANDROID) || defined(__ANDROID__) || defined(__MVS__)) && \
+ defined(HAVE_ARPA_NAMESER_H)
+# undef HAVE_ARPA_NAMESER_H
+#endif
+
+/*
+ * Recent autoconf versions define these symbols in ares_config.h. We don't
+ * want them (since they collide with the libcurl ones when we build
+ * --enable-debug) so we undef them again here.
+ */
+
+#ifdef PACKAGE_STRING
+# undef PACKAGE_STRING
+#endif
+#ifdef PACKAGE_TARNAME
+# undef PACKAGE_TARNAME
+#endif
+#ifdef PACKAGE_VERSION
+# undef PACKAGE_VERSION
+#endif
+#ifdef PACKAGE_BUGREPORT
+# undef PACKAGE_BUGREPORT
+#endif
+#ifdef PACKAGE_NAME
+# undef PACKAGE_NAME
+#endif
+#ifdef VERSION
+# undef VERSION
+#endif
+#ifdef PACKAGE
+# undef PACKAGE
+#endif
+
+/* IPv6 compatibility */
+#if !defined(HAVE_AF_INET6)
+# if defined(HAVE_PF_INET6)
+# define AF_INET6 PF_INET6
+# else
+# define AF_INET6 AF_MAX + 1
+# endif
+#endif
+
+/*
+ * Include macros and defines that should only be processed once.
+ */
+
+#ifndef __SETUP_ONCE_H
+# include "setup_once.h"
+#endif
+
+#endif /* HEADER_CARES_SETUP_H */
diff --git a/subprojects/c-ares/src/lib/ares_str.c b/subprojects/c-ares/src/lib/ares_str.c
@@ -0,0 +1,153 @@
+/* MIT License
+ *
+ * Copyright (c) 1998 Massachusetts Institute of Technology
+ * Copyright (c) The c-ares project and its contributors
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice (including the next
+ * paragraph) shall be included in all copies or substantial portions of the
+ * Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ *
+ * SPDX-License-Identifier: MIT
+ */
+
+#include "ares_setup.h"
+#include "ares_str.h"
+#include "ares.h"
+#include "ares_private.h"
+
+#ifdef HAVE_STDINT_H
+# include <stdint.h>
+#endif
+
+size_t ares_strlen(const char *str)
+{
+ if (str == NULL) {
+ return 0;
+ }
+
+ return strlen(str);
+}
+
+char *ares_strdup(const char *s1)
+{
+ size_t len;
+ char *out;
+
+ if (s1 == NULL) {
+ return NULL;
+ }
+
+ len = ares_strlen(s1);
+
+ /* Don't see how this is possible */
+ if (len == SIZE_MAX) {
+ return NULL;
+ }
+
+ out = ares_malloc(len + 1);
+ if (out == NULL) {
+ return NULL;
+ }
+
+ if (len) {
+ memcpy(out, s1, len);
+ }
+
+ out[len] = 0;
+ return out;
+}
+
+size_t ares_strcpy(char *dest, const char *src, size_t dest_size)
+{
+ size_t len = 0;
+
+ if (dest == NULL || dest_size == 0) {
+ return 0;
+ }
+
+ len = ares_strlen(src);
+
+ if (len >= dest_size) {
+ len = dest_size - 1;
+ }
+
+ if (len) {
+ memcpy(dest, src, len);
+ }
+
+ dest[len] = 0;
+ return len;
+}
+
+ares_bool_t ares_str_isnum(const char *str)
+{
+ size_t i;
+
+ if (str == NULL || *str == 0) {
+ return ARES_FALSE;
+ }
+
+ for (i = 0; str[i] != 0; i++) {
+ if (str[i] < '0' || str[i] > '9') {
+ return ARES_FALSE;
+ }
+ }
+ return ARES_TRUE;
+}
+
+/* tolower() is locale-specific. Use a lookup table fast conversion that only
+ * operates on ASCII */
+static const unsigned char ares__tolower_lookup[] = {
+ 0x00, 0x01, 0x02, 0x03, 0x04, 0x05, 0x06, 0x07, 0x08, 0x09, 0x0A, 0x0B, 0x0C,
+ 0x0D, 0x0E, 0x0F, 0x10, 0x11, 0x12, 0x13, 0x14, 0x15, 0x16, 0x17, 0x18, 0x19,
+ 0x1A, 0x1B, 0x1C, 0x1D, 0x1E, 0x1F, 0x20, 0x21, 0x22, 0x23, 0x24, 0x25, 0x26,
+ 0x27, 0x28, 0x29, 0x2A, 0x2B, 0x2C, 0x2D, 0x2E, 0x2F, 0x30, 0x31, 0x32, 0x33,
+ 0x34, 0x35, 0x36, 0x37, 0x38, 0x39, 0x3A, 0x3B, 0x3C, 0x3D, 0x3E, 0x3F, 0x40,
+ 0x61, 0x62, 0x63, 0x64, 0x65, 0x66, 0x67, 0x68, 0x69, 0x6A, 0x6B, 0x6C, 0x6D,
+ 0x6E, 0x6F, 0x70, 0x71, 0x72, 0x73, 0x74, 0x75, 0x76, 0x77, 0x78, 0x79, 0x7A,
+ 0x5B, 0x5C, 0x5D, 0x5E, 0x5F, 0x60, 0x61, 0x62, 0x63, 0x64, 0x65, 0x66, 0x67,
+ 0x68, 0x69, 0x6A, 0x6B, 0x6C, 0x6D, 0x6E, 0x6F, 0x70, 0x71, 0x72, 0x73, 0x74,
+ 0x75, 0x76, 0x77, 0x78, 0x79, 0x7A, 0x7B, 0x7C, 0x7D, 0x7E, 0x7F, 0x80, 0x81,
+ 0x82, 0x83, 0x84, 0x85, 0x86, 0x87, 0x88, 0x89, 0x8A, 0x8B, 0x8C, 0x8D, 0x8E,
+ 0x8F, 0x90, 0x91, 0x92, 0x93, 0x94, 0x95, 0x96, 0x97, 0x98, 0x99, 0x9A, 0x9B,
+ 0x9C, 0x9D, 0x9E, 0x9F, 0xA0, 0xA1, 0xA2, 0xA3, 0xA4, 0xA5, 0xA6, 0xA7, 0xA8,
+ 0xA9, 0xAA, 0xAB, 0xAC, 0xAD, 0xAE, 0xAF, 0xB0, 0xB1, 0xB2, 0xB3, 0xB4, 0xB5,
+ 0xB6, 0xB7, 0xB8, 0xB9, 0xBA, 0xBB, 0xBC, 0xBD, 0xBE, 0xBF, 0xC0, 0xC1, 0xC2,
+ 0xC3, 0xC4, 0xC5, 0xC6, 0xC7, 0xC8, 0xC9, 0xCA, 0xCB, 0xCC, 0xCD, 0xCE, 0xCF,
+ 0xD0, 0xD1, 0xD2, 0xD3, 0xD4, 0xD5, 0xD6, 0xD7, 0xD8, 0xD9, 0xDA, 0xDB, 0xDC,
+ 0xDD, 0xDE, 0xDF, 0xE0, 0xE1, 0xE2, 0xE3, 0xE4, 0xE5, 0xE6, 0xE7, 0xE8, 0xE9,
+ 0xEA, 0xEB, 0xEC, 0xED, 0xEE, 0xEF, 0xF0, 0xF1, 0xF2, 0xF3, 0xF4, 0xF5, 0xF6,
+ 0xF7, 0xF8, 0xF9, 0xFA, 0xFB, 0xFC, 0xFD, 0xFE, 0xFF
+};
+
+unsigned char ares__tolower(unsigned char c)
+{
+ return ares__tolower_lookup[c];
+}
+
+ares_bool_t ares__memeq_ci(const unsigned char *ptr, const unsigned char *val,
+ size_t len)
+{
+ size_t i;
+ for (i = 0; i < len; i++) {
+ if (ares__tolower_lookup[ptr[i]] != ares__tolower_lookup[val[i]]) {
+ return ARES_FALSE;
+ }
+ }
+ return ARES_TRUE;
+}
diff --git a/subprojects/c-ares/src/lib/ares_str.h b/subprojects/c-ares/src/lib/ares_str.h
@@ -0,0 +1,55 @@
+/* MIT License
+ *
+ * Copyright (c) 1998 Massachusetts Institute of Technology
+ * Copyright (c) The c-ares project and its contributors
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice (including the next
+ * paragraph) shall be included in all copies or substantial portions of the
+ * Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ *
+ * SPDX-License-Identifier: MIT
+ */
+#ifndef HEADER_CARES_STRDUP_H
+#define HEADER_CARES_STRDUP_H
+
+#include "ares_setup.h"
+#include "ares.h"
+
+char *ares_strdup(const char *s1);
+
+size_t ares_strlen(const char *str);
+
+/*! Copy string from source to destination with destination buffer size
+ * provided. The destination is guaranteed to be null terminated, if the
+ * provided buffer isn't large enough, only those bytes from the source that
+ * will fit will be copied.
+ *
+ * \param[out] dest Destination buffer
+ * \param[in] src Source to copy
+ * \param[in] dest_size Size of destination buffer
+ * \return String length. Will be at most dest_size-1
+ */
+size_t ares_strcpy(char *dest, const char *src, size_t dest_size);
+
+ares_bool_t ares_str_isnum(const char *str);
+
+unsigned char ares__tolower(unsigned char c);
+ares_bool_t ares__memeq_ci(const unsigned char *ptr, const unsigned char *val,
+ size_t len);
+
+#endif /* HEADER_CARES_STRDUP_H */
diff --git a/subprojects/c-ares/src/lib/ares_strcasecmp.c b/subprojects/c-ares/src/lib/ares_strcasecmp.c
@@ -0,0 +1,79 @@
+/* MIT License
+ *
+ * Copyright (c) 1998 Massachusetts Institute of Technology
+ * Copyright (c) The c-ares project and its contributors
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice (including the next
+ * paragraph) shall be included in all copies or substantial portions of the
+ * Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ *
+ * SPDX-License-Identifier: MIT
+ */
+
+#include "ares_setup.h"
+#include "ares_strcasecmp.h"
+
+#ifndef HAVE_STRCASECMP
+int ares_strcasecmp(const char *a, const char *b)
+{
+# if defined(HAVE_STRCMPI)
+ return strcmpi(a, b);
+# elif defined(HAVE_STRICMP)
+ return stricmp(a, b);
+# else
+ size_t i;
+
+ for (i = 0; i < (size_t)-1; i++) {
+ int c1 = ISUPPER(a[i]) ? tolower(a[i]) : a[i];
+ int c2 = ISUPPER(b[i]) ? tolower(b[i]) : b[i];
+ if (c1 != c2) {
+ return c1 - c2;
+ }
+ if (!c1) {
+ break;
+ }
+ }
+ return 0;
+# endif
+}
+#endif
+
+#ifndef HAVE_STRNCASECMP
+int ares_strncasecmp(const char *a, const char *b, size_t n)
+{
+# if defined(HAVE_STRNCMPI)
+ return strncmpi(a, b, n);
+# elif defined(HAVE_STRNICMP)
+ return strnicmp(a, b, n);
+# else
+ size_t i;
+
+ for (i = 0; i < n; i++) {
+ int c1 = ISUPPER(a[i]) ? tolower(a[i]) : a[i];
+ int c2 = ISUPPER(b[i]) ? tolower(b[i]) : b[i];
+ if (c1 != c2) {
+ return c1 - c2;
+ }
+ if (!c1) {
+ break;
+ }
+ }
+ return 0;
+# endif
+}
+#endif
diff --git a/subprojects/c-ares/src/lib/ares_strcasecmp.h b/subprojects/c-ares/src/lib/ares_strcasecmp.h
@@ -0,0 +1,40 @@
+/* MIT License
+ *
+ * Copyright (c) 1998 Massachusetts Institute of Technology
+ * Copyright (c) The c-ares project and its contributors
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice (including the next
+ * paragraph) shall be included in all copies or substantial portions of the
+ * Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ *
+ * SPDX-License-Identifier: MIT
+ */
+#ifndef HEADER_CARES_STRCASECMP_H
+#define HEADER_CARES_STRCASECMP_H
+
+#include "ares_setup.h"
+
+#ifndef HAVE_STRCASECMP
+extern int ares_strcasecmp(const char *a, const char *b);
+#endif
+
+#ifndef HAVE_STRNCASECMP
+extern int ares_strncasecmp(const char *a, const char *b, size_t n);
+#endif
+
+#endif /* HEADER_CARES_STRCASECMP_H */
diff --git a/subprojects/c-ares/src/lib/ares_strerror.c b/subprojects/c-ares/src/lib/ares_strerror.c
@@ -0,0 +1,91 @@
+/* MIT License
+ *
+ * Copyright (c) 1998 Massachusetts Institute of Technology
+ * Copyright (c) The c-ares project and its contributors
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice (including the next
+ * paragraph) shall be included in all copies or substantial portions of the
+ * Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ *
+ * SPDX-License-Identifier: MIT
+ */
+
+#include "ares_setup.h"
+#include <assert.h>
+#include "ares.h"
+
+const char *ares_strerror(int code)
+{
+ ares_status_t status = (ares_status_t)code;
+ switch (status) {
+ case ARES_SUCCESS:
+ return "Successful completion";
+ case ARES_ENODATA:
+ return "DNS server returned answer with no data";
+ case ARES_EFORMERR:
+ return "DNS server claims query was misformatted";
+ case ARES_ESERVFAIL:
+ return "DNS server returned general failure";
+ case ARES_ENOTFOUND:
+ return "Domain name not found";
+ case ARES_ENOTIMP:
+ return "DNS server does not implement requested operation";
+ case ARES_EREFUSED:
+ return "DNS server refused query";
+ case ARES_EBADQUERY:
+ return "Misformatted DNS query";
+ case ARES_EBADNAME:
+ return "Misformatted domain name";
+ case ARES_EBADFAMILY:
+ return "Unsupported address family";
+ case ARES_EBADRESP:
+ return "Misformatted DNS reply";
+ case ARES_ECONNREFUSED:
+ return "Could not contact DNS servers";
+ case ARES_ETIMEOUT:
+ return "Timeout while contacting DNS servers";
+ case ARES_EOF:
+ return "End of file";
+ case ARES_EFILE:
+ return "Error reading file";
+ case ARES_ENOMEM:
+ return "Out of memory";
+ case ARES_EDESTRUCTION:
+ return "Channel is being destroyed";
+ case ARES_EBADSTR:
+ return "Misformatted string";
+ case ARES_EBADFLAGS:
+ return "Illegal flags specified";
+ case ARES_ENONAME:
+ return "Given hostname is not numeric";
+ case ARES_EBADHINTS:
+ return "Illegal hints flags specified";
+ case ARES_ENOTINITIALIZED:
+ return "c-ares library initialization not yet performed";
+ case ARES_ELOADIPHLPAPI:
+ return "Error loading iphlpapi.dll";
+ case ARES_EADDRGETNETWORKPARAMS:
+ return "Could not find GetNetworkParams function";
+ case ARES_ECANCELLED:
+ return "DNS query cancelled";
+ case ARES_ESERVICE:
+ return "Invalid service name or number";
+ }
+
+ return "unknown";
+}
diff --git a/subprojects/c-ares/src/lib/ares_strsplit.c b/subprojects/c-ares/src/lib/ares_strsplit.c
@@ -0,0 +1,140 @@
+/* MIT License
+ *
+ * Copyright (c) 2018 John Schember
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice (including the next
+ * paragraph) shall be included in all copies or substantial portions of the
+ * Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ *
+ * SPDX-License-Identifier: MIT
+ */
+
+#if defined(__MVS__)
+# include <strings.h>
+#endif
+
+#include "ares_setup.h"
+#include "ares.h"
+#include "ares_private.h"
+
+void ares__strsplit_free(char **elms, size_t num_elm)
+{
+ size_t i;
+
+ if (elms == NULL) {
+ return;
+ }
+
+ for (i = 0; i < num_elm; i++) {
+ ares_free(elms[i]);
+ }
+ ares_free(elms);
+}
+
+char **ares__strsplit_duplicate(char **elms, size_t num_elm)
+{
+ size_t i;
+ char **out;
+
+ if (elms == NULL || num_elm == 0) {
+ return NULL;
+ }
+
+ out = ares_malloc_zero(sizeof(*elms) * num_elm);
+ if (out == NULL) {
+ return NULL;
+ }
+
+ for (i = 0; i < num_elm; i++) {
+ out[i] = ares_strdup(elms[i]);
+ if (out[i] == NULL) {
+ ares__strsplit_free(out, num_elm);
+ return NULL;
+ }
+ }
+
+ return out;
+}
+
+char **ares__strsplit(const char *in, const char *delms, size_t *num_elm)
+{
+ ares_status_t status;
+ ares__buf_t *buf = NULL;
+ ares__llist_t *llist = NULL;
+ ares__llist_node_t *node;
+ char **out = NULL;
+ size_t cnt = 0;
+ size_t idx = 0;
+
+ if (in == NULL || delms == NULL || num_elm == NULL) {
+ return NULL;
+ }
+
+ *num_elm = 0;
+
+ buf = ares__buf_create_const((const unsigned char *)in, ares_strlen(in));
+ if (buf == NULL) {
+ return NULL;
+ }
+
+ status = ares__buf_split(
+ buf, (const unsigned char *)delms, ares_strlen(delms),
+ ARES_BUF_SPLIT_NO_DUPLICATES | ARES_BUF_SPLIT_CASE_INSENSITIVE, &llist);
+ if (status != ARES_SUCCESS) {
+ goto done;
+ }
+
+ cnt = ares__llist_len(llist);
+ if (cnt == 0) {
+ status = ARES_EFORMERR;
+ goto done;
+ }
+
+
+ out = ares_malloc_zero(cnt * sizeof(*out));
+ if (out == NULL) {
+ status = ARES_ENOMEM;
+ goto done;
+ }
+
+ for (node = ares__llist_node_first(llist); node != NULL;
+ node = ares__llist_node_next(node)) {
+ ares__buf_t *val = ares__llist_node_val(node);
+ char *temp = NULL;
+
+ status = ares__buf_fetch_str_dup(val, ares__buf_len(val), &temp);
+ if (status != ARES_SUCCESS) {
+ goto done;
+ }
+
+ out[idx++] = temp;
+ }
+
+ *num_elm = cnt;
+ status = ARES_SUCCESS;
+
+done:
+ ares__llist_destroy(llist);
+ ares__buf_destroy(buf);
+ if (status != ARES_SUCCESS) {
+ ares__strsplit_free(out, cnt);
+ out = NULL;
+ }
+
+ return out;
+}
diff --git a/subprojects/c-ares/src/lib/ares_strsplit.h b/subprojects/c-ares/src/lib/ares_strsplit.h
@@ -0,0 +1,53 @@
+/* MIT License
+ *
+ * Copyright (c) 2018 John Schember
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice (including the next
+ * paragraph) shall be included in all copies or substantial portions of the
+ * Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ *
+ * SPDX-License-Identifier: MIT
+ */
+#ifndef HEADER_CARES_STRSPLIT_H
+#define HEADER_CARES_STRSPLIT_H
+
+#include "ares_setup.h"
+
+/* Split a string on delms skipping empty or duplicate elements.
+ *
+ * param in String to split.
+ * param delms String of characters to treat as a delimiter.
+ * Each character in the string is a delimiter so
+ * there can be multiple delimiters to split on.
+ * E.g. ", " will split on all comma's and spaces.
+ * Duplicate (case-insensitive) entries are removed.
+ * param num_elm Return parameter of the number of elements
+ * in the result array.
+ *
+ * returns an allocated array of allocated string elements.
+ *
+ */
+char **ares__strsplit(const char *in, const char *delms, size_t *num_elm);
+
+/* Frees the result returned from ares__strsplit(). */
+void ares__strsplit_free(char **elms, size_t num_elm);
+
+/* Duplicate the array */
+char **ares__strsplit_duplicate(char **elms, size_t num_elm);
+
+#endif /* HEADER_CARES_STRSPLIT_H */
diff --git a/subprojects/c-ares/src/lib/ares_sysconfig.c b/subprojects/c-ares/src/lib/ares_sysconfig.c
@@ -0,0 +1,1106 @@
+/* MIT License
+ *
+ * Copyright (c) 1998 Massachusetts Institute of Technology
+ * Copyright (c) 2007 Daniel Stenberg
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice (including the next
+ * paragraph) shall be included in all copies or substantial portions of the
+ * Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ *
+ * SPDX-License-Identifier: MIT
+ */
+
+#include "ares_setup.h"
+
+#ifdef HAVE_SYS_PARAM_H
+# include <sys/param.h>
+#endif
+
+#ifdef HAVE_NETINET_IN_H
+# include <netinet/in.h>
+#endif
+
+#ifdef HAVE_NETDB_H
+# include <netdb.h>
+#endif
+
+#ifdef HAVE_ARPA_INET_H
+# include <arpa/inet.h>
+#endif
+
+#include "ares_nameser.h"
+
+#if defined(ANDROID) || defined(__ANDROID__)
+# include <sys/system_properties.h>
+# include "ares_android.h"
+/* From the Bionic sources */
+# define DNS_PROP_NAME_PREFIX "net.dns"
+# define MAX_DNS_PROPERTIES 8
+#endif
+
+#if defined(CARES_USE_LIBRESOLV)
+# include <resolv.h>
+#endif
+
+#if defined(USE_WINSOCK)
+# if defined(HAVE_IPHLPAPI_H)
+# include <iphlpapi.h>
+# endif
+# if defined(HAVE_NETIOAPI_H)
+# include <netioapi.h>
+# endif
+#endif
+
+#include "ares.h"
+#include "ares_inet_net_pton.h"
+#include "ares_platform.h"
+#include "ares_private.h"
+
+#ifdef WATT32
+# undef WIN32 /* Redefined in MingW/MSVC headers */
+#endif
+
+
+#ifdef WIN32
+/*
+ * get_REG_SZ()
+ *
+ * Given a 'hKey' handle to an open registry key and a 'leafKeyName' pointer
+ * to the name of the registry leaf key to be queried, fetch it's string
+ * value and return a pointer in *outptr to a newly allocated memory area
+ * holding it as a null-terminated string.
+ *
+ * Returns 0 and nullifies *outptr upon inability to return a string value.
+ *
+ * Returns 1 and sets *outptr when returning a dynamically allocated string.
+ *
+ * Supported on Windows NT 3.5 and newer.
+ */
+static ares_bool_t get_REG_SZ(HKEY hKey, const char *leafKeyName, char **outptr)
+{
+ DWORD size = 0;
+ int res;
+
+ *outptr = NULL;
+
+ /* Find out size of string stored in registry */
+ res = RegQueryValueExA(hKey, leafKeyName, 0, NULL, NULL, &size);
+ if ((res != ERROR_SUCCESS && res != ERROR_MORE_DATA) || !size) {
+ return ARES_FALSE;
+ }
+
+ /* Allocate buffer of indicated size plus one given that string
+ might have been stored without null termination */
+ *outptr = ares_malloc(size + 1);
+ if (!*outptr) {
+ return ARES_FALSE;
+ }
+
+ /* Get the value for real */
+ res = RegQueryValueExA(hKey, leafKeyName, 0, NULL, (unsigned char *)*outptr,
+ &size);
+ if ((res != ERROR_SUCCESS) || (size == 1)) {
+ ares_free(*outptr);
+ *outptr = NULL;
+ return ARES_FALSE;
+ }
+
+ /* Null terminate buffer always */
+ *(*outptr + size) = '\0';
+
+ return ARES_TRUE;
+}
+
+static void commanjoin(char **dst, const char * const src, const size_t len)
+{
+ char *newbuf;
+ size_t newsize;
+
+ /* 1 for terminating 0 and 2 for , and terminating 0 */
+ newsize = len + (*dst ? (ares_strlen(*dst) + 2) : 1);
+ newbuf = ares_realloc(*dst, newsize);
+ if (!newbuf) {
+ return;
+ }
+ if (*dst == NULL) {
+ *newbuf = '\0';
+ }
+ *dst = newbuf;
+ if (ares_strlen(*dst) != 0) {
+ strcat(*dst, ",");
+ }
+ strncat(*dst, src, len);
+}
+
+/*
+ * commajoin()
+ *
+ * RTF code.
+ */
+static void commajoin(char **dst, const char *src)
+{
+ commanjoin(dst, src, ares_strlen(src));
+}
+
+/* A structure to hold the string form of IPv4 and IPv6 addresses so we can
+ * sort them by a metric.
+ */
+typedef struct {
+ /* The metric we sort them by. */
+ ULONG metric;
+
+ /* Original index of the item, used as a secondary sort parameter to make
+ * qsort() stable if the metrics are equal */
+ size_t orig_idx;
+
+ /* Room enough for the string form of any IPv4 or IPv6 address that
+ * ares_inet_ntop() will create. Based on the existing c-ares practice.
+ */
+ char text[INET6_ADDRSTRLEN + 8 + 64]; /* [%s]:NNNNN%iface */
+} Address;
+
+/* Sort Address values \a left and \a right by metric, returning the usual
+ * indicators for qsort().
+ */
+static int compareAddresses(const void *arg1, const void *arg2)
+{
+ const Address * const left = arg1;
+ const Address * const right = arg2;
+ /* Lower metric the more preferred */
+ if (left->metric < right->metric) {
+ return -1;
+ }
+ if (left->metric > right->metric) {
+ return 1;
+ }
+ /* If metrics are equal, lower original index more preferred */
+ if (left->orig_idx < right->orig_idx) {
+ return -1;
+ }
+ if (left->orig_idx > right->orig_idx) {
+ return 1;
+ }
+ return 0;
+}
+
+/* There can be multiple routes to "the Internet". And there can be different
+ * DNS servers associated with each of the interfaces that offer those routes.
+ * We have to assume that any DNS server can serve any request. But, some DNS
+ * servers may only respond if requested over their associated interface. But
+ * we also want to use "the preferred route to the Internet" whenever possible
+ * (and not use DNS servers on a non-preferred route even by forcing request
+ * to go out on the associated non-preferred interface). i.e. We want to use
+ * the DNS servers associated with the same interface that we would use to
+ * make a general request to anything else.
+ *
+ * But, Windows won't sort the DNS servers by the metrics associated with the
+ * routes and interfaces _even_ though it obviously sends IP packets based on
+ * those same routes and metrics. So, we must do it ourselves.
+ *
+ * So, we sort the DNS servers by the same metric values used to determine how
+ * an outgoing IP packet will go, thus effectively using the DNS servers
+ * associated with the interface that the DNS requests themselves will
+ * travel. This gives us optimal routing and avoids issues where DNS servers
+ * won't respond to requests that don't arrive via some specific subnetwork
+ * (and thus some specific interface).
+ *
+ * This function computes the metric we use to sort. On the interface
+ * identified by \a luid, it determines the best route to \a dest and combines
+ * that route's metric with \a interfaceMetric to compute a metric for the
+ * destination address on that interface. This metric can be used as a weight
+ * to sort the DNS server addresses associated with each interface (lower is
+ * better).
+ *
+ * Note that by restricting the route search to the specific interface with
+ * which the DNS servers are associated, this function asks the question "What
+ * is the metric for sending IP packets to this DNS server?" which allows us
+ * to sort the DNS servers correctly.
+ */
+static ULONG getBestRouteMetric(IF_LUID * const luid, /* Can't be const :( */
+ const SOCKADDR_INET * const dest,
+ const ULONG interfaceMetric)
+{
+ /* On this interface, get the best route to that destination. */
+# if defined(__WATCOMC__)
+ /* OpenWatcom's builtin Windows SDK does not have a definition for
+ * MIB_IPFORWARD_ROW2, and also does not allow the usage of SOCKADDR_INET
+ * as a variable. Let's work around this by returning the worst possible
+ * metric, but only when using the OpenWatcom compiler.
+ * It may be worth investigating using a different version of the Windows
+ * SDK with OpenWatcom in the future, though this may be fixed in OpenWatcom
+ * 2.0.
+ */
+ return (ULONG)-1;
+# else
+ MIB_IPFORWARD_ROW2 row;
+ SOCKADDR_INET ignored;
+ if (GetBestRoute2(/* The interface to use. The index is ignored since we are
+ * passing a LUID.
+ */
+ luid, 0,
+ /* No specific source address. */
+ NULL,
+ /* Our destination address. */
+ dest,
+ /* No options. */
+ 0,
+ /* The route row. */
+ &row,
+ /* The best source address, which we don't need. */
+ &ignored) != NO_ERROR
+ /* If the metric is "unused" (-1) or too large for us to add the two
+ * metrics, use the worst possible, thus sorting this last.
+ */
+ || row.Metric == (ULONG)-1 ||
+ row.Metric > ((ULONG)-1) - interfaceMetric) {
+ /* Return the worst possible metric. */
+ return (ULONG)-1;
+ }
+
+ /* Return the metric value from that row, plus the interface metric.
+ *
+ * See
+ * http://msdn.microsoft.com/en-us/library/windows/desktop/aa814494(v=vs.85).aspx
+ * which describes the combination as a "sum".
+ */
+ return row.Metric + interfaceMetric;
+# endif /* __WATCOMC__ */
+}
+
+/*
+ * get_DNS_Windows()
+ *
+ * Locates DNS info using GetAdaptersAddresses() function from the Internet
+ * Protocol Helper (IP Helper) API. When located, this returns a pointer
+ * in *outptr to a newly allocated memory area holding a null-terminated
+ * string with a space or comma separated list of DNS IP addresses.
+ *
+ * Returns 0 and nullifies *outptr upon inability to return DNSes string.
+ *
+ * Returns 1 and sets *outptr when returning a dynamically allocated string.
+ *
+ * Implementation supports Windows XP and newer.
+ */
+# define IPAA_INITIAL_BUF_SZ 15 * 1024
+# define IPAA_MAX_TRIES 3
+
+static ares_bool_t get_DNS_Windows(char **outptr)
+{
+ IP_ADAPTER_DNS_SERVER_ADDRESS *ipaDNSAddr;
+ IP_ADAPTER_ADDRESSES *ipaa;
+ IP_ADAPTER_ADDRESSES *newipaa;
+ IP_ADAPTER_ADDRESSES *ipaaEntry;
+ ULONG ReqBufsz = IPAA_INITIAL_BUF_SZ;
+ ULONG Bufsz = IPAA_INITIAL_BUF_SZ;
+ ULONG AddrFlags = 0;
+ int trying = IPAA_MAX_TRIES;
+ ULONG res;
+
+ /* The capacity of addresses, in elements. */
+ size_t addressesSize;
+ /* The number of elements in addresses. */
+ size_t addressesIndex = 0;
+ /* The addresses we will sort. */
+ Address *addresses;
+
+ union {
+ struct sockaddr *sa;
+ struct sockaddr_in *sa4;
+ struct sockaddr_in6 *sa6;
+ } namesrvr;
+
+ *outptr = NULL;
+
+ ipaa = ares_malloc(Bufsz);
+ if (!ipaa) {
+ return ARES_FALSE;
+ }
+
+ /* Start with enough room for a few DNS server addresses and we'll grow it
+ * as we encounter more.
+ */
+ addressesSize = 4;
+ addresses = (Address *)ares_malloc(sizeof(Address) * addressesSize);
+ if (addresses == NULL) {
+ /* We need room for at least some addresses to function. */
+ ares_free(ipaa);
+ return ARES_FALSE;
+ }
+
+ /* Usually this call succeeds with initial buffer size */
+ res = GetAdaptersAddresses(AF_UNSPEC, AddrFlags, NULL, ipaa, &ReqBufsz);
+ if ((res != ERROR_BUFFER_OVERFLOW) && (res != ERROR_SUCCESS)) {
+ goto done;
+ }
+
+ while ((res == ERROR_BUFFER_OVERFLOW) && (--trying)) {
+ if (Bufsz < ReqBufsz) {
+ newipaa = ares_realloc(ipaa, ReqBufsz);
+ if (!newipaa) {
+ goto done;
+ }
+ Bufsz = ReqBufsz;
+ ipaa = newipaa;
+ }
+ res = GetAdaptersAddresses(AF_UNSPEC, AddrFlags, NULL, ipaa, &ReqBufsz);
+ if (res == ERROR_SUCCESS) {
+ break;
+ }
+ }
+ if (res != ERROR_SUCCESS) {
+ goto done;
+ }
+
+ for (ipaaEntry = ipaa; ipaaEntry; ipaaEntry = ipaaEntry->Next) {
+ if (ipaaEntry->OperStatus != IfOperStatusUp) {
+ continue;
+ }
+
+ /* For each interface, find any associated DNS servers as IPv4 or IPv6
+ * addresses. For each found address, find the best route to that DNS
+ * server address _on_ _that_ _interface_ (at this moment in time) and
+ * compute the resulting total metric, just as Windows routing will do.
+ * Then, sort all the addresses found by the metric.
+ */
+ for (ipaDNSAddr = ipaaEntry->FirstDnsServerAddress; ipaDNSAddr;
+ ipaDNSAddr = ipaDNSAddr->Next) {
+ char ipaddr[INET6_ADDRSTRLEN] = "";
+ namesrvr.sa = ipaDNSAddr->Address.lpSockaddr;
+
+ if (namesrvr.sa->sa_family == AF_INET) {
+ if ((namesrvr.sa4->sin_addr.S_un.S_addr == INADDR_ANY) ||
+ (namesrvr.sa4->sin_addr.S_un.S_addr == INADDR_NONE)) {
+ continue;
+ }
+
+ /* Allocate room for another address, if necessary, else skip. */
+ if (addressesIndex == addressesSize) {
+ const size_t newSize = addressesSize + 4;
+ Address * const newMem =
+ (Address *)ares_realloc(addresses, sizeof(Address) * newSize);
+ if (newMem == NULL) {
+ continue;
+ }
+ addresses = newMem;
+ addressesSize = newSize;
+ }
+
+ addresses[addressesIndex].metric = getBestRouteMetric(
+ &ipaaEntry->Luid, (SOCKADDR_INET *)((void *)(namesrvr.sa)),
+ ipaaEntry->Ipv4Metric);
+
+ /* Record insertion index to make qsort stable */
+ addresses[addressesIndex].orig_idx = addressesIndex;
+
+ if (!ares_inet_ntop(AF_INET, &namesrvr.sa4->sin_addr, ipaddr,
+ sizeof(ipaddr))) {
+ continue;
+ }
+ snprintf(addresses[addressesIndex].text,
+ sizeof(addresses[addressesIndex].text), "[%s]:%u", ipaddr,
+ ntohs(namesrvr.sa4->sin_port));
+ ++addressesIndex;
+ } else if (namesrvr.sa->sa_family == AF_INET6) {
+ unsigned int ll_scope = 0;
+ struct ares_addr addr;
+
+ if (memcmp(&namesrvr.sa6->sin6_addr, &ares_in6addr_any,
+ sizeof(namesrvr.sa6->sin6_addr)) == 0) {
+ continue;
+ }
+
+ /* Allocate room for another address, if necessary, else skip. */
+ if (addressesIndex == addressesSize) {
+ const size_t newSize = addressesSize + 4;
+ Address * const newMem =
+ (Address *)ares_realloc(addresses, sizeof(Address) * newSize);
+ if (newMem == NULL) {
+ continue;
+ }
+ addresses = newMem;
+ addressesSize = newSize;
+ }
+
+ /* See if its link-local */
+ memset(&addr, 0, sizeof(addr));
+ addr.family = AF_INET6;
+ memcpy(&addr.addr.addr6, &namesrvr.sa6->sin6_addr, 16);
+ if (ares__addr_is_linklocal(&addr)) {
+ ll_scope = ipaaEntry->Ipv6IfIndex;
+ }
+
+ addresses[addressesIndex].metric = getBestRouteMetric(
+ &ipaaEntry->Luid, (SOCKADDR_INET *)((void *)(namesrvr.sa)),
+ ipaaEntry->Ipv6Metric);
+
+ /* Record insertion index to make qsort stable */
+ addresses[addressesIndex].orig_idx = addressesIndex;
+
+ if (!ares_inet_ntop(AF_INET6, &namesrvr.sa6->sin6_addr, ipaddr,
+ sizeof(ipaddr))) {
+ continue;
+ }
+
+ if (ll_scope) {
+ snprintf(addresses[addressesIndex].text,
+ sizeof(addresses[addressesIndex].text), "[%s]:%u%%%u",
+ ipaddr, ntohs(namesrvr.sa6->sin6_port), ll_scope);
+ } else {
+ snprintf(addresses[addressesIndex].text,
+ sizeof(addresses[addressesIndex].text), "[%s]:%u", ipaddr,
+ ntohs(namesrvr.sa6->sin6_port));
+ }
+ ++addressesIndex;
+ } else {
+ /* Skip non-IPv4/IPv6 addresses completely. */
+ continue;
+ }
+ }
+ }
+
+ /* Sort all of the textual addresses by their metric (and original index if
+ * metrics are equal). */
+ qsort(addresses, addressesIndex, sizeof(*addresses), compareAddresses);
+
+ /* Join them all into a single string, removing duplicates. */
+ {
+ size_t i;
+ for (i = 0; i < addressesIndex; ++i) {
+ size_t j;
+ /* Look for this address text appearing previously in the results. */
+ for (j = 0; j < i; ++j) {
+ if (strcmp(addresses[j].text, addresses[i].text) == 0) {
+ break;
+ }
+ }
+ /* Iff we didn't emit this address already, emit it now. */
+ if (j == i) {
+ /* Add that to outptr (if we can). */
+ commajoin(outptr, addresses[i].text);
+ }
+ }
+ }
+
+done:
+ ares_free(addresses);
+
+ if (ipaa) {
+ ares_free(ipaa);
+ }
+
+ if (!*outptr) {
+ return ARES_FALSE;
+ }
+
+ return ARES_TRUE;
+}
+
+/*
+ * get_SuffixList_Windows()
+ *
+ * Reads the "DNS Suffix Search List" from registry and writes the list items
+ * whitespace separated to outptr. If the Search List is empty, the
+ * "Primary Dns Suffix" is written to outptr.
+ *
+ * Returns 0 and nullifies *outptr upon inability to return the suffix list.
+ *
+ * Returns 1 and sets *outptr when returning a dynamically allocated string.
+ *
+ * Implementation supports Windows Server 2003 and newer
+ */
+static ares_bool_t get_SuffixList_Windows(char **outptr)
+{
+ HKEY hKey;
+ HKEY hKeyEnum;
+ char keyName[256];
+ DWORD keyNameBuffSize;
+ DWORD keyIdx = 0;
+ char *p = NULL;
+
+ *outptr = NULL;
+
+ if (ares__getplatform() != WIN_NT) {
+ return ARES_FALSE;
+ }
+
+ /* 1. Global DNS Suffix Search List */
+ if (RegOpenKeyExA(HKEY_LOCAL_MACHINE, WIN_NS_NT_KEY, 0, KEY_READ, &hKey) ==
+ ERROR_SUCCESS) {
+ get_REG_SZ(hKey, SEARCHLIST_KEY, outptr);
+ if (get_REG_SZ(hKey, DOMAIN_KEY, &p)) {
+ commajoin(outptr, p);
+ ares_free(p);
+ p = NULL;
+ }
+ RegCloseKey(hKey);
+ }
+
+ if (RegOpenKeyExA(HKEY_LOCAL_MACHINE, WIN_NT_DNSCLIENT, 0, KEY_READ, &hKey) ==
+ ERROR_SUCCESS) {
+ if (get_REG_SZ(hKey, SEARCHLIST_KEY, &p)) {
+ commajoin(outptr, p);
+ ares_free(p);
+ p = NULL;
+ }
+ RegCloseKey(hKey);
+ }
+
+ /* 2. Connection Specific Search List composed of:
+ * a. Primary DNS Suffix */
+ if (RegOpenKeyExA(HKEY_LOCAL_MACHINE, WIN_DNSCLIENT, 0, KEY_READ, &hKey) ==
+ ERROR_SUCCESS) {
+ if (get_REG_SZ(hKey, PRIMARYDNSSUFFIX_KEY, &p)) {
+ commajoin(outptr, p);
+ ares_free(p);
+ p = NULL;
+ }
+ RegCloseKey(hKey);
+ }
+
+ /* b. Interface SearchList, Domain, DhcpDomain */
+ if (RegOpenKeyExA(HKEY_LOCAL_MACHINE, WIN_NS_NT_KEY "\\" INTERFACES_KEY, 0,
+ KEY_READ, &hKey) == ERROR_SUCCESS) {
+ for (;;) {
+ keyNameBuffSize = sizeof(keyName);
+ if (RegEnumKeyExA(hKey, keyIdx++, keyName, &keyNameBuffSize, 0, NULL,
+ NULL, NULL) != ERROR_SUCCESS) {
+ break;
+ }
+ if (RegOpenKeyExA(hKey, keyName, 0, KEY_QUERY_VALUE, &hKeyEnum) !=
+ ERROR_SUCCESS) {
+ continue;
+ }
+ /* p can be comma separated (SearchList) */
+ if (get_REG_SZ(hKeyEnum, SEARCHLIST_KEY, &p)) {
+ commajoin(outptr, p);
+ ares_free(p);
+ p = NULL;
+ }
+ if (get_REG_SZ(hKeyEnum, DOMAIN_KEY, &p)) {
+ commajoin(outptr, p);
+ ares_free(p);
+ p = NULL;
+ }
+ if (get_REG_SZ(hKeyEnum, DHCPDOMAIN_KEY, &p)) {
+ commajoin(outptr, p);
+ ares_free(p);
+ p = NULL;
+ }
+ RegCloseKey(hKeyEnum);
+ }
+ RegCloseKey(hKey);
+ }
+
+ return *outptr != NULL ? ARES_TRUE : ARES_FALSE;
+}
+
+static ares_status_t ares__init_sysconfig_windows(ares_sysconfig_t *sysconfig)
+{
+ char *line = NULL;
+ ares_status_t status = ARES_SUCCESS;
+
+ if (get_DNS_Windows(&line)) {
+ status = ares__sconfig_append_fromstr(&sysconfig->sconfig, line, ARES_TRUE);
+ ares_free(line);
+ if (status != ARES_SUCCESS) {
+ goto done;
+ }
+ }
+
+ if (get_SuffixList_Windows(&line)) {
+ sysconfig->domains = ares__strsplit(line, ", ", &sysconfig->ndomains);
+ if (sysconfig->domains == NULL) {
+ status = ARES_EFILE;
+ }
+ if (status != ARES_SUCCESS) {
+ goto done;
+ }
+ }
+
+done:
+ return status;
+}
+#endif
+
+#if defined(__MVS__)
+static ares_status_t ares__init_sysconfig_mvs(ares_sysconfig_t *sysconfig)
+{
+ struct __res_state *res = 0;
+ size_t count4;
+ size_t count6;
+ int i;
+ __STATEEXTIPV6 *v6;
+ arse__llist_t *sconfig = NULL;
+ ares_status_t status;
+
+ if (0 == res) {
+ int rc = res_init();
+ while (rc == -1 && h_errno == TRY_AGAIN) {
+ rc = res_init();
+ }
+ if (rc == -1) {
+ return ARES_ENOMEM;
+ }
+ res = __res();
+ }
+
+ v6 = res->__res_extIPv6;
+ if (res->nscount > 0) {
+ count4 = (size_t)res->nscount;
+ }
+
+ if (v6 && v6->__stat_nscount > 0) {
+ count6 = (size_t)v6->__stat_nscount;
+ } else {
+ count6 = 0;
+ }
+
+ for (i = 0; i < count4; i++) {
+ struct sockaddr_in *addr_in = &(res->nsaddr_list[i]);
+ struct ares_addr addr;
+
+ addr.addr.addr4.s_addr = addr_in->sin_addr.s_addr;
+ addr.family = AF_INET;
+
+ status =
+ ares__sconfig_append(&sysconfig->sconfig, &addr, htons(addr_in->sin_port),
+ htons(addr_in->sin_port), NULL);
+
+ if (status != ARES_SUCCESS) {
+ return status;
+ }
+ }
+
+ for (i = 0; i < count6; i++) {
+ struct sockaddr_in6 *addr_in = &(v6->__stat_nsaddr_list[i]);
+ struct ares_addr addr;
+
+ addr.family = AF_INET6;
+ memcpy(&(addr.addr.addr6), &(addr_in->sin6_addr),
+ sizeof(addr_in->sin6_addr));
+
+ status =
+ ares__sconfig_append(&sysconfig->sconfig, &addr, htons(addr_in->sin_port),
+ htons(addr_in->sin_port), NULL);
+
+ if (status != ARES_SUCCESS) {
+ return status;
+ }
+ }
+
+ return ARES_SUCCESS;
+}
+#endif
+
+#if defined(__riscos__)
+static ares_status_t ares__init_sysconfig_riscos(ares_sysconfig_t *sysconfig)
+{
+ char *line;
+ ares_status_t status = ARES_SUCCESS;
+
+ /* Under RISC OS, name servers are listed in the
+ system variable Inet$Resolvers, space separated. */
+ line = getenv("Inet$Resolvers");
+ if (line) {
+ char *resolvers = ares_strdup(line);
+ char *pos;
+ char *space;
+
+ if (!resolvers) {
+ return ARES_ENOMEM;
+ }
+
+ pos = resolvers;
+ do {
+ space = strchr(pos, ' ');
+ if (space) {
+ *space = '\0';
+ }
+ status =
+ ares__sconfig_append_fromstr(&sysconfig->sconfig, pos, ARES_TRUE);
+ if (status != ARES_SUCCESS) {
+ break;
+ }
+ pos = space + 1;
+ } while (space);
+
+ ares_free(resolvers);
+ }
+
+ return status;
+}
+#endif
+
+#if defined(WATT32)
+static ares_status_t ares__init_sysconfig_watt32(ares_sysconfig_t *sysconfig)
+{
+ size_t i;
+ ares_status_t status;
+
+ sock_init();
+
+ for (i = 0; def_nameservers[i]; i++) {
+ struct ares_addr addr;
+
+ addr.family = AF_INET;
+ addr.addr.addr4.s_addr = htonl(def_nameservers[i]);
+
+ status = ares__sconfig_append(&sysconfig->sconfig, &addr, 0, 0, NULL);
+
+ if (status != ARES_SUCCESS) {
+ return status;
+ }
+ }
+
+ return ARES_SUCCESS;
+}
+#endif
+
+#if defined(ANDROID) || defined(__ANDROID__)
+static ares_status_t ares__init_sysconfig_android(ares_sysconfig_t *sysconfig)
+{
+ size_t i;
+ char **dns_servers;
+ char *domains;
+ size_t num_servers;
+ ares_status_t status = ARES_EFILE;
+
+ /* Use the Android connectivity manager to get a list
+ * of DNS servers. As of Android 8 (Oreo) net.dns#
+ * system properties are no longer available. Google claims this
+ * improves privacy. Apps now need the ACCESS_NETWORK_STATE
+ * permission and must use the ConnectivityManager which
+ * is Java only. */
+ dns_servers = ares_get_android_server_list(MAX_DNS_PROPERTIES, &num_servers);
+ if (dns_servers != NULL) {
+ for (i = 0; i < num_servers; i++) {
+ status = ares__sconfig_append_fromstr(&sysconfig->sconfig, dns_servers[i],
+ ARES_TRUE);
+ if (status != ARES_SUCCESS) {
+ return status;
+ }
+ }
+ for (i = 0; i < num_servers; i++) {
+ ares_free(dns_servers[i]);
+ }
+ ares_free(dns_servers);
+ }
+
+ domains = ares_get_android_search_domains_list();
+ sysconfig->domains = ares__strsplit(domains, ", ", &sysconfig->ndomains);
+ ares_free(domains);
+
+# ifdef HAVE___SYSTEM_PROPERTY_GET
+ /* Old way using the system property still in place as
+ * a fallback. Older android versions can still use this.
+ * it's possible for older apps not not have added the new
+ * permission and we want to try to avoid breaking those.
+ *
+ * We'll only run this if we don't have any dns servers
+ * because this will get the same ones (if it works). */
+ if (sysconfig->sconfig == NULL) {
+ char propname[PROP_NAME_MAX];
+ char propvalue[PROP_VALUE_MAX] = "";
+ for (i = 1; i <= MAX_DNS_PROPERTIES; i++) {
+ snprintf(propname, sizeof(propname), "%s%u", DNS_PROP_NAME_PREFIX, i);
+ if (__system_property_get(propname, propvalue) < 1) {
+ break;
+ }
+ status =
+ ares__sconfig_append_fromstr(&sysconfig->sconfig, propvalue, ARES_TRUE);
+ if (status != ARES_SUCCESS) {
+ return status;
+ }
+ }
+ }
+# endif /* HAVE___SYSTEM_PROPERTY_GET */
+
+ return status;
+}
+#endif
+
+#if defined(CARES_USE_LIBRESOLV)
+static ares_status_t ares__init_sysconfig_libresolv(ares_sysconfig_t *sysconfig)
+{
+ struct __res_state res;
+ ares_status_t status = ARES_SUCCESS;
+ union res_sockaddr_union addr[MAXNS];
+ int nscount;
+ size_t i;
+ size_t entries = 0;
+ ares__buf_t *ipbuf = NULL;
+
+ memset(&res, 0, sizeof(res));
+
+ if (res_ninit(&res) != 0 || !(res.options & RES_INIT)) {
+ return ARES_EFILE;
+ }
+
+ nscount = res_getservers(&res, addr, MAXNS);
+
+ for (i = 0; i < (size_t)nscount; ++i) {
+ char ipaddr[INET6_ADDRSTRLEN] = "";
+ char *ipstr = NULL;
+ unsigned short port = 0;
+ unsigned int ll_scope = 0;
+
+ sa_family_t family = addr[i].sin.sin_family;
+ if (family == AF_INET) {
+ ares_inet_ntop(family, &addr[i].sin.sin_addr, ipaddr, sizeof(ipaddr));
+ port = ntohs(addr[i].sin.sin_port);
+ } else if (family == AF_INET6) {
+ ares_inet_ntop(family, &addr[i].sin6.sin6_addr, ipaddr, sizeof(ipaddr));
+ port = ntohs(addr[i].sin6.sin6_port);
+ ll_scope = addr[i].sin6.sin6_scope_id;
+ } else {
+ continue;
+ }
+
+
+ /* [ip]:port%iface */
+ ipbuf = ares__buf_create();
+ if (ipbuf == NULL) {
+ status = ARES_ENOMEM;
+ goto done;
+ }
+
+ status = ares__buf_append_str(ipbuf, "[");
+ if (status != ARES_SUCCESS) {
+ goto done;
+ }
+
+ status = ares__buf_append_str(ipbuf, ipaddr);
+ if (status != ARES_SUCCESS) {
+ goto done;
+ }
+
+ status = ares__buf_append_str(ipbuf, "]");
+ if (status != ARES_SUCCESS) {
+ goto done;
+ }
+
+ if (port) {
+ status = ares__buf_append_str(ipbuf, ":");
+ if (status != ARES_SUCCESS) {
+ goto done;
+ }
+ status = ares__buf_append_num_dec(ipbuf, port, 0);
+ if (status != ARES_SUCCESS) {
+ goto done;
+ }
+ }
+
+ if (ll_scope) {
+ status = ares__buf_append_str(ipbuf, "%");
+ if (status != ARES_SUCCESS) {
+ goto done;
+ }
+ status = ares__buf_append_num_dec(ipbuf, ll_scope, 0);
+ if (status != ARES_SUCCESS) {
+ goto done;
+ }
+ }
+
+ ipstr = ares__buf_finish_str(ipbuf, NULL);
+ ipbuf = NULL;
+ if (ipstr == NULL) {
+ status = ARES_ENOMEM;
+ goto done;
+ }
+
+ status =
+ ares__sconfig_append_fromstr(&sysconfig->sconfig, ipstr, ARES_TRUE);
+
+ ares_free(ipstr);
+ if (status != ARES_SUCCESS) {
+ goto done;
+ }
+ }
+
+ while ((entries < MAXDNSRCH) && res.dnsrch[entries]) {
+ entries++;
+ }
+
+ if (entries) {
+ sysconfig->domains = ares_malloc_zero(entries * sizeof(char *));
+ if (sysconfig->domains == NULL) {
+ status = ARES_ENOMEM;
+ goto done;
+ } else {
+ sysconfig->ndomains = entries;
+ for (i = 0; i < sysconfig->ndomains; i++) {
+ sysconfig->domains[i] = ares_strdup(res.dnsrch[i]);
+ if (sysconfig->domains[i] == NULL) {
+ status = ARES_ENOMEM;
+ goto done;
+ }
+ }
+ }
+ }
+
+ if (res.ndots > 0) {
+ sysconfig->ndots = (size_t)res.ndots;
+ }
+ if (res.retry > 0) {
+ sysconfig->tries = (size_t)res.retry;
+ }
+ if (res.options & RES_ROTATE) {
+ sysconfig->rotate = ARES_TRUE;
+ }
+
+ if (res.retrans > 0) {
+ if (res.retrans > 0) {
+ sysconfig->timeout_ms = (unsigned int)res.retrans * 1000;
+ }
+# ifdef __APPLE__
+ if (res.retry >= 0) {
+ sysconfig->timeout_ms /=
+ ((unsigned int)res.retry + 1) *
+ (unsigned int)(res.nscount > 0 ? res.nscount : 1);
+ }
+# endif
+ }
+
+done:
+ ares__buf_destroy(ipbuf);
+ res_ndestroy(&res);
+ return status;
+}
+#endif
+
+static void ares_sysconfig_free(ares_sysconfig_t *sysconfig)
+{
+ ares__llist_destroy(sysconfig->sconfig);
+ ares__strsplit_free(sysconfig->domains, sysconfig->ndomains);
+ ares_free(sysconfig->sortlist);
+ ares_free(sysconfig->lookups);
+ memset(sysconfig, 0, sizeof(*sysconfig));
+}
+
+static ares_status_t ares_sysconfig_apply(ares_channel_t *channel,
+ const ares_sysconfig_t *sysconfig)
+{
+ ares_status_t status;
+
+ if (sysconfig->sconfig && !(channel->optmask & ARES_OPT_SERVERS)) {
+ status = ares__servers_update(channel, sysconfig->sconfig, ARES_FALSE);
+ if (status != ARES_SUCCESS) {
+ return status;
+ }
+ }
+
+ if (sysconfig->domains && !(channel->optmask & ARES_OPT_DOMAINS)) {
+ /* Make sure we duplicate first then replace so even if there is
+ * ARES_ENOMEM, the channel stays in a good state */
+ char **temp =
+ ares__strsplit_duplicate(sysconfig->domains, sysconfig->ndomains);
+ if (temp == NULL) {
+ return ARES_ENOMEM;
+ }
+
+ ares__strsplit_free(channel->domains, channel->ndomains);
+ channel->domains = temp;
+ channel->ndomains = sysconfig->ndomains;
+ }
+
+ if (sysconfig->lookups && !(channel->optmask & ARES_OPT_LOOKUPS)) {
+ char *temp = ares_strdup(sysconfig->lookups);
+ if (temp == NULL) {
+ return ARES_ENOMEM;
+ }
+
+ ares_free(channel->lookups);
+ channel->lookups = temp;
+ }
+
+ if (sysconfig->sortlist && !(channel->optmask & ARES_OPT_SORTLIST)) {
+ struct apattern *temp =
+ ares_malloc(sizeof(*channel->sortlist) * sysconfig->nsortlist);
+ if (temp == NULL) {
+ return ARES_ENOMEM;
+ }
+ memcpy(temp, sysconfig->sortlist,
+ sizeof(*channel->sortlist) * sysconfig->nsortlist);
+
+ ares_free(channel->sortlist);
+ channel->sortlist = temp;
+ channel->nsort = sysconfig->nsortlist;
+ }
+
+ if (sysconfig->ndots && !(channel->optmask & ARES_OPT_NDOTS)) {
+ channel->ndots = sysconfig->ndots;
+ }
+
+ if (sysconfig->tries && !(channel->optmask & ARES_OPT_TRIES)) {
+ channel->tries = sysconfig->tries;
+ }
+
+ if (sysconfig->timeout_ms && !(channel->optmask & ARES_OPT_TIMEOUTMS)) {
+ channel->timeout = sysconfig->timeout_ms;
+ }
+
+ if (!(channel->optmask & (ARES_OPT_ROTATE | ARES_OPT_NOROTATE))) {
+ channel->rotate = sysconfig->rotate;
+ }
+
+ return ARES_SUCCESS;
+}
+
+ares_status_t ares__init_by_sysconfig(ares_channel_t *channel)
+{
+ ares_status_t status;
+ ares_sysconfig_t sysconfig;
+
+ memset(&sysconfig, 0, sizeof(sysconfig));
+
+#ifdef _WIN32
+ status = ares__init_sysconfig_windows(&sysconfig);
+#elif defined(__MVS__)
+ status = ares__init_sysconfig_mvs(&sysconfig);
+#elif defined(__riscos__)
+ status = ares__init_sysconfig_riscos(&sysconfig);
+#elif defined(WATT32)
+ status = ares__init_sysconfig_watt32(&sysconfig);
+#elif defined(ANDROID) || defined(__ANDROID__)
+ status = ares__init_sysconfig_android(&sysconfig);
+#elif defined(CARES_USE_LIBRESOLV)
+ status = ares__init_sysconfig_libresolv(&sysconfig);
+#else
+ status = ares__init_sysconfig_files(channel, &sysconfig);
+#endif
+
+ if (status != ARES_SUCCESS) {
+ goto done;
+ }
+
+ /* Environment is supposed to override sysconfig */
+ status = ares__init_by_environment(&sysconfig);
+ if (status != ARES_SUCCESS) {
+ goto done;
+ }
+
+ status = ares_sysconfig_apply(channel, &sysconfig);
+ if (status != ARES_SUCCESS) {
+ goto done;
+ }
+
+done:
+ ares_sysconfig_free(&sysconfig);
+
+ return status;
+}
diff --git a/subprojects/c-ares/src/lib/ares_sysconfig_files.c b/subprojects/c-ares/src/lib/ares_sysconfig_files.c
@@ -0,0 +1,705 @@
+/* MIT License
+ *
+ * Copyright (c) 1998 Massachusetts Institute of Technology
+ * Copyright (c) 2007 Daniel Stenberg
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice (including the next
+ * paragraph) shall be included in all copies or substantial portions of the
+ * Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ *
+ * SPDX-License-Identifier: MIT
+ */
+
+#include "ares_setup.h"
+
+#ifdef HAVE_SYS_PARAM_H
+# include <sys/param.h>
+#endif
+
+#ifdef HAVE_NETINET_IN_H
+# include <netinet/in.h>
+#endif
+
+#ifdef HAVE_NETDB_H
+# include <netdb.h>
+#endif
+
+#ifdef HAVE_ARPA_INET_H
+# include <arpa/inet.h>
+#endif
+
+#include "ares_nameser.h"
+
+#if defined(ANDROID) || defined(__ANDROID__)
+# include <sys/system_properties.h>
+# include "ares_android.h"
+/* From the Bionic sources */
+# define DNS_PROP_NAME_PREFIX "net.dns"
+# define MAX_DNS_PROPERTIES 8
+#endif
+
+#if defined(CARES_USE_LIBRESOLV)
+# include <resolv.h>
+#endif
+
+#if defined(USE_WINSOCK) && defined(HAVE_IPHLPAPI_H)
+# include <iphlpapi.h>
+#endif
+
+#include "ares.h"
+#include "ares_inet_net_pton.h"
+#include "ares_platform.h"
+#include "ares_private.h"
+
+static unsigned char ip_natural_mask(const struct ares_addr *addr)
+{
+ const unsigned char *ptr = NULL;
+ /* This is an odd one. If a raw ipv4 address is specified, then we take
+ * what is called a natural mask, which means we look at the first octet
+ * of the ip address and for values 0-127 we assume it is a class A (/8),
+ * for values 128-191 we assume it is a class B (/16), and for 192-223
+ * we assume it is a class C (/24). 223-239 is Class D which and 240-255 is
+ * Class E, however, there is no pre-defined mask for this, so we'll use
+ * /24 as well as that's what the old code did.
+ *
+ * For IPv6, we'll use /64.
+ */
+
+ if (addr->family == AF_INET6) {
+ return 64;
+ }
+
+ ptr = (const unsigned char *)&addr->addr.addr4;
+ if (*ptr < 128) {
+ return 8;
+ }
+
+ if (*ptr < 192) {
+ return 16;
+ }
+
+ return 24;
+}
+
+static ares_bool_t sortlist_append(struct apattern **sortlist, size_t *nsort,
+ const struct apattern *pat)
+{
+ struct apattern *newsort;
+
+ newsort = ares_realloc(*sortlist, (*nsort + 1) * sizeof(*newsort));
+ if (newsort == NULL) {
+ return ARES_FALSE;
+ }
+
+ *sortlist = newsort;
+
+ memcpy(&(*sortlist)[*nsort], pat, sizeof(**sortlist));
+ (*nsort)++;
+
+ return ARES_TRUE;
+}
+
+static ares_status_t parse_sort(ares__buf_t *buf, struct apattern *pat)
+{
+ ares_status_t status;
+ const unsigned char ip_charset[] = "ABCDEFabcdef0123456789.:";
+ char ipaddr[INET6_ADDRSTRLEN] = "";
+ size_t addrlen;
+
+ memset(pat, 0, sizeof(*pat));
+
+ /* Consume any leading whitespace */
+ ares__buf_consume_whitespace(buf, ARES_TRUE);
+
+ /* If no length, just ignore, return ENOTFOUND as an indicator */
+ if (ares__buf_len(buf) == 0) {
+ return ARES_ENOTFOUND;
+ }
+
+ ares__buf_tag(buf);
+
+ /* Consume ip address */
+ if (ares__buf_consume_charset(buf, ip_charset, sizeof(ip_charset)) == 0) {
+ return ARES_EBADSTR;
+ }
+
+ /* Fetch ip address */
+ status = ares__buf_tag_fetch_string(buf, ipaddr, sizeof(ipaddr));
+ if (status != ARES_SUCCESS) {
+ return status;
+ }
+
+ /* Parse it to make sure its valid */
+ pat->addr.family = AF_UNSPEC;
+ if (ares_dns_pton(ipaddr, &pat->addr, &addrlen) == NULL) {
+ return ARES_EBADSTR;
+ }
+
+ /* See if there is a subnet mask */
+ if (ares__buf_begins_with(buf, (const unsigned char *)"/", 1)) {
+ char maskstr[16];
+ const unsigned char ipv4_charset[] = "0123456789.";
+
+
+ /* Consume / */
+ ares__buf_consume(buf, 1);
+
+ ares__buf_tag(buf);
+
+ /* Consume mask */
+ if (ares__buf_consume_charset(buf, ipv4_charset, sizeof(ipv4_charset)) ==
+ 0) {
+ return ARES_EBADSTR;
+ }
+
+ /* Fetch mask */
+ status = ares__buf_tag_fetch_string(buf, maskstr, sizeof(maskstr));
+ if (status != ARES_SUCCESS) {
+ return status;
+ }
+
+ if (ares_str_isnum(maskstr)) {
+ /* Numeric mask */
+ int mask = atoi(maskstr);
+ if (mask < 0 || mask > 128) {
+ return ARES_EBADSTR;
+ }
+ if (pat->addr.family == AF_INET && mask > 32) {
+ return ARES_EBADSTR;
+ }
+ pat->mask = (unsigned char)mask;
+ } else {
+ /* Ipv4 subnet style mask */
+ struct ares_addr maskaddr;
+ const unsigned char *ptr;
+
+ memset(&maskaddr, 0, sizeof(maskaddr));
+ maskaddr.family = AF_INET;
+ if (ares_dns_pton(maskstr, &maskaddr, &addrlen) == NULL) {
+ return ARES_EBADSTR;
+ }
+ ptr = (const unsigned char *)&maskaddr.addr.addr4;
+ pat->mask = (unsigned char)(ares__count_bits_u8(ptr[0]) +
+ ares__count_bits_u8(ptr[1]) +
+ ares__count_bits_u8(ptr[2]) +
+ ares__count_bits_u8(ptr[3]));
+ }
+ } else {
+ pat->mask = ip_natural_mask(&pat->addr);
+ }
+
+ /* Consume any trailing whitespace */
+ ares__buf_consume_whitespace(buf, ARES_TRUE);
+
+ /* If we have any trailing bytes other than whitespace, its a parse failure */
+ if (ares__buf_len(buf) != 0) {
+ return ARES_EBADSTR;
+ }
+
+ return ARES_SUCCESS;
+}
+
+ares_status_t ares__parse_sortlist(struct apattern **sortlist, size_t *nsort,
+ const char *str)
+{
+ ares__buf_t *buf = NULL;
+ ares__llist_t *list = NULL;
+ ares_status_t status = ARES_SUCCESS;
+ ares__llist_node_t *node = NULL;
+
+ if (sortlist == NULL || nsort == NULL || str == NULL) {
+ return ARES_EFORMERR;
+ }
+
+ if (*sortlist != NULL) {
+ ares_free(*sortlist);
+ }
+
+ *sortlist = NULL;
+ *nsort = 0;
+
+ buf = ares__buf_create_const((const unsigned char *)str, ares_strlen(str));
+ if (buf == NULL) {
+ status = ARES_ENOMEM;
+ goto done;
+ }
+
+ /* Split on space or semicolon */
+ status = ares__buf_split(buf, (const unsigned char *)" ;", 2,
+ ARES_BUF_SPLIT_NONE, &list);
+ if (status != ARES_SUCCESS) {
+ goto done;
+ }
+
+ for (node = ares__llist_node_first(list); node != NULL;
+ node = ares__llist_node_next(node)) {
+ ares__buf_t *entry = ares__llist_node_val(node);
+
+ struct apattern pat;
+
+ status = parse_sort(entry, &pat);
+ if (status != ARES_SUCCESS && status != ARES_ENOTFOUND) {
+ goto done;
+ }
+
+ if (status != ARES_SUCCESS) {
+ continue;
+ }
+
+ if (!sortlist_append(sortlist, nsort, &pat)) {
+ status = ARES_ENOMEM;
+ goto done;
+ }
+ }
+
+ status = ARES_SUCCESS;
+
+done:
+ ares__buf_destroy(buf);
+ ares__llist_destroy(list);
+
+ if (status != ARES_SUCCESS) {
+ ares_free(*sortlist);
+ *sortlist = NULL;
+ *nsort = 0;
+ }
+
+ return status;
+}
+
+static ares_status_t config_search(ares_sysconfig_t *sysconfig, const char *str)
+{
+ if (sysconfig->domains && sysconfig->ndomains > 0) {
+ /* if we already have some domains present, free them first */
+ ares__strsplit_free(sysconfig->domains, sysconfig->ndomains);
+ sysconfig->domains = NULL;
+ sysconfig->ndomains = 0;
+ }
+
+ sysconfig->domains = ares__strsplit(str, ", ", &sysconfig->ndomains);
+ if (sysconfig->domains == NULL) {
+ return ARES_ENOMEM;
+ }
+
+ return ARES_SUCCESS;
+}
+
+static ares_status_t config_domain(ares_sysconfig_t *sysconfig, char *str)
+{
+ char *q;
+
+ /* Set a single search domain. */
+ q = str;
+ while (*q && !ISSPACE(*q)) {
+ q++;
+ }
+ *q = '\0';
+
+ return config_search(sysconfig, str);
+}
+
+static ares_status_t config_lookup(ares_sysconfig_t *sysconfig, const char *str,
+ const char *bindch, const char *altbindch,
+ const char *filech)
+{
+ char lookups[3];
+ char *l;
+ const char *p;
+ ares_bool_t found;
+
+ if (altbindch == NULL) {
+ altbindch = bindch;
+ }
+
+ /* Set the lookup order. Only the first letter of each work
+ * is relevant, and it has to be "b" for DNS or "f" for the
+ * host file. Ignore everything else.
+ */
+ l = lookups;
+ p = str;
+ found = ARES_FALSE;
+ while (*p) {
+ if ((*p == *bindch || *p == *altbindch || *p == *filech) &&
+ l < lookups + 2) {
+ if (*p == *bindch || *p == *altbindch) {
+ *l++ = 'b';
+ } else {
+ *l++ = 'f';
+ }
+ found = ARES_TRUE;
+ }
+ while (*p && !ISSPACE(*p) && (*p != ',')) {
+ p++;
+ }
+ while (*p && (ISSPACE(*p) || (*p == ','))) {
+ p++;
+ }
+ }
+ if (!found) {
+ return ARES_ENOTINITIALIZED;
+ }
+ *l = '\0';
+
+ ares_free(sysconfig->lookups);
+ sysconfig->lookups = ares_strdup(lookups);
+ if (sysconfig->lookups == NULL) {
+ return ARES_ENOMEM;
+ }
+ return ARES_SUCCESS;
+}
+
+static const char *try_option(const char *p, const char *q, const char *opt)
+{
+ size_t len = ares_strlen(opt);
+ return ((size_t)(q - p) >= len && !strncmp(p, opt, len)) ? &p[len] : NULL;
+}
+
+static ares_status_t set_options(ares_sysconfig_t *sysconfig, const char *str)
+{
+ const char *p;
+ const char *q;
+ const char *val;
+
+ if (str == NULL) {
+ return ARES_SUCCESS;
+ }
+
+ p = str;
+ while (*p) {
+ q = p;
+ while (*q && !ISSPACE(*q)) {
+ q++;
+ }
+ val = try_option(p, q, "ndots:");
+ if (val) {
+ sysconfig->ndots = strtoul(val, NULL, 10);
+ }
+
+ // Outdated option.
+ val = try_option(p, q, "retrans:");
+ if (val) {
+ sysconfig->timeout_ms = strtoul(val, NULL, 10);
+ }
+
+ val = try_option(p, q, "timeout:");
+ if (val) {
+ sysconfig->timeout_ms = strtoul(val, NULL, 10) * 1000;
+ }
+
+ // Outdated option.
+ val = try_option(p, q, "retry:");
+ if (val) {
+ sysconfig->tries = strtoul(val, NULL, 10);
+ }
+
+ val = try_option(p, q, "attempts:");
+ if (val) {
+ sysconfig->tries = strtoul(val, NULL, 10);
+ }
+
+ val = try_option(p, q, "rotate");
+ if (val) {
+ sysconfig->rotate = ARES_TRUE;
+ }
+
+ p = q;
+ while (ISSPACE(*p)) {
+ p++;
+ }
+ }
+
+ return ARES_SUCCESS;
+}
+
+static char *try_config(char *s, const char *opt, char scc)
+{
+ size_t len;
+ char *p;
+ char *q;
+
+ if (!s || !opt) {
+ /* no line or no option */
+ return NULL; /* LCOV_EXCL_LINE */
+ }
+
+ /* Hash '#' character is always used as primary comment char, additionally
+ a not-NUL secondary comment char will be considered when specified. */
+
+ /* trim line comment */
+ p = s;
+ if (scc) {
+ while (*p && (*p != '#') && (*p != scc)) {
+ p++;
+ }
+ } else {
+ while (*p && (*p != '#')) {
+ p++;
+ }
+ }
+ *p = '\0';
+
+ /* trim trailing whitespace */
+ q = p - 1;
+ while ((q >= s) && ISSPACE(*q)) {
+ q--;
+ }
+ *++q = '\0';
+
+ /* skip leading whitespace */
+ p = s;
+ while (*p && ISSPACE(*p)) {
+ p++;
+ }
+
+ if (!*p) {
+ /* empty line */
+ return NULL;
+ }
+
+ if ((len = ares_strlen(opt)) == 0) {
+ /* empty option */
+ return NULL; /* LCOV_EXCL_LINE */
+ }
+
+ if (strncmp(p, opt, len) != 0) {
+ /* line and option do not match */
+ return NULL;
+ }
+
+ /* skip over given option name */
+ p += len;
+
+ if (!*p) {
+ /* no option value */
+ return NULL; /* LCOV_EXCL_LINE */
+ }
+
+ if ((opt[len - 1] != ':') && (opt[len - 1] != '=') && !ISSPACE(*p)) {
+ /* whitespace between option name and value is mandatory
+ for given option names which do not end with ':' or '=' */
+ return NULL;
+ }
+
+ /* skip over whitespace */
+ while (*p && ISSPACE(*p)) {
+ p++;
+ }
+
+ if (!*p) {
+ /* no option value */
+ return NULL;
+ }
+
+ /* return pointer to option value */
+ return p;
+}
+
+ares_status_t ares__init_by_environment(ares_sysconfig_t *sysconfig)
+{
+ const char *localdomain;
+ const char *res_options;
+ ares_status_t status;
+
+ localdomain = getenv("LOCALDOMAIN");
+ if (localdomain) {
+ char *temp = ares_strdup(localdomain);
+ if (temp == NULL) {
+ return ARES_ENOMEM;
+ }
+ status = config_domain(sysconfig, temp);
+ ares_free(temp);
+ if (status != ARES_SUCCESS) {
+ return status;
+ }
+ }
+
+ res_options = getenv("RES_OPTIONS");
+ if (res_options) {
+ status = set_options(sysconfig, res_options);
+ if (status != ARES_SUCCESS) {
+ return status;
+ }
+ }
+
+ return ARES_SUCCESS;
+}
+
+ares_status_t ares__init_sysconfig_files(const ares_channel_t *channel,
+ ares_sysconfig_t *sysconfig)
+{
+ char *p;
+ FILE *fp = NULL;
+ char *line = NULL;
+ size_t linesize = 0;
+ int error;
+ const char *resolvconf_path;
+ ares_status_t status = ARES_SUCCESS;
+
+ /* Support path for resolvconf filename set by ares_init_options */
+ if (channel->resolvconf_path) {
+ resolvconf_path = channel->resolvconf_path;
+ } else {
+ resolvconf_path = PATH_RESOLV_CONF;
+ }
+
+ fp = fopen(resolvconf_path, "r");
+ if (fp) {
+ while ((status = ares__read_line(fp, &line, &linesize)) == ARES_SUCCESS) {
+ if ((p = try_config(line, "domain", ';'))) {
+ status = config_domain(sysconfig, p);
+ } else if ((p = try_config(line, "lookup", ';'))) {
+ status = config_lookup(sysconfig, p, "bind", NULL, "file");
+ } else if ((p = try_config(line, "search", ';'))) {
+ status = config_search(sysconfig, p);
+ } else if ((p = try_config(line, "nameserver", ';'))) {
+ status =
+ ares__sconfig_append_fromstr(&sysconfig->sconfig, p, ARES_TRUE);
+ } else if ((p = try_config(line, "sortlist", ';'))) {
+ /* Ignore all failures except ENOMEM. If the sysadmin set a bad
+ * sortlist, just ignore the sortlist, don't cause an inoperable
+ * channel */
+ status =
+ ares__parse_sortlist(&sysconfig->sortlist, &sysconfig->nsortlist, p);
+ if (status != ARES_ENOMEM) {
+ status = ARES_SUCCESS;
+ }
+ } else if ((p = try_config(line, "options", ';'))) {
+ status = set_options(sysconfig, p);
+ } else {
+ status = ARES_SUCCESS;
+ }
+ if (status != ARES_SUCCESS) {
+ fclose(fp);
+ goto done;
+ }
+ }
+ fclose(fp);
+
+ if (status != ARES_EOF) {
+ goto done;
+ }
+ } else {
+ error = ERRNO;
+ switch (error) {
+ case ENOENT:
+ case ESRCH:
+ break;
+ default:
+ DEBUGF(fprintf(stderr, "fopen() failed with error: %d %s\n", error,
+ strerror(error)));
+ DEBUGF(fprintf(stderr, "Error opening file: %s\n", PATH_RESOLV_CONF));
+ status = ARES_EFILE;
+ goto done;
+ }
+ }
+
+
+ /* Many systems (Solaris, Linux, BSD's) use nsswitch.conf */
+ fp = fopen("/etc/nsswitch.conf", "r");
+ if (fp) {
+ while ((status = ares__read_line(fp, &line, &linesize)) == ARES_SUCCESS) {
+ if ((p = try_config(line, "hosts:", '\0'))) {
+ (void)config_lookup(sysconfig, p, "dns", "resolve", "files");
+ }
+ }
+ fclose(fp);
+ if (status != ARES_EOF) {
+ goto done;
+ }
+ } else {
+ error = ERRNO;
+ switch (error) {
+ case ENOENT:
+ case ESRCH:
+ break;
+ default:
+ DEBUGF(fprintf(stderr, "fopen() failed with error: %d %s\n", error,
+ strerror(error)));
+ DEBUGF(
+ fprintf(stderr, "Error opening file: %s\n", "/etc/nsswitch.conf"));
+ break;
+ }
+ /* ignore error, maybe we will get luck in next if clause */
+ }
+
+
+ /* Linux / GNU libc 2.x and possibly others have host.conf */
+ fp = fopen("/etc/host.conf", "r");
+ if (fp) {
+ while ((status = ares__read_line(fp, &line, &linesize)) == ARES_SUCCESS) {
+ if ((p = try_config(line, "order", '\0'))) {
+ /* ignore errors */
+ (void)config_lookup(sysconfig, p, "bind", NULL, "hosts");
+ }
+ }
+ fclose(fp);
+ if (status != ARES_EOF) {
+ goto done;
+ }
+ } else {
+ error = ERRNO;
+ switch (error) {
+ case ENOENT:
+ case ESRCH:
+ break;
+ default:
+ DEBUGF(fprintf(stderr, "fopen() failed with error: %d %s\n", error,
+ strerror(error)));
+ DEBUGF(fprintf(stderr, "Error opening file: %s\n", "/etc/host.conf"));
+ break;
+ }
+
+ /* ignore error, maybe we will get luck in next if clause */
+ }
+
+
+ /* Tru64 uses /etc/svc.conf */
+ fp = fopen("/etc/svc.conf", "r");
+ if (fp) {
+ while ((status = ares__read_line(fp, &line, &linesize)) == ARES_SUCCESS) {
+ if ((p = try_config(line, "hosts=", '\0'))) {
+ /* ignore errors */
+ (void)config_lookup(sysconfig, p, "bind", NULL, "local");
+ }
+ }
+ fclose(fp);
+ if (status != ARES_EOF) {
+ goto done;
+ }
+ } else {
+ error = ERRNO;
+ switch (error) {
+ case ENOENT:
+ case ESRCH:
+ break;
+ default:
+ DEBUGF(fprintf(stderr, "fopen() failed with error: %d %s\n", error,
+ strerror(error)));
+ DEBUGF(fprintf(stderr, "Error opening file: %s\n", "/etc/svc.conf"));
+ break;
+ }
+ /* ignore error */
+ }
+
+ status = ARES_SUCCESS;
+
+done:
+ ares_free(line);
+
+ return status;
+}
diff --git a/subprojects/c-ares/src/lib/ares_timeout.c b/subprojects/c-ares/src/lib/ares_timeout.c
@@ -0,0 +1,97 @@
+/* MIT License
+ *
+ * Copyright (c) 1998 Massachusetts Institute of Technology
+ * Copyright (c) The c-ares project and its contributors
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice (including the next
+ * paragraph) shall be included in all copies or substantial portions of the
+ * Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ *
+ * SPDX-License-Identifier: MIT
+ */
+
+#include "ares_setup.h"
+
+#ifdef HAVE_LIMITS_H
+# include <limits.h>
+#endif
+
+#include "ares.h"
+#include "ares_private.h"
+
+void ares__timeval_remaining(struct timeval *remaining,
+ const struct timeval *now,
+ const struct timeval *tout)
+{
+ memset(remaining, 0, sizeof(*remaining));
+
+ /* Expired! */
+ if (tout->tv_sec < now->tv_sec ||
+ (tout->tv_sec == now->tv_sec && tout->tv_usec < now->tv_usec)) {
+ return;
+ }
+
+ remaining->tv_sec = tout->tv_sec - now->tv_sec;
+ if (tout->tv_usec < now->tv_usec) {
+ remaining->tv_sec -= 1;
+ remaining->tv_usec = (tout->tv_usec + 1000000) - now->tv_usec;
+ } else {
+ remaining->tv_usec = tout->tv_usec - now->tv_usec;
+ }
+}
+
+struct timeval *ares_timeout(ares_channel_t *channel, struct timeval *maxtv,
+ struct timeval *tvbuf)
+{
+ const struct query *query;
+ ares__slist_node_t *node;
+ struct timeval now;
+
+ /* The minimum timeout of all queries is always the first entry in
+ * channel->queries_by_timeout */
+ node = ares__slist_node_first(channel->queries_by_timeout);
+ /* no queries/timeout */
+ if (node == NULL) {
+ return maxtv; /* <-- maxtv can be null though, hrm */
+ }
+
+ query = ares__slist_node_val(node);
+
+ now = ares__tvnow();
+
+ ares__timeval_remaining(tvbuf, &now, &query->timeout);
+
+ if (maxtv == NULL) {
+ return tvbuf;
+ }
+
+ /* Return the minimum time between maxtv and tvbuf */
+
+ if (tvbuf->tv_sec > maxtv->tv_sec) {
+ return maxtv;
+ }
+ if (tvbuf->tv_sec < maxtv->tv_sec) {
+ return tvbuf;
+ }
+
+ if (tvbuf->tv_usec > maxtv->tv_usec) {
+ return maxtv;
+ }
+
+ return tvbuf;
+}
diff --git a/subprojects/c-ares/src/lib/ares_update_servers.c b/subprojects/c-ares/src/lib/ares_update_servers.c
@@ -0,0 +1,1193 @@
+/* MIT License
+ *
+ * Copyright (c) 1998 Massachusetts Institute of Technology
+ * Copyright (c) 2008 Daniel Stenberg
+ * Copyright (c) 2023 Brad House
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice (including the next
+ * paragraph) shall be included in all copies or substantial portions of the
+ * Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ *
+ * SPDX-License-Identifier: MIT
+ */
+#include "ares_setup.h"
+
+#ifdef HAVE_ARPA_INET_H
+# include <arpa/inet.h>
+#endif
+#ifdef HAVE_SYS_TYPES_H
+# include <sys/types.h>
+#endif
+#ifdef HAVE_SYS_SOCKET_H
+# include <sys/socket.h>
+#endif
+#ifdef HAVE_NET_IF_H
+# include <net/if.h>
+#endif
+
+#if defined(USE_WINSOCK)
+# if defined(HAVE_IPHLPAPI_H)
+# include <iphlpapi.h>
+# endif
+# if defined(HAVE_NETIOAPI_H)
+# include <netioapi.h>
+# endif
+#endif
+
+#include "ares.h"
+#include "ares_data.h"
+#include "ares_inet_net_pton.h"
+#include "ares_private.h"
+
+typedef struct {
+ struct ares_addr addr;
+ unsigned short tcp_port;
+ unsigned short udp_port;
+
+ char ll_iface[IF_NAMESIZE];
+ unsigned int ll_scope;
+} ares_sconfig_t;
+
+static ares_bool_t ares__addr_match(const struct ares_addr *addr1,
+ const struct ares_addr *addr2)
+{
+ if (addr1 == NULL && addr2 == NULL) {
+ return ARES_TRUE;
+ }
+
+ if (addr1 == NULL || addr2 == NULL) {
+ return ARES_FALSE;
+ }
+
+ if (addr1->family != addr2->family) {
+ return ARES_FALSE;
+ }
+
+ if (addr1->family == AF_INET && memcmp(&addr1->addr.addr4, &addr2->addr.addr4,
+ sizeof(addr1->addr.addr4)) == 0) {
+ return ARES_TRUE;
+ }
+
+ if (addr1->family == AF_INET6 &&
+ memcmp(&addr1->addr.addr6._S6_un._S6_u8, &addr2->addr.addr6._S6_un._S6_u8,
+ sizeof(addr1->addr.addr6._S6_un._S6_u8)) == 0) {
+ return ARES_TRUE;
+ }
+
+ return ARES_FALSE;
+}
+
+ares_bool_t ares__subnet_match(const struct ares_addr *addr,
+ const struct ares_addr *subnet,
+ unsigned char netmask)
+{
+ const unsigned char *addr_ptr;
+ const unsigned char *subnet_ptr;
+ size_t len;
+ size_t i;
+
+ if (addr == NULL || subnet == NULL) {
+ return ARES_FALSE;
+ }
+
+ if (addr->family != subnet->family) {
+ return ARES_FALSE;
+ }
+
+ if (addr->family == AF_INET) {
+ addr_ptr = (const unsigned char *)&addr->addr.addr4;
+ subnet_ptr = (const unsigned char *)&subnet->addr.addr4;
+ len = 4;
+
+ if (netmask > 32) {
+ return ARES_FALSE;
+ }
+ } else if (addr->family == AF_INET6) {
+ addr_ptr = (const unsigned char *)&addr->addr.addr6;
+ subnet_ptr = (const unsigned char *)&subnet->addr.addr6;
+ len = 16;
+
+ if (netmask > 128) {
+ return ARES_FALSE;
+ }
+ } else {
+ return ARES_FALSE;
+ }
+
+ for (i = 0; i < len && netmask > 0; i++) {
+ unsigned char mask = 0xff;
+ if (netmask < 8) {
+ mask <<= (8 - netmask);
+ netmask = 0;
+ } else {
+ netmask -= 8;
+ }
+
+ if ((addr_ptr[i] & mask) != (subnet_ptr[i] & mask)) {
+ return ARES_FALSE;
+ }
+ }
+
+ return ARES_TRUE;
+}
+
+ares_bool_t ares__addr_is_linklocal(const struct ares_addr *addr)
+{
+ struct ares_addr subnet;
+ const unsigned char subnetaddr[16] = { 0xfe, 0x80, 0x00, 0x00, 0x00, 0x00,
+ 0x00, 0x00, 0x00, 0x00, 0x00, 0x00,
+ 0x00, 0x00, 0x00, 0x00 };
+
+ /* fe80::/10 */
+ subnet.family = AF_INET6;
+ memcpy(&subnet.addr.addr6, subnetaddr, 16);
+
+ return ares__subnet_match(addr, &subnet, 10);
+}
+
+static ares_bool_t ares_server_blacklisted(const struct ares_addr *addr)
+{
+ /* A list of blacklisted IPv6 subnets. */
+ const struct {
+ const unsigned char netbase[16];
+ unsigned char netmask;
+ } blacklist_v6[] = {
+ /* fec0::/10 was deprecated by [RFC3879] in September 2004. Formerly a
+ * Site-Local scoped address prefix. These are never valid DNS servers,
+ * but are known to be returned at least sometimes on Windows and Android.
+ */
+ {{ 0xfe, 0xc0, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00,
+ 0x00, 0x00, 0x00, 0x00 },
+ 10}
+ };
+
+ size_t i;
+
+ if (addr->family != AF_INET6) {
+ return ARES_FALSE;
+ }
+
+ /* See if ipaddr matches any of the entries in the blacklist. */
+ for (i = 0; i < sizeof(blacklist_v6) / sizeof(*blacklist_v6); i++) {
+ struct ares_addr subnet;
+ subnet.family = AF_INET6;
+ memcpy(&subnet.addr.addr6, blacklist_v6[i].netbase, 16);
+ if (ares__subnet_match(addr, &subnet, blacklist_v6[i].netmask)) {
+ return ARES_TRUE;
+ }
+ }
+ return ARES_FALSE;
+}
+
+/* Parse address and port in these formats, either ipv4 or ipv6 addresses
+ * are allowed:
+ * ipaddr
+ * ipv4addr:port
+ * [ipaddr]
+ * [ipaddr]:port
+ *
+ * Modifiers: %iface
+ *
+ * TODO: #domain modifier
+ *
+ * If a port is not specified, will set port to 0.
+ *
+ * Will fail if an IPv6 nameserver as detected by
+ * ares_ipv6_server_blacklisted()
+ *
+ * Returns an error code on failure, else ARES_SUCCESS
+ */
+
+static ares_status_t parse_nameserver(ares__buf_t *buf, ares_sconfig_t *sconfig)
+{
+ ares_status_t status;
+ char ipaddr[INET6_ADDRSTRLEN] = "";
+ size_t addrlen;
+
+ memset(sconfig, 0, sizeof(*sconfig));
+
+ /* Consume any leading whitespace */
+ ares__buf_consume_whitespace(buf, ARES_TRUE);
+
+ /* pop off IP address. If it is in [ ] then it can be ipv4 or ipv6. If
+ * not, ipv4 only */
+ if (ares__buf_begins_with(buf, (const unsigned char *)"[", 1)) {
+ /* Consume [ */
+ ares__buf_consume(buf, 1);
+
+ ares__buf_tag(buf);
+
+ /* Consume until ] */
+ if (ares__buf_consume_until_charset(buf, (const unsigned char *)"]", 1,
+ ARES_TRUE) == 0) {
+ return ARES_EBADSTR;
+ }
+
+ status = ares__buf_tag_fetch_string(buf, ipaddr, sizeof(ipaddr));
+ if (status != ARES_SUCCESS) {
+ return status;
+ }
+
+ /* Skip over ] */
+ ares__buf_consume(buf, 1);
+ } else {
+ size_t offset;
+
+ /* Not in [ ], see if '.' is in first 4 characters, if it is, then its ipv4,
+ * otherwise treat as ipv6 */
+ ares__buf_tag(buf);
+
+ offset = ares__buf_consume_until_charset(buf, (const unsigned char *)".", 1,
+ ARES_TRUE);
+ ares__buf_tag_rollback(buf);
+ ares__buf_tag(buf);
+
+ if (offset > 0 && offset < 4) {
+ /* IPv4 */
+ if (ares__buf_consume_charset(buf, (const unsigned char *)"0123456789.",
+ 11) == 0) {
+ return ARES_EBADSTR;
+ }
+ } else {
+ /* IPv6 */
+ const unsigned char ipv6_charset[] = "ABCDEFabcdef0123456789.:";
+ if (ares__buf_consume_charset(buf, ipv6_charset, sizeof(ipv6_charset)) ==
+ 0) {
+ return ARES_EBADSTR;
+ }
+ }
+
+ status = ares__buf_tag_fetch_string(buf, ipaddr, sizeof(ipaddr));
+ if (status != ARES_SUCCESS) {
+ return status;
+ }
+ }
+
+ /* Convert ip address from string to network byte order */
+ sconfig->addr.family = AF_UNSPEC;
+ if (ares_dns_pton(ipaddr, &sconfig->addr, &addrlen) == NULL) {
+ return ARES_EBADSTR;
+ }
+
+ /* Pull off port */
+ if (ares__buf_begins_with(buf, (const unsigned char *)":", 1)) {
+ char portstr[6];
+
+ /* Consume : */
+ ares__buf_consume(buf, 1);
+
+ ares__buf_tag(buf);
+
+ /* Read numbers */
+ if (ares__buf_consume_charset(buf, (const unsigned char *)"0123456789",
+ 10) == 0) {
+ return ARES_EBADSTR;
+ }
+
+ status = ares__buf_tag_fetch_string(buf, portstr, sizeof(portstr));
+ if (status != ARES_SUCCESS) {
+ return status;
+ }
+
+ sconfig->udp_port = (unsigned short)atoi(portstr);
+ sconfig->tcp_port = sconfig->udp_port;
+ }
+
+ /* Pull off interface modifier */
+ if (ares__buf_begins_with(buf, (const unsigned char *)"%", 1)) {
+ const unsigned char iface_charset[] = "ABCDEFGHIJKLMNOPQRSTUVWXYZ"
+ "abcdefghijklmnopqrstuvwxyz"
+ "0123456789.-_\\:{}";
+ /* Consume % */
+ ares__buf_consume(buf, 1);
+
+ ares__buf_tag(buf);
+
+ if (ares__buf_consume_charset(buf, iface_charset, sizeof(iface_charset)) ==
+ 0) {
+ return ARES_EBADSTR;
+ }
+
+ status = ares__buf_tag_fetch_string(buf, sconfig->ll_iface,
+ sizeof(sconfig->ll_iface));
+ if (status != ARES_SUCCESS) {
+ return status;
+ }
+ }
+
+ /* Consume any trailing whitespace so we can bail out if there is something
+ * after we didn't read */
+ ares__buf_consume_whitespace(buf, ARES_TRUE);
+
+ if (ares__buf_len(buf) != 0) {
+ return ARES_EBADSTR;
+ }
+
+ return ARES_SUCCESS;
+}
+
+static ares_status_t ares__sconfig_linklocal(ares_sconfig_t *s,
+ const char *ll_iface)
+{
+ unsigned int ll_scope = 0;
+
+ if (ares_str_isnum(ll_iface)) {
+ char ifname[IF_NAMESIZE] = "";
+ ll_scope = (unsigned int)atoi(ll_iface);
+ if (ares__if_indextoname(ll_scope, ifname, sizeof(ifname)) == NULL) {
+ DEBUGF(fprintf(stderr, "Interface %s for ipv6 Link Local not found\n",
+ ll_iface));
+ return ARES_ENOTFOUND;
+ }
+ ares_strcpy(s->ll_iface, ifname, sizeof(s->ll_iface));
+ s->ll_scope = ll_scope;
+ return ARES_SUCCESS;
+ }
+
+ ll_scope = ares__if_nametoindex(ll_iface);
+ if (ll_scope == 0) {
+ DEBUGF(fprintf(stderr, "Interface %s for ipv6 Link Local not found\n",
+ ll_iface));
+ return ARES_ENOTFOUND;
+ }
+ ares_strcpy(s->ll_iface, ll_iface, sizeof(s->ll_iface));
+ s->ll_scope = ll_scope;
+ return ARES_SUCCESS;
+}
+
+ares_status_t ares__sconfig_append(ares__llist_t **sconfig,
+ const struct ares_addr *addr,
+ unsigned short udp_port,
+ unsigned short tcp_port,
+ const char *ll_iface)
+{
+ ares_sconfig_t *s;
+ ares_status_t status;
+
+ if (sconfig == NULL || addr == NULL) {
+ return ARES_EFORMERR;
+ }
+
+ /* Silently skip blacklisted IPv6 servers. */
+ if (ares_server_blacklisted(addr)) {
+ return ARES_SUCCESS;
+ }
+
+ s = ares_malloc_zero(sizeof(*s));
+ if (s == NULL) {
+ return ARES_ENOMEM;
+ }
+
+ if (*sconfig == NULL) {
+ *sconfig = ares__llist_create(ares_free);
+ if (*sconfig == NULL) {
+ status = ARES_ENOMEM;
+ goto fail;
+ }
+ }
+
+ memcpy(&s->addr, addr, sizeof(s->addr));
+ s->udp_port = udp_port;
+ s->tcp_port = tcp_port;
+
+ /* Handle link-local enumeration */
+ if (ares_strlen(ll_iface) && ares__addr_is_linklocal(&s->addr)) {
+ status = ares__sconfig_linklocal(s, ll_iface);
+ /* Silently ignore this entry */
+ if (status != ARES_SUCCESS) {
+ status = ARES_SUCCESS;
+ goto fail;
+ }
+ }
+
+ if (ares__llist_insert_last(*sconfig, s) == NULL) {
+ status = ARES_ENOMEM;
+ goto fail;
+ }
+
+ return ARES_SUCCESS;
+
+fail:
+ ares_free(s);
+
+ return status;
+}
+
+/* Add the IPv4 or IPv6 nameservers in str (separated by commas or spaces) to
+ * the servers list, updating servers and nservers as required.
+ *
+ * If a nameserver is encapsulated in [ ] it may optionally include a port
+ * suffix, e.g.:
+ * [127.0.0.1]:59591
+ *
+ * The extended format is required to support OpenBSD's resolv.conf format:
+ * https://man.openbsd.org/OpenBSD-5.1/resolv.conf.5
+ * As well as MacOS libresolv that may include a non-default port number.
+ *
+ * This will silently ignore blacklisted IPv6 nameservers as detected by
+ * ares_ipv6_server_blacklisted().
+ *
+ * Returns an error code on failure, else ARES_SUCCESS.
+ */
+ares_status_t ares__sconfig_append_fromstr(ares__llist_t **sconfig,
+ const char *str,
+ ares_bool_t ignore_invalid)
+{
+ ares_status_t status = ARES_SUCCESS;
+ ares__buf_t *buf = NULL;
+ ares__llist_t *list = NULL;
+ ares__llist_node_t *node;
+
+ /* On Windows, there may be more than one nameserver specified in the same
+ * registry key, so we parse input as a space or comma separated list.
+ */
+ buf = ares__buf_create_const((const unsigned char *)str, ares_strlen(str));
+ if (buf == NULL) {
+ status = ARES_ENOMEM;
+ goto done;
+ }
+
+ status = ares__buf_split(buf, (const unsigned char *)" ,", 2,
+ ARES_BUF_SPLIT_NONE, &list);
+ if (status != ARES_SUCCESS) {
+ goto done;
+ }
+
+ for (node = ares__llist_node_first(list); node != NULL;
+ node = ares__llist_node_next(node)) {
+ ares__buf_t *entry = ares__llist_node_val(node);
+ ares_sconfig_t s;
+
+ status = parse_nameserver(entry, &s);
+ if (status != ARES_SUCCESS) {
+ if (ignore_invalid) {
+ continue;
+ } else {
+ goto done;
+ }
+ }
+
+ status = ares__sconfig_append(sconfig, &s.addr, s.udp_port, s.tcp_port,
+ s.ll_iface);
+ if (status != ARES_SUCCESS) {
+ goto done;
+ }
+ }
+
+ status = ARES_SUCCESS;
+
+done:
+ ares__llist_destroy(list);
+ ares__buf_destroy(buf);
+ return status;
+}
+
+static unsigned short ares__sconfig_get_port(const ares_channel_t *channel,
+ const ares_sconfig_t *s,
+ ares_bool_t is_tcp)
+{
+ unsigned short port = is_tcp ? s->tcp_port : s->udp_port;
+
+ if (port == 0) {
+ port = is_tcp ? channel->tcp_port : channel->udp_port;
+ }
+
+ if (port == 0) {
+ port = 53;
+ }
+
+ return port;
+}
+
+static ares__slist_node_t *ares__server_find(ares_channel_t *channel,
+ const ares_sconfig_t *s)
+{
+ ares__slist_node_t *node;
+
+ for (node = ares__slist_node_first(channel->servers); node != NULL;
+ node = ares__slist_node_next(node)) {
+ const struct server_state *server = ares__slist_node_val(node);
+
+ if (!ares__addr_match(&server->addr, &s->addr)) {
+ continue;
+ }
+
+ if (server->tcp_port != ares__sconfig_get_port(channel, s, ARES_TRUE)) {
+ continue;
+ }
+
+ if (server->udp_port != ares__sconfig_get_port(channel, s, ARES_FALSE)) {
+ continue;
+ }
+
+ return node;
+ }
+ return NULL;
+}
+
+static ares_bool_t ares__server_isdup(const ares_channel_t *channel,
+ ares__llist_node_t *s)
+{
+ /* Scan backwards to see if this is a duplicate */
+ ares__llist_node_t *prev;
+ const ares_sconfig_t *server = ares__llist_node_val(s);
+
+ for (prev = ares__llist_node_prev(s); prev != NULL;
+ prev = ares__llist_node_prev(prev)) {
+ const ares_sconfig_t *p = ares__llist_node_val(prev);
+
+ if (!ares__addr_match(&server->addr, &p->addr)) {
+ continue;
+ }
+
+ if (ares__sconfig_get_port(channel, server, ARES_TRUE) !=
+ ares__sconfig_get_port(channel, p, ARES_TRUE)) {
+ continue;
+ }
+
+ if (ares__sconfig_get_port(channel, server, ARES_FALSE) !=
+ ares__sconfig_get_port(channel, p, ARES_FALSE)) {
+ continue;
+ }
+
+ return ARES_TRUE;
+ }
+
+ return ARES_FALSE;
+}
+
+static ares_status_t ares__server_create(ares_channel_t *channel,
+ const ares_sconfig_t *sconfig,
+ size_t idx)
+{
+ ares_status_t status;
+ struct server_state *server = ares_malloc_zero(sizeof(*server));
+
+ if (server == NULL) {
+ return ARES_ENOMEM;
+ }
+
+ server->idx = idx;
+ server->channel = channel;
+ server->udp_port = ares__sconfig_get_port(channel, sconfig, ARES_FALSE);
+ server->tcp_port = ares__sconfig_get_port(channel, sconfig, ARES_TRUE);
+ server->addr.family = sconfig->addr.family;
+
+ if (sconfig->addr.family == AF_INET) {
+ memcpy(&server->addr.addr.addr4, &sconfig->addr.addr.addr4,
+ sizeof(server->addr.addr.addr4));
+ } else if (sconfig->addr.family == AF_INET6) {
+ memcpy(&server->addr.addr.addr6, &sconfig->addr.addr.addr6,
+ sizeof(server->addr.addr.addr6));
+ }
+
+ /* Copy over link-local settings */
+ if (ares_strlen(sconfig->ll_iface)) {
+ ares_strcpy(server->ll_iface, sconfig->ll_iface, sizeof(server->ll_iface));
+ server->ll_scope = sconfig->ll_scope;
+ }
+
+ server->tcp_parser = ares__buf_create();
+ if (server->tcp_parser == NULL) {
+ status = ARES_ENOMEM;
+ goto done;
+ }
+
+ server->tcp_send = ares__buf_create();
+ if (server->tcp_send == NULL) {
+ status = ARES_ENOMEM;
+ goto done;
+ }
+
+ server->connections = ares__llist_create(NULL);
+ if (server->connections == NULL) {
+ status = ARES_ENOMEM;
+ goto done;
+ }
+
+ if (ares__slist_insert(channel->servers, server) == NULL) {
+ status = ARES_ENOMEM;
+ goto done;
+ }
+
+ status = ARES_SUCCESS;
+
+done:
+ if (status != ARES_SUCCESS) {
+ ares__destroy_server(server);
+ }
+
+ return status;
+}
+
+static ares_bool_t ares__server_in_newconfig(const struct server_state *server,
+ ares__llist_t *srvlist)
+{
+ ares__llist_node_t *node;
+ const ares_channel_t *channel = server->channel;
+
+ for (node = ares__llist_node_first(srvlist); node != NULL;
+ node = ares__llist_node_next(node)) {
+ const ares_sconfig_t *s = ares__llist_node_val(node);
+
+ if (!ares__addr_match(&server->addr, &s->addr)) {
+ continue;
+ }
+
+ if (server->tcp_port != ares__sconfig_get_port(channel, s, ARES_TRUE)) {
+ continue;
+ }
+
+ if (server->udp_port != ares__sconfig_get_port(channel, s, ARES_FALSE)) {
+ continue;
+ }
+
+ return ARES_TRUE;
+ }
+
+ return ARES_FALSE;
+}
+
+static void ares__servers_remove_stale(ares_channel_t *channel,
+ ares__llist_t *srvlist)
+{
+ ares__slist_node_t *snode = ares__slist_node_first(channel->servers);
+
+ while (snode != NULL) {
+ ares__slist_node_t *snext = ares__slist_node_next(snode);
+ const struct server_state *server = ares__slist_node_val(snode);
+ if (!ares__server_in_newconfig(server, srvlist)) {
+ /* This will clean up all server state via the destruction callback and
+ * move any queries to new servers */
+ ares__slist_node_destroy(snode);
+ }
+ snode = snext;
+ }
+}
+
+static void ares__servers_trim_single(ares_channel_t *channel)
+{
+ while (ares__slist_len(channel->servers) > 1) {
+ ares__slist_node_destroy(ares__slist_node_last(channel->servers));
+ }
+}
+
+ares_status_t ares__servers_update(ares_channel_t *channel,
+ ares__llist_t *server_list,
+ ares_bool_t user_specified)
+{
+ ares__llist_node_t *node;
+ size_t idx = 0;
+ ares_status_t status;
+
+ if (channel == NULL) {
+ return ARES_EFORMERR;
+ }
+
+ ares__channel_lock(channel);
+
+ /* NOTE: a NULL or zero entry server list is considered valid due to
+ * real-world people needing support for this for their test harnesses
+ */
+
+ /* Add new entries */
+ for (node = ares__llist_node_first(server_list); node != NULL;
+ node = ares__llist_node_next(node)) {
+ const ares_sconfig_t *sconfig = ares__llist_node_val(node);
+ ares__slist_node_t *snode;
+
+ /* Don't add duplicate servers! */
+ if (ares__server_isdup(channel, node)) {
+ continue;
+ }
+
+ snode = ares__server_find(channel, sconfig);
+ if (snode != NULL) {
+ struct server_state *server = ares__slist_node_val(snode);
+
+ /* Copy over link-local settings. Its possible some of this data has
+ * changed, maybe ... */
+ if (ares_strlen(sconfig->ll_iface)) {
+ ares_strcpy(server->ll_iface, sconfig->ll_iface,
+ sizeof(server->ll_iface));
+ server->ll_scope = sconfig->ll_scope;
+ }
+
+ if (server->idx != idx) {
+ server->idx = idx;
+ /* Index changed, reinsert node, doesn't require any memory
+ * allocations so can't fail. */
+ ares__slist_node_reinsert(snode);
+ }
+ } else {
+ status = ares__server_create(channel, sconfig, idx);
+ if (status != ARES_SUCCESS) {
+ goto done;
+ }
+ }
+
+ idx++;
+ }
+
+ /* Remove any servers that don't exist in the current configuration */
+ ares__servers_remove_stale(channel, server_list);
+
+ /* Trim to one server if ARES_FLAG_PRIMARY is set. */
+ if (channel->flags & ARES_FLAG_PRIMARY) {
+ ares__servers_trim_single(channel);
+ }
+
+ if (user_specified) {
+ /* Save servers as if they were passed in as an option */
+ channel->optmask |= ARES_OPT_SERVERS;
+ }
+
+ /* Clear any cached query results */
+ ares__qcache_flush(channel->qcache);
+
+ status = ARES_SUCCESS;
+
+done:
+ ares__channel_unlock(channel);
+ return status;
+}
+
+static ares_status_t
+ ares_addr_node_to_server_config_llist(const struct ares_addr_node *servers,
+ ares__llist_t **llist)
+{
+ const struct ares_addr_node *node;
+ ares__llist_t *s;
+
+ *llist = NULL;
+
+ s = ares__llist_create(ares_free);
+ if (s == NULL) {
+ goto fail;
+ }
+
+ for (node = servers; node != NULL; node = node->next) {
+ ares_sconfig_t *sconfig;
+
+ /* Invalid entry */
+ if (node->family != AF_INET && node->family != AF_INET6) {
+ continue;
+ }
+
+ sconfig = ares_malloc_zero(sizeof(*sconfig));
+ if (sconfig == NULL) {
+ goto fail;
+ }
+
+ sconfig->addr.family = node->family;
+ if (node->family == AF_INET) {
+ memcpy(&sconfig->addr.addr.addr4, &node->addr.addr4,
+ sizeof(sconfig->addr.addr.addr4));
+ } else if (sconfig->addr.family == AF_INET6) {
+ memcpy(&sconfig->addr.addr.addr6, &node->addr.addr6,
+ sizeof(sconfig->addr.addr.addr6));
+ }
+
+ if (ares__llist_insert_last(s, sconfig) == NULL) {
+ ares_free(sconfig);
+ goto fail;
+ }
+ }
+
+ *llist = s;
+ return ARES_SUCCESS;
+
+fail:
+ ares__llist_destroy(s);
+ return ARES_ENOMEM;
+}
+
+static ares_status_t ares_addr_port_node_to_server_config_llist(
+ const struct ares_addr_port_node *servers, ares__llist_t **llist)
+{
+ const struct ares_addr_port_node *node;
+ ares__llist_t *s;
+
+ *llist = NULL;
+
+ s = ares__llist_create(ares_free);
+ if (s == NULL) {
+ goto fail;
+ }
+
+ for (node = servers; node != NULL; node = node->next) {
+ ares_sconfig_t *sconfig;
+
+ /* Invalid entry */
+ if (node->family != AF_INET && node->family != AF_INET6) {
+ continue;
+ }
+
+ sconfig = ares_malloc_zero(sizeof(*sconfig));
+ if (sconfig == NULL) {
+ goto fail;
+ }
+
+ sconfig->addr.family = node->family;
+ if (node->family == AF_INET) {
+ memcpy(&sconfig->addr.addr.addr4, &node->addr.addr4,
+ sizeof(sconfig->addr.addr.addr4));
+ } else if (sconfig->addr.family == AF_INET6) {
+ memcpy(&sconfig->addr.addr.addr6, &node->addr.addr6,
+ sizeof(sconfig->addr.addr.addr6));
+ }
+
+ sconfig->tcp_port = (unsigned short)node->tcp_port;
+ sconfig->udp_port = (unsigned short)node->udp_port;
+
+ if (ares__llist_insert_last(s, sconfig) == NULL) {
+ ares_free(sconfig);
+ goto fail;
+ }
+ }
+
+ *llist = s;
+ return ARES_SUCCESS;
+
+fail:
+ ares__llist_destroy(s);
+ return ARES_ENOMEM;
+}
+
+ares_status_t ares_in_addr_to_server_config_llist(const struct in_addr *servers,
+ size_t nservers,
+ ares__llist_t **llist)
+{
+ size_t i;
+ ares__llist_t *s;
+
+ *llist = NULL;
+
+ s = ares__llist_create(ares_free);
+ if (s == NULL) {
+ goto fail;
+ }
+
+ for (i = 0; servers != NULL && i < nservers; i++) {
+ ares_sconfig_t *sconfig;
+
+ sconfig = ares_malloc_zero(sizeof(*sconfig));
+ if (sconfig == NULL) {
+ goto fail;
+ }
+
+ sconfig->addr.family = AF_INET;
+ memcpy(&sconfig->addr.addr.addr4, &servers[i],
+ sizeof(sconfig->addr.addr.addr4));
+
+ if (ares__llist_insert_last(s, sconfig) == NULL) {
+ goto fail;
+ }
+ }
+
+ *llist = s;
+ return ARES_SUCCESS;
+
+fail:
+ ares__llist_destroy(s);
+ return ARES_ENOMEM;
+}
+
+int ares_get_servers(ares_channel_t *channel, struct ares_addr_node **servers)
+{
+ struct ares_addr_node *srvr_head = NULL;
+ struct ares_addr_node *srvr_last = NULL;
+ struct ares_addr_node *srvr_curr;
+ ares_status_t status = ARES_SUCCESS;
+ ares__slist_node_t *node;
+
+ if (channel == NULL) {
+ return ARES_ENODATA;
+ }
+
+ ares__channel_lock(channel);
+
+ for (node = ares__slist_node_first(channel->servers); node != NULL;
+ node = ares__slist_node_next(node)) {
+ const struct server_state *server = ares__slist_node_val(node);
+
+ /* Allocate storage for this server node appending it to the list */
+ srvr_curr = ares_malloc_data(ARES_DATATYPE_ADDR_NODE);
+ if (!srvr_curr) {
+ status = ARES_ENOMEM;
+ break;
+ }
+ if (srvr_last) {
+ srvr_last->next = srvr_curr;
+ } else {
+ srvr_head = srvr_curr;
+ }
+ srvr_last = srvr_curr;
+
+ /* Fill this server node data */
+ srvr_curr->family = server->addr.family;
+ if (srvr_curr->family == AF_INET) {
+ memcpy(&srvr_curr->addr.addr4, &server->addr.addr.addr4,
+ sizeof(srvr_curr->addr.addr4));
+ } else {
+ memcpy(&srvr_curr->addr.addr6, &server->addr.addr.addr6,
+ sizeof(srvr_curr->addr.addr6));
+ }
+ }
+
+ if (status != ARES_SUCCESS) {
+ ares_free_data(srvr_head);
+ srvr_head = NULL;
+ }
+
+ *servers = srvr_head;
+
+ ares__channel_unlock(channel);
+
+ return (int)status;
+}
+
+int ares_get_servers_ports(ares_channel_t *channel,
+ struct ares_addr_port_node **servers)
+{
+ struct ares_addr_port_node *srvr_head = NULL;
+ struct ares_addr_port_node *srvr_last = NULL;
+ struct ares_addr_port_node *srvr_curr;
+ ares_status_t status = ARES_SUCCESS;
+ ares__slist_node_t *node;
+
+ if (channel == NULL) {
+ return ARES_ENODATA;
+ }
+
+ ares__channel_lock(channel);
+
+ for (node = ares__slist_node_first(channel->servers); node != NULL;
+ node = ares__slist_node_next(node)) {
+ const struct server_state *server = ares__slist_node_val(node);
+
+ /* Allocate storage for this server node appending it to the list */
+ srvr_curr = ares_malloc_data(ARES_DATATYPE_ADDR_PORT_NODE);
+ if (!srvr_curr) {
+ status = ARES_ENOMEM;
+ break;
+ }
+ if (srvr_last) {
+ srvr_last->next = srvr_curr;
+ } else {
+ srvr_head = srvr_curr;
+ }
+ srvr_last = srvr_curr;
+
+ /* Fill this server node data */
+ srvr_curr->family = server->addr.family;
+ srvr_curr->udp_port = server->udp_port;
+ srvr_curr->tcp_port = server->tcp_port;
+
+ if (srvr_curr->family == AF_INET) {
+ memcpy(&srvr_curr->addr.addr4, &server->addr.addr.addr4,
+ sizeof(srvr_curr->addr.addr4));
+ } else {
+ memcpy(&srvr_curr->addr.addr6, &server->addr.addr.addr6,
+ sizeof(srvr_curr->addr.addr6));
+ }
+ }
+
+ if (status != ARES_SUCCESS) {
+ ares_free_data(srvr_head);
+ srvr_head = NULL;
+ }
+
+ *servers = srvr_head;
+
+ ares__channel_unlock(channel);
+ return (int)status;
+}
+
+int ares_set_servers(ares_channel_t *channel,
+ const struct ares_addr_node *servers)
+{
+ ares__llist_t *slist;
+ ares_status_t status;
+
+ if (channel == NULL) {
+ return ARES_ENODATA;
+ }
+
+ status = ares_addr_node_to_server_config_llist(servers, &slist);
+ if (status != ARES_SUCCESS) {
+ return (int)status;
+ }
+
+ /* NOTE: lock is in ares__servers_update() */
+ status = ares__servers_update(channel, slist, ARES_TRUE);
+
+ ares__llist_destroy(slist);
+
+ return (int)status;
+}
+
+int ares_set_servers_ports(ares_channel_t *channel,
+ const struct ares_addr_port_node *servers)
+{
+ ares__llist_t *slist;
+ ares_status_t status;
+
+ if (channel == NULL) {
+ return ARES_ENODATA;
+ }
+
+ status = ares_addr_port_node_to_server_config_llist(servers, &slist);
+ if (status != ARES_SUCCESS) {
+ return (int)status;
+ }
+
+ /* NOTE: lock is in ares__servers_update() */
+ status = ares__servers_update(channel, slist, ARES_TRUE);
+
+ ares__llist_destroy(slist);
+
+ return (int)status;
+}
+
+/* Incoming string format: host[:port][,host[:port]]... */
+/* IPv6 addresses with ports require square brackets [fe80::1]:53 */
+static ares_status_t set_servers_csv(ares_channel_t *channel, const char *_csv)
+{
+ ares_status_t status;
+ ares__llist_t *slist = NULL;
+
+ if (channel == NULL) {
+ return ARES_ENODATA;
+ }
+
+ /* NOTE: lock is in ares__servers_update() */
+
+ if (ares_strlen(_csv) == 0) {
+ /* blank all servers */
+ return (ares_status_t)ares_set_servers_ports(channel, NULL);
+ }
+
+ status = ares__sconfig_append_fromstr(&slist, _csv, ARES_FALSE);
+ if (status != ARES_SUCCESS) {
+ ares__llist_destroy(slist);
+ return status;
+ }
+
+ /* NOTE: lock is in ares__servers_update() */
+ status = ares__servers_update(channel, slist, ARES_TRUE);
+
+ ares__llist_destroy(slist);
+
+ return status;
+}
+
+/* We'll go ahead and honor ports anyhow */
+int ares_set_servers_csv(ares_channel_t *channel, const char *_csv)
+{
+ /* NOTE: lock is in ares__servers_update() */
+ return (int)set_servers_csv(channel, _csv);
+}
+
+int ares_set_servers_ports_csv(ares_channel_t *channel, const char *_csv)
+{
+ /* NOTE: lock is in ares__servers_update() */
+ return (int)set_servers_csv(channel, _csv);
+}
+
+char *ares_get_servers_csv(ares_channel_t *channel)
+{
+ ares__buf_t *buf = NULL;
+ char *out = NULL;
+ ares__slist_node_t *node;
+
+ ares__channel_lock(channel);
+
+ buf = ares__buf_create();
+ if (buf == NULL) {
+ goto done;
+ }
+
+ for (node = ares__slist_node_first(channel->servers); node != NULL;
+ node = ares__slist_node_next(node)) {
+ ares_status_t status;
+ const struct server_state *server = ares__slist_node_val(node);
+ char addr[64];
+
+ if (ares__buf_len(buf)) {
+ status = ares__buf_append_byte(buf, ',');
+ if (status != ARES_SUCCESS) {
+ goto done;
+ }
+ }
+
+ /* ipv4addr or [ipv6addr] */
+ if (server->addr.family == AF_INET6) {
+ status = ares__buf_append_byte(buf, '[');
+ if (status != ARES_SUCCESS) {
+ goto done;
+ }
+ }
+
+ ares_inet_ntop(server->addr.family, &server->addr.addr, addr, sizeof(addr));
+
+ status = ares__buf_append_str(buf, addr);
+ if (status != ARES_SUCCESS) {
+ goto done;
+ }
+
+ if (server->addr.family == AF_INET6) {
+ status = ares__buf_append_byte(buf, ']');
+ if (status != ARES_SUCCESS) {
+ goto done;
+ }
+ }
+
+ /* :port */
+ status = ares__buf_append_byte(buf, ':');
+ if (status != ARES_SUCCESS) {
+ goto done;
+ }
+
+ status = ares__buf_append_num_dec(buf, server->udp_port, 0);
+ if (status != ARES_SUCCESS) {
+ goto done;
+ }
+
+ /* %iface */
+ if (ares_strlen(server->ll_iface)) {
+ status = ares__buf_append_byte(buf, '%');
+ if (status != ARES_SUCCESS) {
+ goto done;
+ }
+
+ status = ares__buf_append_str(buf, server->ll_iface);
+ if (status != ARES_SUCCESS) {
+ goto done;
+ }
+ }
+ }
+
+ out = ares__buf_finish_str(buf, NULL);
+ buf = NULL;
+
+done:
+ ares__channel_unlock(channel);
+ ares__buf_destroy(buf);
+ return out;
+}
diff --git a/subprojects/c-ares/src/lib/ares_version.c b/subprojects/c-ares/src/lib/ares_version.c
@@ -0,0 +1,37 @@
+/* MIT License
+ *
+ * Copyright (c) 1998 Massachusetts Institute of Technology
+ * Copyright (c) The c-ares project and its contributors
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice (including the next
+ * paragraph) shall be included in all copies or substantial portions of the
+ * Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ *
+ * SPDX-License-Identifier: MIT
+ */
+#include "ares_setup.h"
+#include "ares.h"
+
+const char *ares_version(int *version)
+{
+ if (version) {
+ *version = ARES_VERSION;
+ }
+
+ return ARES_VERSION_STR;
+}
diff --git a/subprojects/c-ares/src/lib/cares.rc b/subprojects/c-ares/src/lib/cares.rc
@@ -0,0 +1,75 @@
+/* MIT License
+ *
+ * Copyright (c) 2009 Daniel Stenberg
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice (including the next
+ * paragraph) shall be included in all copies or substantial portions of the
+ * Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ *
+ * SPDX-License-Identifier: MIT
+ */
+
+#include <winver.h>
+#include "../../include/ares_version.h"
+
+LANGUAGE 0x09,0x01
+
+#define RC_VERSION ARES_VERSION_MAJOR, ARES_VERSION_MINOR, ARES_VERSION_PATCH, 0
+
+VS_VERSION_INFO VERSIONINFO
+ FILEVERSION RC_VERSION
+ PRODUCTVERSION RC_VERSION
+ FILEFLAGSMASK 0x3fL
+#if defined(DEBUGBUILD) || defined(_DEBUG)
+ FILEFLAGS 1
+#else
+ FILEFLAGS 0
+#endif
+ FILEOS VOS__WINDOWS32
+ FILETYPE VFT_DLL
+ FILESUBTYPE 0x0L
+
+BEGIN
+ BLOCK "StringFileInfo"
+ BEGIN
+ BLOCK "040904b0"
+ BEGIN
+ VALUE "CompanyName", "The c-ares library, https://c-ares.org/\0"
+#if defined(DEBUGBUILD) || defined(_DEBUG)
+ VALUE "FileDescription", "c-ares Debug Shared Library\0"
+ VALUE "FileVersion", ARES_VERSION_STR "\0"
+ VALUE "InternalName", "c-ares\0"
+ VALUE "OriginalFilename", "caresd.dll\0"
+#else
+ VALUE "FileDescription", "c-ares Shared Library\0"
+ VALUE "FileVersion", ARES_VERSION_STR "\0"
+ VALUE "InternalName", "c-ares\0"
+ VALUE "OriginalFilename", "cares.dll\0"
+#endif
+ VALUE "ProductName", "The c-ares library\0"
+ VALUE "ProductVersion", ARES_VERSION_STR "\0"
+ VALUE "LegalCopyright", " " ARES_COPYRIGHT "\0"
+ VALUE "License", "https://c-ares.org/license.html\0"
+ END
+ END
+
+ BLOCK "VarFileInfo"
+ BEGIN
+ VALUE "Translation", 0x409, 1200
+ END
+END
diff --git a/subprojects/c-ares/src/lib/config-dos.h b/subprojects/c-ares/src/lib/config-dos.h
@@ -0,0 +1,114 @@
+#ifndef HEADER_CONFIG_DOS_H
+#define HEADER_CONFIG_DOS_H
+
+
+/* ================================================================
+ * ares/config-dos.h - Hand crafted config file for DOS
+ *
+ * Copyright (C) The c-ares project and its contributors
+ * SPDX-License-Identifier: MIT
+ * ================================================================ */
+
+#define PACKAGE "c-ares"
+
+#define HAVE_ERRNO_H 1
+#define HAVE_GETENV 1
+#define HAVE_GETTIMEOFDAY 1
+#define HAVE_IOCTLSOCKET 1
+#define HAVE_IOCTLSOCKET_FIONBIO 1
+#define HAVE_LIMITS_H 1
+#define HAVE_NET_IF_H 1
+#define HAVE_RECV 1
+#define HAVE_RECVFROM 1
+#define HAVE_SEND 1
+#define HAVE_STRDUP 1
+#define HAVE_STRICMP 1
+#define HAVE_STRUCT_IN6_ADDR 1
+#define HAVE_STRUCT_TIMEVAL 1
+#define HAVE_SYS_IOCTL_H 1
+#define HAVE_SYS_SOCKET_H 1
+#define HAVE_SYS_STAT_H 1
+#define HAVE_SYS_TYPES_H 1
+#define HAVE_TIME_H 1
+#define HAVE_UNISTD_H 1
+#define HAVE_WRITEV 1
+
+#define NEED_MALLOC_H 1
+
+/* Qualifiers for send(), recv(), recvfrom() and getnameinfo(). */
+
+#define SEND_TYPE_ARG1 int
+#define SEND_QUAL_ARG2 const
+#define SEND_TYPE_ARG2 void *
+#define SEND_TYPE_ARG3 int
+#define SEND_TYPE_ARG4 int
+#define SEND_TYPE_RETV int
+
+#define RECV_TYPE_ARG1 int
+#define RECV_TYPE_ARG2 void *
+#define RECV_TYPE_ARG3 int
+#define RECV_TYPE_ARG4 int
+#define RECV_TYPE_RETV int
+
+#define RECVFROM_TYPE_ARG1 int
+#define RECVFROM_TYPE_ARG2 void
+#define RECVFROM_TYPE_ARG3 int
+#define RECVFROM_TYPE_ARG4 int
+#define RECVFROM_TYPE_ARG5 struct sockaddr
+#define RECVFROM_TYPE_ARG6 int
+#define RECVFROM_TYPE_RETV int
+#define RECVFROM_TYPE_ARG2_IS_VOID 1
+
+#define BSD
+
+/* Target HAVE_x section */
+
+#if defined(DJGPP)
+# undef _SSIZE_T
+# include <sys/types.h> /* For 'ssize_t' */
+
+# define HAVE_STRCASECMP 1
+# define HAVE_STRNCASECMP 1
+# define HAVE_SYS_TIME_H 1
+# define HAVE_VARIADIC_MACROS_GCC 1
+
+/* Because djgpp <= 2.03 doesn't have snprintf() etc. */
+# if (DJGPP_MINOR < 4)
+# define _MPRINTF_REPLACE
+# endif
+
+#elif defined(__WATCOMC__)
+# define HAVE_STRCASECMP 1
+
+#elif defined(__HIGHC__)
+# define HAVE_SYS_TIME_H 1
+# define strerror(e) strerror_s_((e))
+#endif
+
+#ifdef WATT32
+# define HAVE_AF_INET6 1
+# define HAVE_ARPA_INET_H 1
+# define HAVE_ARPA_NAMESER_H 1
+# define HAVE_CLOSE_S 1
+# define HAVE_GETHOSTNAME 1
+# define HAVE_NETDB_H 1
+# define HAVE_NETINET_IN_H 1
+# define HAVE_NETINET_TCP_H 1
+# define HAVE_PF_INET6 1
+# define HAVE_SOCKADDR_IN6_SIN6_SCOPE_ID 1
+# define HAVE_STRUCT_ADDRINFO 1
+# define HAVE_STRUCT_IN6_ADDR 1
+# define HAVE_STRUCT_SOCKADDR_IN6 1
+# define HAVE_SYS_SOCKET_H 1
+# define HAVE_SYS_UIO_H 1
+# define NS_INADDRSZ 4
+# define HAVE_STRUCT_SOCKADDR_IN6 1
+
+# define HAVE_GETSERVBYPORT_R 1
+# define GETSERVBYPORT_R_ARGS 5
+#endif
+
+#undef word
+#undef byte
+
+#endif /* HEADER_CONFIG_DOS_H */
diff --git a/subprojects/c-ares/src/lib/config-win32.h b/subprojects/c-ares/src/lib/config-win32.h
@@ -0,0 +1,373 @@
+/* MIT License
+ *
+ * Copyright (c) 2004 Daniel Stenberg
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice (including the next
+ * paragraph) shall be included in all copies or substantial portions of the
+ * Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ *
+ * SPDX-License-Identifier: MIT
+ */
+#ifndef HEADER_CARES_CONFIG_WIN32_H
+#define HEADER_CARES_CONFIG_WIN32_H
+
+/* ================================================================ */
+/* c-ares/config-win32.h - Hand crafted config file for Windows */
+/* ================================================================ */
+
+/* ---------------------------------------------------------------- */
+/* HEADER FILES */
+/* ---------------------------------------------------------------- */
+
+/* Define if you have the <assert.h> header file. */
+#define HAVE_ASSERT_H 1
+
+/* Define if you have the <errno.h> header file. */
+#define HAVE_ERRNO_H 1
+
+/* Define if you have the <getopt.h> header file. */
+#if defined(__MINGW32__) || defined(__POCC__)
+# define HAVE_GETOPT_H 1
+#endif
+
+/* Define if you have the <limits.h> header file. */
+#define HAVE_LIMITS_H 1
+
+/* Define if you have the <process.h> header file. */
+#ifndef __SALFORDC__
+# define HAVE_PROCESS_H 1
+#endif
+
+/* Define if you have the <signal.h> header file. */
+#define HAVE_SIGNAL_H 1
+
+/* Define if you have the <sys/time.h> header file */
+/* #define HAVE_SYS_TIME_H 1 */
+
+/* Define if you have the <time.h> header file. */
+#define HAVE_TIME_H 1
+
+/* Define if you have the <unistd.h> header file. */
+#if defined(__MINGW32__) || defined(__WATCOMC__) || defined(__LCC__) || \
+ defined(__POCC__)
+# define HAVE_UNISTD_H 1
+#endif
+
+/* Define if you have the <windows.h> header file. */
+#define HAVE_WINDOWS_H 1
+
+/* Define if you have the <winsock.h> header file. */
+#define HAVE_WINSOCK_H 1
+
+/* Define if you have the <winsock2.h> header file. */
+#ifndef __SALFORDC__
+# define HAVE_WINSOCK2_H 1
+#endif
+
+/* Define if you have the <ws2tcpip.h> header file. */
+#ifndef __SALFORDC__
+# define HAVE_WS2TCPIP_H 1
+#endif
+
+/* Define if you have <iphlpapi.h> header file */
+#define HAVE_IPHLPAPI_H 1
+
+/* Define if you have <netioapi.h> header file */
+#ifndef __WATCOMC__
+# define HAVE_NETIOAPI_H 1
+#endif
+
+#define HAVE_SYS_TYPES_H 1
+#define HAVE_SYS_STAT_H 1
+
+/* If we are building with OpenWatcom, we need to specify that we have
+ * <stdint.h>. */
+#if defined(__WATCOMC__)
+# define HAVE_STDINT_H
+#endif
+
+/* ---------------------------------------------------------------- */
+/* OTHER HEADER INFO */
+/* ---------------------------------------------------------------- */
+
+/* Define if you have the ANSI C header files. */
+#define STDC_HEADERS 1
+
+/* ---------------------------------------------------------------- */
+/* FUNCTIONS */
+/* ---------------------------------------------------------------- */
+
+/* Define if you have the closesocket function. */
+#define HAVE_CLOSESOCKET 1
+
+/* Define if you have the getenv function. */
+#define HAVE_GETENV 1
+
+/* Define if you have the gethostname function. */
+#define HAVE_GETHOSTNAME 1
+
+/* Define if you have the ioctlsocket function. */
+#define HAVE_IOCTLSOCKET 1
+
+/* Define if you have a working ioctlsocket FIONBIO function. */
+#define HAVE_IOCTLSOCKET_FIONBIO 1
+
+/* Define if you have the strcasecmp function. */
+/* #define HAVE_STRCASECMP 1 */
+
+/* Define if you have the strdup function. */
+#define HAVE_STRDUP 1
+
+/* Define if you have the stricmp function. */
+#define HAVE_STRICMP 1
+
+/* Define if you have the strncasecmp function. */
+/* #define HAVE_STRNCASECMP 1 */
+
+/* Define if you have the strnicmp function. */
+#define HAVE_STRNICMP 1
+
+/* Define if you have the recv function. */
+#define HAVE_RECV 1
+
+/* Define to the type of arg 1 for recv. */
+#define RECV_TYPE_ARG1 SOCKET
+
+/* Define to the type of arg 2 for recv. */
+#define RECV_TYPE_ARG2 char *
+
+/* Define to the type of arg 3 for recv. */
+#define RECV_TYPE_ARG3 int
+
+/* Define to the type of arg 4 for recv. */
+#define RECV_TYPE_ARG4 int
+
+/* Define to the function return type for recv. */
+#define RECV_TYPE_RETV int
+
+/* Define if you have the recvfrom function. */
+#define HAVE_RECVFROM 1
+
+/* Define to the type of arg 1 for recvfrom. */
+#define RECVFROM_TYPE_ARG1 SOCKET
+
+/* Define to the type pointed by arg 2 for recvfrom. */
+#define RECVFROM_TYPE_ARG2 char
+
+/* Define to the type of arg 3 for recvfrom. */
+#define RECVFROM_TYPE_ARG3 int
+
+/* Define to the type of arg 4 for recvfrom. */
+#define RECVFROM_TYPE_ARG4 int
+
+/* Define to the type pointed by arg 5 for recvfrom. */
+#define RECVFROM_TYPE_ARG5 struct sockaddr
+
+/* Define to the type pointed by arg 6 for recvfrom. */
+#define RECVFROM_TYPE_ARG6 int
+
+/* Define to the function return type for recvfrom. */
+#define RECVFROM_TYPE_RETV int
+
+/* Define if you have the send function. */
+#define HAVE_SEND 1
+
+/* Define to the type of arg 1 for send. */
+#define SEND_TYPE_ARG1 SOCKET
+
+/* Define to the type qualifier of arg 2 for send. */
+#define SEND_QUAL_ARG2 const
+
+/* Define to the type of arg 2 for send. */
+#define SEND_TYPE_ARG2 char *
+
+/* Define to the type of arg 3 for send. */
+#define SEND_TYPE_ARG3 int
+
+/* Define to the type of arg 4 for send. */
+#define SEND_TYPE_ARG4 int
+
+/* Define to the function return type for send. */
+#define SEND_TYPE_RETV int
+
+/* Specifics for the Watt-32 tcp/ip stack. */
+#ifdef WATT32
+# define SOCKET int
+# define NS_INADDRSZ 4
+# define HAVE_ARPA_NAMESER_H 1
+# define HAVE_ARPA_INET_H 1
+# define HAVE_NETDB_H 1
+# define HAVE_NETINET_IN_H 1
+# define HAVE_SYS_SOCKET_H 1
+# define HAVE_NETINET_TCP_H 1
+# define HAVE_AF_INET6 1
+# define HAVE_PF_INET6 1
+# define HAVE_STRUCT_IN6_ADDR 1
+# define HAVE_STRUCT_SOCKADDR_IN6 1
+# undef HAVE_WINSOCK_H
+# undef HAVE_WINSOCK2_H
+# undef HAVE_WS2TCPIP_H
+#endif
+
+/* Threading support enabled */
+#define CARES_THREADS 1
+
+/* ---------------------------------------------------------------- */
+/* TYPEDEF REPLACEMENTS */
+/* ---------------------------------------------------------------- */
+
+/* ---------------------------------------------------------------- */
+/* TYPE SIZES */
+/* ---------------------------------------------------------------- */
+
+/* ---------------------------------------------------------------- */
+/* STRUCT RELATED */
+/* ---------------------------------------------------------------- */
+
+/* Define if you have struct addrinfo. */
+#define HAVE_STRUCT_ADDRINFO 1
+
+/* Define if you have struct sockaddr_storage. */
+#if !defined(__SALFORDC__) && !defined(__BORLANDC__)
+# define HAVE_STRUCT_SOCKADDR_STORAGE 1
+#endif
+
+/* Define if you have struct timeval. */
+#define HAVE_STRUCT_TIMEVAL 1
+
+/* ---------------------------------------------------------------- */
+/* COMPILER SPECIFIC */
+/* ---------------------------------------------------------------- */
+
+/* Define to avoid VS2005 complaining about portable C functions. */
+#if defined(_MSC_VER) && (_MSC_VER >= 1400)
+# define _CRT_SECURE_NO_DEPRECATE 1
+# define _CRT_NONSTDC_NO_DEPRECATE 1
+#endif
+
+/* Set the Target to Win8 */
+#if defined(_MSC_VER) && (_MSC_VER >= 1500)
+# define MSVC_MIN_TARGET 0x0602
+#endif
+
+/* MSVC default target settings */
+#if defined(_MSC_VER) && (_MSC_VER >= 1500)
+# ifndef _WIN32_WINNT
+# define _WIN32_WINNT MSVC_MIN_TARGET
+# endif
+# ifndef WINVER
+# define WINVER MSVC_MIN_TARGET
+# endif
+#endif
+
+/* When no build target is specified Pelles C 5.00 and later default build
+ target is Windows Vista. */
+#if defined(__POCC__) && (__POCC__ >= 500)
+# ifndef _WIN32_WINNT
+# define _WIN32_WINNT 0x0602
+# endif
+# ifndef WINVER
+# define WINVER 0x0602
+# endif
+#endif
+
+/* Availability of freeaddrinfo, getaddrinfo and getnameinfo functions is
+ quite convoluted, compiler dependent and even build target dependent. */
+#if defined(HAVE_WS2TCPIP_H)
+# if defined(__POCC__)
+# define HAVE_FREEADDRINFO 1
+# define HAVE_GETADDRINFO 1
+# define HAVE_GETNAMEINFO 1
+# elif defined(_WIN32_WINNT) && (_WIN32_WINNT >= 0x0501)
+# define HAVE_FREEADDRINFO 1
+# define HAVE_GETADDRINFO 1
+# define HAVE_GETNAMEINFO 1
+# elif defined(_MSC_VER) && (_MSC_VER >= 1200)
+# define HAVE_FREEADDRINFO 1
+# define HAVE_GETADDRINFO 1
+# define HAVE_GETNAMEINFO 1
+# endif
+#endif
+
+#if defined(__POCC__)
+# ifndef _MSC_VER
+# error Microsoft extensions /Ze compiler option is required
+# endif
+# ifndef __POCC__OLDNAMES
+# error Compatibility names /Go compiler option is required
+# endif
+#endif
+
+/* ---------------------------------------------------------------- */
+/* IPV6 COMPATIBILITY */
+/* ---------------------------------------------------------------- */
+
+/* Define if you have address family AF_INET6. */
+#ifdef HAVE_WINSOCK2_H
+# define HAVE_AF_INET6 1
+#endif
+
+/* Define if you have protocol family PF_INET6. */
+#ifdef HAVE_WINSOCK2_H
+# define HAVE_PF_INET6 1
+#endif
+
+/* Define if you have struct in6_addr. */
+#ifdef HAVE_WS2TCPIP_H
+# define HAVE_STRUCT_IN6_ADDR 1
+#endif
+
+/* Define if you have struct sockaddr_in6. */
+#ifdef HAVE_WS2TCPIP_H
+# define HAVE_STRUCT_SOCKADDR_IN6 1
+#endif
+
+/* Define if you have sockaddr_in6 with scopeid. */
+#ifdef HAVE_WS2TCPIP_H
+# define HAVE_STRUCT_SOCKADDR_IN6_SIN6_SCOPE_ID 1
+#endif
+
+#if defined(_WIN32_WINNT) && (_WIN32_WINNT >= 0x0600) && !defined(__WATCOMC__)
+/* Define if you have if_nametoindex() */
+# define HAVE_IF_NAMETOINDEX 1
+/* Define if you have if_indextoname() */
+# define HAVE_IF_INDEXTONAME 1
+/* Define to 1 if you have the `ConvertInterfaceIndexToLuid' function. */
+# define HAVE_CONVERTINTERFACEINDEXTOLUID 1
+/* Define to 1 if you have the `ConvertInterfaceLuidToNameA' function. */
+# define HAVE_CONVERTINTERFACELUIDTONAMEA 1
+#endif
+
+/* ---------------------------------------------------------------- */
+/* Win CE */
+/* ---------------------------------------------------------------- */
+
+/* FIXME: A proper config-win32ce.h should be created to hold these */
+
+/*
+ * System error codes for Windows CE
+ */
+
+#if defined(_WIN32_WCE) && !defined(HAVE_ERRNO_H)
+# define ENOENT ERROR_FILE_NOT_FOUND
+# define ESRCH ERROR_PATH_NOT_FOUND
+# define ENOMEM ERROR_NOT_ENOUGH_MEMORY
+# define ENOSPC ERROR_INVALID_PARAMETER
+#endif
+
+#endif /* HEADER_CARES_CONFIG_WIN32_H */
diff --git a/subprojects/c-ares/src/lib/inet_net_pton.c b/subprojects/c-ares/src/lib/inet_net_pton.c
@@ -0,0 +1,445 @@
+/*
+ * Copyright (c) 2012 by Gilles Chehade <gilles@openbsd.org>
+ * Copyright (c) 1996,1999 by Internet Software Consortium.
+ *
+ * Permission to use, copy, modify, and distribute this software for any
+ * purpose with or without fee is hereby granted, provided that the above
+ * copyright notice and this permission notice appear in all copies.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS" AND INTERNET SOFTWARE CONSORTIUM DISCLAIMS
+ * ALL WARRANTIES WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES
+ * OF MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL INTERNET SOFTWARE
+ * CONSORTIUM BE LIABLE FOR ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL
+ * DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR
+ * PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS
+ * ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS
+ * SOFTWARE.
+ *
+ * SPDX-License-Identifier: MIT
+ */
+
+#include "ares_setup.h"
+
+#ifdef HAVE_NETINET_IN_H
+# include <netinet/in.h>
+#endif
+#ifdef HAVE_ARPA_INET_H
+# include <arpa/inet.h>
+#endif
+
+#include "ares_nameser.h"
+
+#include "ares.h"
+#include "ares_ipv6.h"
+#include "ares_inet_net_pton.h"
+#include "ares_private.h"
+
+
+const struct ares_in6_addr ares_in6addr_any = { { { 0, 0, 0, 0, 0, 0, 0, 0, 0,
+ 0, 0, 0, 0, 0, 0, 0 } } };
+
+/*
+ * static int
+ * inet_net_pton_ipv4(src, dst, size)
+ * convert IPv4 network number from presentation to network format.
+ * accepts hex octets, hex strings, decimal octets, and /CIDR.
+ * "size" is in bytes and describes "dst".
+ * return:
+ * number of bits, either imputed classfully or specified with /CIDR,
+ * or -1 if some failure occurred (check errno). ENOENT means it was
+ * not an IPv4 network specification.
+ * note:
+ * network byte order assumed. this means 192.5.5.240/28 has
+ * 0b11110000 in its fourth octet.
+ * note:
+ * On Windows we store the error in the thread errno, not
+ * in the winsock error code. This is to avoid losing the
+ * actual last winsock error. So use macro ERRNO to fetch the
+ * errno this function sets when returning (-1), not SOCKERRNO.
+ * author:
+ * Paul Vixie (ISC), June 1996
+ */
+static int ares_inet_net_pton_ipv4(const char *src, unsigned char *dst,
+ size_t size)
+{
+ static const char xdigits[] = "0123456789abcdef";
+ static const char digits[] = "0123456789";
+ int n;
+ int ch;
+ int tmp = 0;
+ int dirty;
+ int bits;
+ const unsigned char *odst = dst;
+
+ ch = *src++;
+ if (ch == '0' && (src[0] == 'x' || src[0] == 'X') && ISASCII(src[1]) &&
+ ISXDIGIT(src[1])) {
+ /* Hexadecimal: Eat nybble string. */
+ if (!size) {
+ goto emsgsize;
+ }
+ dirty = 0;
+ src++; /* skip x or X. */
+ while ((ch = *src++) != '\0' && ISASCII(ch) && ISXDIGIT(ch)) {
+ if (ISUPPER(ch)) {
+ ch = tolower(ch);
+ }
+ n = (int)(strchr(xdigits, ch) - xdigits);
+ if (dirty == 0) {
+ tmp = n;
+ } else {
+ tmp = (tmp << 4) | n;
+ }
+ if (++dirty == 2) {
+ if (!size--) {
+ goto emsgsize;
+ }
+ *dst++ = (unsigned char)tmp;
+ dirty = 0;
+ }
+ }
+ if (dirty) { /* Odd trailing nybble? */
+ if (!size--) {
+ goto emsgsize;
+ }
+ *dst++ = (unsigned char)(tmp << 4);
+ }
+ } else if (ISASCII(ch) && ISDIGIT(ch)) {
+ /* Decimal: eat dotted digit string. */
+ for (;;) {
+ tmp = 0;
+ do {
+ n = (int)(strchr(digits, ch) - digits);
+ tmp *= 10;
+ tmp += n;
+ if (tmp > 255) {
+ goto enoent;
+ }
+ } while ((ch = *src++) != '\0' && ISASCII(ch) && ISDIGIT(ch));
+ if (!size--) {
+ goto emsgsize;
+ }
+ *dst++ = (unsigned char)tmp;
+ if (ch == '\0' || ch == '/') {
+ break;
+ }
+ if (ch != '.') {
+ goto enoent;
+ }
+ ch = *src++;
+ if (!ISASCII(ch) || !ISDIGIT(ch)) {
+ goto enoent;
+ }
+ }
+ } else {
+ goto enoent;
+ }
+
+ bits = -1;
+ if (ch == '/' && ISASCII(src[0]) && ISDIGIT(src[0]) && dst > odst) {
+ /* CIDR width specifier. Nothing can follow it. */
+ ch = *src++; /* Skip over the /. */
+ bits = 0;
+ do {
+ n = (int)(strchr(digits, ch) - digits);
+ bits *= 10;
+ bits += n;
+ if (bits > 32) {
+ goto enoent;
+ }
+ } while ((ch = *src++) != '\0' && ISASCII(ch) && ISDIGIT(ch));
+ if (ch != '\0') {
+ goto enoent;
+ }
+ }
+
+ /* Firey death and destruction unless we prefetched EOS. */
+ if (ch != '\0') {
+ goto enoent;
+ }
+
+ /* If nothing was written to the destination, we found no address. */
+ if (dst == odst) {
+ goto enoent; /* LCOV_EXCL_LINE: all valid paths above increment dst */
+ }
+ /* If no CIDR spec was given, infer width from net class. */
+ if (bits == -1) {
+ if (*odst >= 240) { /* Class E */
+ bits = 32;
+ } else if (*odst >= 224) { /* Class D */
+ bits = 8;
+ } else if (*odst >= 192) { /* Class C */
+ bits = 24;
+ } else if (*odst >= 128) { /* Class B */
+ bits = 16;
+ } else { /* Class A */
+ bits = 8;
+ }
+ /* If imputed mask is narrower than specified octets, widen. */
+ if (bits < ((dst - odst) * 8)) {
+ bits = (int)(dst - odst) * 8;
+ }
+ /*
+ * If there are no additional bits specified for a class D
+ * address adjust bits to 4.
+ */
+ if (bits == 8 && *odst == 224) {
+ bits = 4;
+ }
+ }
+ /* Extend network to cover the actual mask. */
+ while (bits > ((dst - odst) * 8)) {
+ if (!size--) {
+ goto emsgsize;
+ }
+ *dst++ = '\0';
+ }
+ return bits;
+
+enoent:
+ SET_ERRNO(ENOENT);
+ return -1;
+
+emsgsize:
+ SET_ERRNO(EMSGSIZE);
+ return -1;
+}
+
+static int getbits(const char *src, size_t *bitsp)
+{
+ static const char digits[] = "0123456789";
+ size_t n;
+ size_t val;
+ char ch;
+
+ val = 0;
+ n = 0;
+ while ((ch = *src++) != '\0') {
+ const char *pch;
+
+ pch = strchr(digits, ch);
+ if (pch != NULL) {
+ if (n++ != 0 && val == 0) { /* no leading zeros */
+ return 0;
+ }
+ val *= 10;
+ val += (size_t)(pch - digits);
+ if (val > 128) { /* range */
+ return 0;
+ }
+ continue;
+ }
+ return 0;
+ }
+ if (n == 0) {
+ return 0;
+ }
+ *bitsp = val;
+ return 1;
+}
+
+static int ares_inet_pton6(const char *src, unsigned char *dst)
+{
+ static const char xdigits_l[] = "0123456789abcdef";
+ static const char xdigits_u[] = "0123456789ABCDEF";
+ unsigned char tmp[NS_IN6ADDRSZ];
+ unsigned char *tp;
+ unsigned char *endp;
+ unsigned char *colonp;
+ const char *xdigits;
+ const char *curtok;
+ int ch;
+ int saw_xdigit;
+ int count_xdigit;
+ unsigned int val;
+
+ memset((tp = tmp), '\0', NS_IN6ADDRSZ);
+ endp = tp + NS_IN6ADDRSZ;
+ colonp = NULL;
+ /* Leading :: requires some special handling. */
+ if (*src == ':') {
+ if (*++src != ':') {
+ goto enoent;
+ }
+ }
+ curtok = src;
+ saw_xdigit = count_xdigit = 0;
+ val = 0;
+ while ((ch = *src++) != '\0') {
+ const char *pch;
+
+ if ((pch = strchr((xdigits = xdigits_l), ch)) == NULL) {
+ pch = strchr((xdigits = xdigits_u), ch);
+ }
+ if (pch != NULL) {
+ if (count_xdigit >= 4) {
+ goto enoent;
+ }
+ val <<= 4;
+ val |= (unsigned int)(pch - xdigits);
+ if (val > 0xffff) {
+ goto enoent;
+ }
+ saw_xdigit = 1;
+ count_xdigit++;
+ continue;
+ }
+ if (ch == ':') {
+ curtok = src;
+ if (!saw_xdigit) {
+ if (colonp) {
+ goto enoent;
+ }
+ colonp = tp;
+ continue;
+ } else if (*src == '\0') {
+ goto enoent;
+ }
+ if (tp + NS_INT16SZ > endp) {
+ goto enoent;
+ }
+ *tp++ = (unsigned char)(val >> 8) & 0xff;
+ *tp++ = (unsigned char)val & 0xff;
+ saw_xdigit = 0;
+ count_xdigit = 0;
+ val = 0;
+ continue;
+ }
+ if (ch == '.' && ((tp + NS_INADDRSZ) <= endp) &&
+ ares_inet_net_pton_ipv4(curtok, tp, NS_INADDRSZ) > 0) {
+ tp += NS_INADDRSZ;
+ saw_xdigit = 0;
+ break; /* '\0' was seen by inet_pton4(). */
+ }
+ goto enoent;
+ }
+ if (saw_xdigit) {
+ if (tp + NS_INT16SZ > endp) {
+ goto enoent;
+ }
+ *tp++ = (unsigned char)(val >> 8) & 0xff;
+ *tp++ = (unsigned char)val & 0xff;
+ }
+ if (colonp != NULL) {
+ /*
+ * Since some memmove()'s erroneously fail to handle
+ * overlapping regions, we'll do the shift by hand.
+ */
+ const int n = (int)(tp - colonp);
+ int i;
+
+ if (tp == endp) {
+ goto enoent;
+ }
+ for (i = 1; i <= n; i++) {
+ endp[-i] = colonp[n - i];
+ colonp[n - i] = 0;
+ }
+ tp = endp;
+ }
+ if (tp != endp) {
+ goto enoent;
+ }
+
+ memcpy(dst, tmp, NS_IN6ADDRSZ);
+ return 1;
+
+enoent:
+ SET_ERRNO(ENOENT);
+ return -1;
+}
+
+static int ares_inet_net_pton_ipv6(const char *src, unsigned char *dst,
+ size_t size)
+{
+ struct ares_in6_addr in6;
+ int ret;
+ size_t bits;
+ size_t bytes;
+ char buf[INET6_ADDRSTRLEN + sizeof("/128")];
+ char *sep;
+
+ if (ares_strlen(src) >= sizeof buf) {
+ SET_ERRNO(EMSGSIZE);
+ return -1;
+ }
+ ares_strcpy(buf, src, sizeof buf);
+
+ sep = strchr(buf, '/');
+ if (sep != NULL) {
+ *sep++ = '\0';
+ }
+
+ ret = ares_inet_pton6(buf, (unsigned char *)&in6);
+ if (ret != 1) {
+ return -1;
+ }
+
+ if (sep == NULL) {
+ bits = 128;
+ } else {
+ if (!getbits(sep, &bits)) {
+ SET_ERRNO(ENOENT);
+ return -1;
+ }
+ }
+
+ bytes = (bits + 7) / 8;
+ if (bytes > size) {
+ SET_ERRNO(EMSGSIZE);
+ return -1;
+ }
+ memcpy(dst, &in6, bytes);
+ return (int)bits;
+}
+
+/*
+ * int
+ * inet_net_pton(af, src, dst, size)
+ * convert network number from presentation to network format.
+ * accepts hex octets, hex strings, decimal octets, and /CIDR.
+ * "size" is in bytes and describes "dst".
+ * return:
+ * number of bits, either imputed classfully or specified with /CIDR,
+ * or -1 if some failure occurred (check errno). ENOENT means it was
+ * not a valid network specification.
+ * note:
+ * On Windows we store the error in the thread errno, not
+ * in the winsock error code. This is to avoid losing the
+ * actual last winsock error. So use macro ERRNO to fetch the
+ * errno this function sets when returning (-1), not SOCKERRNO.
+ * author:
+ * Paul Vixie (ISC), June 1996
+ */
+int ares_inet_net_pton(int af, const char *src, void *dst, size_t size)
+{
+ switch (af) {
+ case AF_INET:
+ return ares_inet_net_pton_ipv4(src, dst, size);
+ case AF_INET6:
+ return ares_inet_net_pton_ipv6(src, dst, size);
+ default:
+ SET_ERRNO(EAFNOSUPPORT);
+ return -1;
+ }
+}
+
+int ares_inet_pton(int af, const char *src, void *dst)
+{
+ int result;
+ size_t size;
+
+ if (af == AF_INET) {
+ size = sizeof(struct in_addr);
+ } else if (af == AF_INET6) {
+ size = sizeof(struct ares_in6_addr);
+ } else {
+ SET_ERRNO(EAFNOSUPPORT);
+ return -1;
+ }
+ result = ares_inet_net_pton(af, src, dst, size);
+ if (result == -1 && ERRNO == ENOENT) {
+ return 0;
+ }
+ return (result > -1) ? 1 : -1;
+}
diff --git a/subprojects/c-ares/src/lib/inet_ntop.c b/subprojects/c-ares/src/lib/inet_ntop.c
@@ -0,0 +1,216 @@
+/*
+ * Copyright (c) 2004 by Internet Systems Consortium, Inc. ("ISC")
+ * Copyright (c) 1996-1999 by Internet Software Consortium.
+ *
+ * Permission to use, copy, modify, and distribute this software for any
+ * purpose with or without fee is hereby granted, provided that the above
+ * copyright notice and this permission notice appear in all copies.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS" AND ISC DISCLAIMS ALL WARRANTIES
+ * WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
+ * MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL ISC BE LIABLE FOR
+ * ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
+ * WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
+ * ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT
+ * OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
+ *
+ * SPDX-License-Identifier: MIT
+ */
+
+#include "ares_setup.h"
+
+#ifdef HAVE_NETINET_IN_H
+# include <netinet/in.h>
+#endif
+#ifdef HAVE_ARPA_INET_H
+# include <arpa/inet.h>
+#endif
+
+#include "ares_nameser.h"
+
+#include "ares.h"
+#include "ares_ipv6.h"
+#include "ares_private.h"
+
+#ifndef HAVE_INET_NTOP
+
+/*
+ * WARNING: Don't even consider trying to compile this on a system where
+ * sizeof(int) < 4. sizeof(int) > 4 is fine; all the world's not a VAX.
+ */
+
+static const char *inet_ntop4(const unsigned char *src, char *dst, size_t size);
+static const char *inet_ntop6(const unsigned char *src, char *dst, size_t size);
+
+/* char *
+ * inet_ntop(af, src, dst, size)
+ * convert a network format address to presentation format.
+ * return:
+ * pointer to presentation format address (`dst'), or NULL (see errno).
+ * note:
+ * On Windows we store the error in the thread errno, not
+ * in the winsock error code. This is to avoid losing the
+ * actual last winsock error. So use macro ERRNO to fetch the
+ * errno this function sets when returning NULL, not SOCKERRNO.
+ * author:
+ * Paul Vixie, 1996.
+ */
+const char *ares_inet_ntop(int af, const void *src, char *dst,
+ ares_socklen_t size)
+{
+ switch (af) {
+ case AF_INET:
+ return (inet_ntop4(src, dst, (size_t)size));
+ case AF_INET6:
+ return (inet_ntop6(src, dst, (size_t)size));
+ default:
+ SET_ERRNO(EAFNOSUPPORT);
+ return (NULL);
+ }
+ /* NOTREACHED */
+}
+
+/* const char *
+ * inet_ntop4(src, dst, size)
+ * format an IPv4 address
+ * return:
+ * `dst' (as a const)
+ * notes:
+ * (1) uses no statics
+ * (2) takes a unsigned char* not an in_addr as input
+ * author:
+ * Paul Vixie, 1996.
+ */
+static const char *inet_ntop4(const unsigned char *src, char *dst, size_t size)
+{
+ static const char fmt[] = "%u.%u.%u.%u";
+ char tmp[sizeof("255.255.255.255")];
+
+ if ((size_t)snprintf(tmp, sizeof(tmp), fmt, src[0], src[1], src[2], src[3]) >=
+ size) {
+ SET_ERRNO(ENOSPC);
+ return (NULL);
+ }
+ ares_strcpy(dst, tmp, size);
+ return (dst);
+}
+
+/* const char *
+ * inet_ntop6(src, dst, size)
+ * convert IPv6 binary address into presentation (printable) format
+ * author:
+ * Paul Vixie, 1996.
+ */
+static const char *inet_ntop6(const unsigned char *src, char *dst, size_t size)
+{
+ /*
+ * Note that int32_t and int16_t need only be "at least" large enough
+ * to contain a value of the specified size. On some systems, like
+ * Crays, there is no such thing as an integer variable with 16 bits.
+ * Keep this in mind if you think this function should have been coded
+ * to use pointer overlays. All the world's not a VAX.
+ */
+ char tmp[sizeof("ffff:ffff:ffff:ffff:ffff:ffff:255.255.255.255")];
+ char *tp;
+
+ struct {
+ int base, len;
+ } best, cur;
+
+ unsigned int words[NS_IN6ADDRSZ / NS_INT16SZ];
+ int i;
+
+ /*
+ * Preprocess:
+ * Copy the input (bytewise) array into a wordwise array.
+ * Find the longest run of 0x00's in src[] for :: shorthanding.
+ */
+ memset(words, '\0', sizeof(words));
+ for (i = 0; i < NS_IN6ADDRSZ; i++) {
+ words[i / 2] |= (unsigned int)(src[i] << ((1 - (i % 2)) << 3));
+ }
+ best.base = -1;
+ best.len = 0;
+ cur.base = -1;
+ cur.len = 0;
+ for (i = 0; i < (NS_IN6ADDRSZ / NS_INT16SZ); i++) {
+ if (words[i] == 0) {
+ if (cur.base == -1) {
+ cur.base = i, cur.len = 1;
+ } else {
+ cur.len++;
+ }
+ } else {
+ if (cur.base != -1) {
+ if (best.base == -1 || cur.len > best.len) {
+ best = cur;
+ }
+ cur.base = -1;
+ }
+ }
+ }
+ if (cur.base != -1) {
+ if (best.base == -1 || cur.len > best.len) {
+ best = cur;
+ }
+ }
+ if (best.base != -1 && best.len < 2) {
+ best.base = -1;
+ }
+
+ /*
+ * Format the result.
+ */
+ tp = tmp;
+ for (i = 0; i < (NS_IN6ADDRSZ / NS_INT16SZ); i++) {
+ /* Are we inside the best run of 0x00's? */
+ if (best.base != -1 && i >= best.base && i < (best.base + best.len)) {
+ if (i == best.base) {
+ *tp++ = ':';
+ }
+ continue;
+ }
+ /* Are we following an initial run of 0x00s or any real hex? */
+ if (i != 0) {
+ *tp++ = ':';
+ }
+ /* Is this address an encapsulated IPv4? */
+ if (i == 6 && best.base == 0 &&
+ (best.len == 6 || (best.len == 7 && words[7] != 0x0001) ||
+ (best.len == 5 && words[5] == 0xffff))) {
+ if (!inet_ntop4(src + 12, tp, sizeof(tmp) - (size_t)(tp - tmp))) {
+ return (NULL);
+ }
+ tp += ares_strlen(tp);
+ break;
+ }
+ tp += snprintf(tp, sizeof(tmp) - (size_t)(tp - tmp), "%x", words[i]);
+ }
+ /* Was it a trailing run of 0x00's? */
+ if (best.base != -1 &&
+ (best.base + best.len) == (NS_IN6ADDRSZ / NS_INT16SZ)) {
+ *tp++ = ':';
+ }
+ *tp++ = '\0';
+
+ /*
+ * Check for overflow, copy, and we're done.
+ */
+ if ((size_t)(tp - tmp) > size) {
+ SET_ERRNO(ENOSPC);
+ return (NULL);
+ }
+ ares_strcpy(dst, tmp, size);
+ return (dst);
+}
+
+#else /* HAVE_INET_NTOP */
+
+const char *ares_inet_ntop(int af, const void *src, char *dst,
+ ares_socklen_t size)
+{
+ /* just relay this to the underlying function */
+ return inet_ntop(af, src, dst, size);
+}
+
+#endif /* HAVE_INET_NTOP */
diff --git a/subprojects/c-ares/src/lib/setup_once.h b/subprojects/c-ares/src/lib/setup_once.h
@@ -0,0 +1,473 @@
+/* MIT License
+ *
+ * Copyright (c) 2004 Daniel Stenberg
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice (including the next
+ * paragraph) shall be included in all copies or substantial portions of the
+ * Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ *
+ * SPDX-License-Identifier: MIT
+ */
+#ifndef __SETUP_ONCE_H
+#define __SETUP_ONCE_H
+
+
+/********************************************************************
+ * NOTICE *
+ * ======== *
+ * *
+ * Content of header files lib/setup_once.h and ares/setup_once.h *
+ * must be kept in sync. Modify the other one if you change this. *
+ * *
+ ********************************************************************/
+
+
+/*
+ * Inclusion of common header files.
+ */
+
+#include <stdio.h>
+#include <stdlib.h>
+#include <string.h>
+#include <stdarg.h>
+#include <ctype.h>
+
+#ifdef HAVE_ERRNO_H
+# include <errno.h>
+#endif
+
+#ifdef HAVE_SYS_TYPES_H
+# include <sys/types.h>
+#endif
+
+#ifdef NEED_MALLOC_H
+# include <malloc.h>
+#endif
+
+#ifdef NEED_MEMORY_H
+# include <memory.h>
+#endif
+
+#ifdef HAVE_SYS_STAT_H
+# include <sys/stat.h>
+#endif
+
+#ifdef HAVE_SYS_TIME_H
+# include <sys/time.h>
+#endif
+
+#ifdef HAVE_TIME_H
+# include <time.h>
+#endif
+
+#ifdef WIN32
+# include <io.h>
+# include <fcntl.h>
+#endif
+
+#ifdef HAVE_UNISTD_H
+# include <unistd.h>
+#endif
+
+#ifdef __hpux
+# if !defined(_XOPEN_SOURCE_EXTENDED) || defined(_KERNEL)
+# ifdef _APP32_64BIT_OFF_T
+# define OLD_APP32_64BIT_OFF_T _APP32_64BIT_OFF_T
+# undef _APP32_64BIT_OFF_T
+# else
+# undef OLD_APP32_64BIT_OFF_T
+# endif
+# endif
+#endif
+
+#ifdef HAVE_SYS_RANDOM_H
+# include <sys/random.h>
+#endif
+
+#ifdef HAVE_SYS_SOCKET_H
+# include <sys/socket.h>
+#endif
+
+#ifdef __hpux
+# if !defined(_XOPEN_SOURCE_EXTENDED) || defined(_KERNEL)
+# ifdef OLD_APP32_64BIT_OFF_T
+# define _APP32_64BIT_OFF_T OLD_APP32_64BIT_OFF_T
+# undef OLD_APP32_64BIT_OFF_T
+# endif
+# endif
+#endif
+
+
+/*
+ * Definition of timeval struct for platforms that don't have it.
+ */
+
+#ifndef HAVE_STRUCT_TIMEVAL
+struct timeval {
+ long tv_sec;
+ long tv_usec;
+};
+#endif
+
+
+/*
+ * If we have the MSG_NOSIGNAL define, make sure we use
+ * it as the fourth argument of function send()
+ */
+
+#ifdef HAVE_MSG_NOSIGNAL
+# define SEND_4TH_ARG MSG_NOSIGNAL
+#else
+# define SEND_4TH_ARG 0
+#endif
+
+
+#if defined(__minix)
+/* Minix doesn't support recv on TCP sockets */
+# define sread(x, y, z) \
+ (ares_ssize_t) \
+ read((RECV_TYPE_ARG1)(x), (RECV_TYPE_ARG2)(y), (RECV_TYPE_ARG3)(z))
+
+#elif defined(HAVE_RECV)
+/*
+ * The definitions for the return type and arguments types
+ * of functions recv() and send() belong and come from the
+ * configuration file. Do not define them in any other place.
+ *
+ * HAVE_RECV is defined if you have a function named recv()
+ * which is used to read incoming data from sockets. If your
+ * function has another name then don't define HAVE_RECV.
+ *
+ * If HAVE_RECV is defined then RECV_TYPE_ARG1, RECV_TYPE_ARG2,
+ * RECV_TYPE_ARG3, RECV_TYPE_ARG4 and RECV_TYPE_RETV must also
+ * be defined.
+ *
+ * HAVE_SEND is defined if you have a function named send()
+ * which is used to write outgoing data on a connected socket.
+ * If yours has another name then don't define HAVE_SEND.
+ *
+ * If HAVE_SEND is defined then SEND_TYPE_ARG1, SEND_QUAL_ARG2,
+ * SEND_TYPE_ARG2, SEND_TYPE_ARG3, SEND_TYPE_ARG4 and
+ * SEND_TYPE_RETV must also be defined.
+ */
+
+# if !defined(RECV_TYPE_ARG1) || !defined(RECV_TYPE_ARG2) || \
+ !defined(RECV_TYPE_ARG3) || !defined(RECV_TYPE_ARG4) || \
+ !defined(RECV_TYPE_RETV)
+/* */
+Error Missing_definition_of_return_and_arguments_types_of_recv
+/* */
+# else
+# define sread(x, y, z) \
+ (ares_ssize_t) recv((RECV_TYPE_ARG1)(x), (RECV_TYPE_ARG2)(y), \
+ (RECV_TYPE_ARG3)(z), (RECV_TYPE_ARG4)(0))
+# endif
+#else /* HAVE_RECV */
+# ifndef sread
+/* */
+Error Missing_definition_of_macro_sread
+/* */
+# endif
+#endif /* HAVE_RECV */
+
+
+#if defined(__minix)
+/* Minix doesn't support send on TCP sockets */
+# define swrite(x, y, z) \
+ (ares_ssize_t) \
+ write((SEND_TYPE_ARG1)(x), (SEND_TYPE_ARG2)(y), (SEND_TYPE_ARG3)(z))
+
+#elif defined(HAVE_SEND)
+# if !defined(SEND_TYPE_ARG1) || !defined(SEND_QUAL_ARG2) || \
+ !defined(SEND_TYPE_ARG2) || !defined(SEND_TYPE_ARG3) || \
+ !defined(SEND_TYPE_ARG4) || !defined(SEND_TYPE_RETV)
+ /* */
+ Error Missing_definition_of_return_and_arguments_types_of_send
+/* */
+# else
+# define swrite(x, y, z) \
+ (ares_ssize_t) send((SEND_TYPE_ARG1)(x), (SEND_TYPE_ARG2)(y), \
+ (SEND_TYPE_ARG3)(z), (SEND_TYPE_ARG4)(SEND_4TH_ARG))
+# endif
+#else /* HAVE_SEND */
+# ifndef swrite
+ /* */
+ Error Missing_definition_of_macro_swrite
+/* */
+# endif
+#endif /* HAVE_SEND */
+
+
+#if 0
+# if defined(HAVE_RECVFROM)
+/*
+ * Currently recvfrom is only used on udp sockets.
+ */
+# if !defined(RECVFROM_TYPE_ARG1) || !defined(RECVFROM_TYPE_ARG2) || \
+ !defined(RECVFROM_TYPE_ARG3) || !defined(RECVFROM_TYPE_ARG4) || \
+ !defined(RECVFROM_TYPE_ARG5) || !defined(RECVFROM_TYPE_ARG6) || \
+ !defined(RECVFROM_TYPE_RETV)
+ /* */
+ Error Missing_definition_of_return_and_arguments_types_of_recvfrom
+ /* */
+# else
+# define sreadfrom(s, b, bl, f, fl) \
+ (ares_ssize_t) \
+ recvfrom((RECVFROM_TYPE_ARG1)(s), (RECVFROM_TYPE_ARG2 *)(b), \
+ (RECVFROM_TYPE_ARG3)(bl), (RECVFROM_TYPE_ARG4)(0), \
+ (RECVFROM_TYPE_ARG5 *)(f), (RECVFROM_TYPE_ARG6 *)(fl))
+# endif
+# else /* HAVE_RECVFROM */
+# ifndef sreadfrom
+ /* */
+ Error Missing_definition_of_macro_sreadfrom
+ /* */
+# endif
+# endif /* HAVE_RECVFROM */
+
+
+# ifdef RECVFROM_TYPE_ARG6_IS_VOID
+# define RECVFROM_ARG6_T int
+# else
+# define RECVFROM_ARG6_T RECVFROM_TYPE_ARG6
+# endif
+#endif /* if 0 */
+
+
+/*
+ * Function-like macro definition used to close a socket.
+ */
+
+#if defined(HAVE_CLOSESOCKET)
+# define sclose(x) closesocket((x))
+#elif defined(HAVE_CLOSESOCKET_CAMEL)
+# define sclose(x) CloseSocket((x))
+#elif defined(HAVE_CLOSE_S)
+# define sclose(x) close_s((x))
+#else
+# define sclose(x) close((x))
+#endif
+
+
+/*
+ * Uppercase macro versions of ANSI/ISO is*() functions/macros which
+ * avoid negative number inputs with argument byte codes > 127.
+ */
+
+#define ISSPACE(x) (isspace((int)((unsigned char)x)))
+#define ISDIGIT(x) (isdigit((int)((unsigned char)x)))
+#define ISALNUM(x) (isalnum((int)((unsigned char)x)))
+#define ISXDIGIT(x) (isxdigit((int)((unsigned char)x)))
+#define ISGRAPH(x) (isgraph((int)((unsigned char)x)))
+#define ISALPHA(x) (isalpha((int)((unsigned char)x)))
+#define ISPRINT(x) (isprint((int)((unsigned char)x)))
+#define ISUPPER(x) (isupper((int)((unsigned char)x)))
+#define ISLOWER(x) (islower((int)((unsigned char)x)))
+#define ISASCII(x) (isascii((int)((unsigned char)x)))
+
+#define ISBLANK(x) \
+ (int)((((unsigned char)x) == ' ') || (((unsigned char)x) == '\t'))
+
+#define TOLOWER(x) (tolower((int)((unsigned char)x)))
+
+
+/*
+ * Macro WHILE_FALSE may be used to build single-iteration do-while loops,
+ * avoiding compiler warnings. Mostly intended for other macro definitions.
+ */
+
+#define WHILE_FALSE while (0)
+
+#if defined(_MSC_VER) && !defined(__POCC__)
+# undef WHILE_FALSE
+# if (_MSC_VER < 1500)
+# define WHILE_FALSE while (1, 0)
+# else
+# define WHILE_FALSE \
+ __pragma(warning(push)) __pragma(warning(disable : 4127)) while (0) \
+ __pragma(warning(pop))
+# endif
+#endif
+
+
+/*
+ * Macro used to include code only in debug builds.
+ */
+
+#ifdef DEBUGBUILD
+# define DEBUGF(x) x
+#else
+# define DEBUGF(x) \
+ do { \
+ } \
+ WHILE_FALSE
+#endif
+
+
+/*
+ * Macro used to include assertion code only in debug builds.
+ */
+
+#if defined(DEBUGBUILD) && defined(HAVE_ASSERT_H)
+# define DEBUGASSERT(x) assert(x)
+#else
+# define DEBUGASSERT(x) \
+ do { \
+ } \
+ WHILE_FALSE
+#endif
+
+
+/*
+ * Macro SOCKERRNO / SET_SOCKERRNO() returns / sets the *socket-related* errno
+ * (or equivalent) on this platform to hide platform details to code using it.
+ */
+
+#ifdef USE_WINSOCK
+# define SOCKERRNO ((int)WSAGetLastError())
+# define SET_SOCKERRNO(x) (WSASetLastError((int)(x)))
+#else
+# define SOCKERRNO (errno)
+# define SET_SOCKERRNO(x) (errno = (x))
+#endif
+
+
+/*
+ * Macro ERRNO / SET_ERRNO() returns / sets the NOT *socket-related* errno
+ * (or equivalent) on this platform to hide platform details to code using it.
+ */
+
+#if defined(WIN32) && !defined(WATT32)
+# define ERRNO ((int)GetLastError())
+# define SET_ERRNO(x) (SetLastError((DWORD)(x)))
+#else
+# define ERRNO (errno)
+# define SET_ERRNO(x) (errno = (x))
+#endif
+
+
+/*
+ * Portable error number symbolic names defined to Winsock error codes.
+ */
+
+#ifdef USE_WINSOCK
+# undef EBADF /* override definition in errno.h */
+# define EBADF WSAEBADF
+# undef EINTR /* override definition in errno.h */
+# define EINTR WSAEINTR
+# undef EINVAL /* override definition in errno.h */
+# define EINVAL WSAEINVAL
+# undef EWOULDBLOCK /* override definition in errno.h */
+# define EWOULDBLOCK WSAEWOULDBLOCK
+# undef EINPROGRESS /* override definition in errno.h */
+# define EINPROGRESS WSAEINPROGRESS
+# undef EALREADY /* override definition in errno.h */
+# define EALREADY WSAEALREADY
+# undef ENOTSOCK /* override definition in errno.h */
+# define ENOTSOCK WSAENOTSOCK
+# undef EDESTADDRREQ /* override definition in errno.h */
+# define EDESTADDRREQ WSAEDESTADDRREQ
+# undef EMSGSIZE /* override definition in errno.h */
+# define EMSGSIZE WSAEMSGSIZE
+# undef EPROTOTYPE /* override definition in errno.h */
+# define EPROTOTYPE WSAEPROTOTYPE
+# undef ENOPROTOOPT /* override definition in errno.h */
+# define ENOPROTOOPT WSAENOPROTOOPT
+# undef EPROTONOSUPPORT /* override definition in errno.h */
+# define EPROTONOSUPPORT WSAEPROTONOSUPPORT
+# define ESOCKTNOSUPPORT WSAESOCKTNOSUPPORT
+# undef EOPNOTSUPP /* override definition in errno.h */
+# define EOPNOTSUPP WSAEOPNOTSUPP
+# define EPFNOSUPPORT WSAEPFNOSUPPORT
+# undef EAFNOSUPPORT /* override definition in errno.h */
+# define EAFNOSUPPORT WSAEAFNOSUPPORT
+# undef EADDRINUSE /* override definition in errno.h */
+# define EADDRINUSE WSAEADDRINUSE
+# undef EADDRNOTAVAIL /* override definition in errno.h */
+# define EADDRNOTAVAIL WSAEADDRNOTAVAIL
+# undef ENETDOWN /* override definition in errno.h */
+# define ENETDOWN WSAENETDOWN
+# undef ENETUNREACH /* override definition in errno.h */
+# define ENETUNREACH WSAENETUNREACH
+# undef ENETRESET /* override definition in errno.h */
+# define ENETRESET WSAENETRESET
+# undef ECONNABORTED /* override definition in errno.h */
+# define ECONNABORTED WSAECONNABORTED
+# undef ECONNRESET /* override definition in errno.h */
+# define ECONNRESET WSAECONNRESET
+# undef ENOBUFS /* override definition in errno.h */
+# define ENOBUFS WSAENOBUFS
+# undef EISCONN /* override definition in errno.h */
+# define EISCONN WSAEISCONN
+# undef ENOTCONN /* override definition in errno.h */
+# define ENOTCONN WSAENOTCONN
+# define ESHUTDOWN WSAESHUTDOWN
+# define ETOOMANYREFS WSAETOOMANYREFS
+# undef ETIMEDOUT /* override definition in errno.h */
+# define ETIMEDOUT WSAETIMEDOUT
+# undef ECONNREFUSED /* override definition in errno.h */
+# define ECONNREFUSED WSAECONNREFUSED
+# undef ELOOP /* override definition in errno.h */
+# define ELOOP WSAELOOP
+# ifndef ENAMETOOLONG /* possible previous definition in errno.h */
+# define ENAMETOOLONG WSAENAMETOOLONG
+# endif
+# define EHOSTDOWN WSAEHOSTDOWN
+# undef EHOSTUNREACH /* override definition in errno.h */
+# define EHOSTUNREACH WSAEHOSTUNREACH
+# ifndef ENOTEMPTY /* possible previous definition in errno.h */
+# define ENOTEMPTY WSAENOTEMPTY
+# endif
+# define EPROCLIM WSAEPROCLIM
+# define EUSERS WSAEUSERS
+# define EDQUOT WSAEDQUOT
+# define ESTALE WSAESTALE
+# define EREMOTE WSAEREMOTE
+#endif
+
+
+/*
+ * Actually use __32_getpwuid() on 64-bit VMS builds for getpwuid()
+ */
+
+#if defined(__VMS) && defined(__INITIAL_POINTER_SIZE) && \
+ (__INITIAL_POINTER_SIZE == 64)
+# define getpwuid __32_getpwuid
+#endif
+
+
+/*
+ * Macro argv_item_t hides platform details to code using it.
+ */
+
+#ifdef __VMS
+# define argv_item_t __char_ptr32
+#else
+# define argv_item_t char *
+#endif
+
+
+/*
+ * We use this ZERO_NULL to avoid picky compiler warnings,
+ * when assigning a NULL pointer to a function pointer var.
+ */
+
+#define ZERO_NULL 0
+
+
+#endif /* __SETUP_ONCE_H */
diff --git a/subprojects/c-ares/src/lib/windows_port.c b/subprojects/c-ares/src/lib/windows_port.c
@@ -0,0 +1,29 @@
+/**********************************************************************
+ *
+ * Copyright (c) 1998 Massachusetts Institute of Technology
+ * Copyright (C) Daniel Stenberg
+ *
+ * SPDX-License-Identifier: MIT
+ *
+ */
+#include "ares_setup.h"
+
+
+/* only do the following on windows
+ */
+#if (defined(WIN32) || defined(WATT32)) && !defined(MSDOS)
+
+# ifdef __WATCOMC__
+/*
+ * Watcom needs a DllMain() in order to initialise the clib startup code.
+ */
+BOOL WINAPI DllMain(HINSTANCE hnd, DWORD reason, LPVOID reserved)
+{
+ (void)hnd;
+ (void)reason;
+ (void)reserved;
+ return (TRUE);
+}
+# endif
+
+#endif /* WIN32 builds only */
diff --git a/subprojects/c-ares/src/tools/CMakeLists.txt b/subprojects/c-ares/src/tools/CMakeLists.txt
@@ -0,0 +1,48 @@
+# Copyright (C) The c-ares project and its contributors
+# SPDX-License-Identifier: MIT
+IF (CARES_BUILD_TOOLS)
+ # Transform Makefile.inc
+ transform_makefile_inc("Makefile.inc" "${PROJECT_BINARY_DIR}/src/tools/Makefile.inc.cmake")
+ include(${PROJECT_BINARY_DIR}/src/tools/Makefile.inc.cmake)
+
+ # Build ahost
+ ADD_EXECUTABLE (ahost ahost.c ${SAMPLESOURCES})
+ TARGET_INCLUDE_DIRECTORIES (ahost
+ PUBLIC "$<BUILD_INTERFACE:${PROJECT_BINARY_DIR}>"
+ "$<BUILD_INTERFACE:${PROJECT_SOURCE_DIR}>"
+ "$<BUILD_INTERFACE:${PROJECT_SOURCE_DIR}/src/lib>"
+ "$<BUILD_INTERFACE:${CARES_TOPLEVEL_DIR}/include>"
+ "$<INSTALL_INTERFACE:${CMAKE_INSTALL_INCLUDEDIR}>"
+ PRIVATE "${CMAKE_CURRENT_SOURCE_DIR}"
+ )
+ SET_TARGET_PROPERTIES (ahost PROPERTIES
+ C_STANDARD 90
+ )
+
+ TARGET_COMPILE_DEFINITIONS (ahost PRIVATE HAVE_CONFIG_H=1)
+ TARGET_LINK_LIBRARIES (ahost PRIVATE ${PROJECT_NAME})
+ IF (CARES_INSTALL)
+ INSTALL (TARGETS ahost COMPONENT Tools ${TARGETS_INST_DEST})
+ ENDIF ()
+
+
+ # Build adig
+ ADD_EXECUTABLE (adig adig.c ${SAMPLESOURCES})
+ TARGET_INCLUDE_DIRECTORIES (adig
+ PUBLIC "$<BUILD_INTERFACE:${PROJECT_BINARY_DIR}>"
+ "$<BUILD_INTERFACE:${PROJECT_SOURCE_DIR}>"
+ "$<BUILD_INTERFACE:${PROJECT_SOURCE_DIR}/src/lib>"
+ "$<BUILD_INTERFACE:${CARES_TOPLEVEL_DIR}/include>"
+ "$<INSTALL_INTERFACE:${CMAKE_INSTALL_INCLUDEDIR}>"
+ PRIVATE "${CMAKE_CURRENT_SOURCE_DIR}"
+ )
+ SET_TARGET_PROPERTIES (adig PROPERTIES
+ C_STANDARD 90
+ )
+
+ TARGET_COMPILE_DEFINITIONS (adig PRIVATE HAVE_CONFIG_H=1)
+ TARGET_LINK_LIBRARIES (adig PRIVATE ${PROJECT_NAME})
+ IF (CARES_INSTALL)
+ INSTALL (TARGETS adig COMPONENT Tools ${TARGETS_INST_DEST})
+ ENDIF ()
+ENDIF ()
diff --git a/subprojects/c-ares/src/tools/Makefile.am b/subprojects/c-ares/src/tools/Makefile.am
@@ -0,0 +1,32 @@
+# Copyright (C) The c-ares project and its contributors
+# SPDX-License-Identifier: MIT
+AUTOMAKE_OPTIONS = foreign subdir-objects nostdinc 1.9.6
+PROGS = ahost adig
+
+EXTRA_DIST = CMakeLists.txt Makefile.inc
+
+noinst_PROGRAMS =$(PROGS)
+
+# Specify our include paths here, and do it relative to $(top_srcdir) and
+# $(top_builddir), to ensure that these paths which belong to the library
+# being currently built and tested are searched before the library which
+# might possibly already be installed in the system.
+
+AM_CPPFLAGS = -I$(top_builddir)/include \
+ -I$(top_builddir)/src/lib \
+ -I$(top_srcdir)/include \
+ -I$(top_srcdir)/src/lib
+
+include Makefile.inc
+
+# We're not interested in code coverage of the test apps themselves, but need
+# to link with gcov if building with code coverage enabled
+LDADD = $(top_builddir)/src/lib/libcares.la $(CODE_COVERAGE_LIBS)
+
+ahost_SOURCES = ahost.c $(SAMPLESOURCES) $(SAMPLEHEADERS)
+ahost_CFLAGS = $(AM_CFLAGS)
+ahost_CPPFLAGS = $(AM_CPPFLAGS)
+
+adig_SOURCES = adig.c $(SAMPLESOURCES) $(SAMPLEHEADERS)
+adig_CFLAGS = $(AM_CFLAGS)
+adig_CPPFLAGS = $(AM_CPPFLAGS)
diff --git a/subprojects/c-ares/src/tools/Makefile.inc b/subprojects/c-ares/src/tools/Makefile.inc
@@ -0,0 +1,7 @@
+# Copyright (C) The c-ares project and its contributors
+# SPDX-License-Identifier: MIT
+SAMPLESOURCES = ares_getopt.c \
+ ../lib/ares_strcasecmp.c
+
+SAMPLEHEADERS = ares_getopt.h \
+ ../lib/ares_strcasecmp.h
diff --git a/subprojects/c-ares/src/tools/acountry.c b/subprojects/c-ares/src/tools/acountry.c
@@ -0,0 +1,670 @@
+/* MIT License
+ *
+ * Copyright (c) G. Vanem
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice (including the next
+ * paragraph) shall be included in all copies or substantial portions of the
+ * Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ *
+ * SPDX-License-Identifier: MIT
+ */
+
+/* NOTE: As of late 2022, nerd.dk has been down, and is still down as of
+ * 10/2023. As there is no similar service. This file remains for historic
+ * purposes. It is no longer built or tested.
+ */
+
+/*
+ *
+ * IP-address/hostname to country converter.
+ *
+ * Problem; you want to know where IP a.b.c.d is located.
+ *
+ * Use ares_gethostbyname ("d.c.b.a.zz.countries.nerd.dk")
+ * and get the CNAME (host->h_name). Result will be:
+ * CNAME = zz<CC>.countries.nerd.dk with address 127.0.x.y (ver 1) or
+ * CNAME = <a.b.c.d>.zz.countries.nerd.dk with address 127.0.x.y (ver 2)
+ *
+ * The 2 letter country code is in <CC> and the ISO-3166 country
+ * number is in x.y (number = x*256 + y). Version 2 of the protocol is missing
+ * the <CC> number.
+ *
+ * Ref: http://countries.nerd.dk/more.html
+ *
+ * NB! This program may not be big-endian aware.
+ *
+ */
+
+#include "ares_setup.h"
+
+#ifdef HAVE_STRINGS_H
+# include <strings.h>
+#endif
+
+#if defined(WIN32) && !defined(WATT32)
+# include <winsock.h>
+#else
+# include <arpa/inet.h>
+# include <netinet/in.h>
+# include <netdb.h>
+#endif
+
+#include "ares.h"
+#include "ares_getopt.h"
+
+#ifndef HAVE_STRDUP
+# include "ares_strdup.h"
+# define strdup(ptr) ares_strdup(ptr)
+#endif
+
+#ifndef HAVE_STRCASECMP
+# include "ares_strcasecmp.h"
+# define strcasecmp(p1, p2) ares_strcasecmp(p1, p2)
+#endif
+
+#ifndef HAVE_STRNCASECMP
+# include "ares_strcasecmp.h"
+# define strncasecmp(p1, p2, n) ares_strncasecmp(p1, p2, n)
+#endif
+
+#ifndef INADDR_NONE
+# define INADDR_NONE 0xffffffff
+#endif
+
+/* By using a double cast, we can get rid of the bogus warning of
+ * warning: cast from 'const struct sockaddr *' to 'const struct sockaddr_in6 *'
+ * increases required alignment from 1 to 4 [-Wcast-align]
+ */
+#define CARES_INADDR_CAST(type, var) ((type)((void *)var))
+
+static const char *usage = "acountry [-?hdv] {host|addr} ...\n";
+static const char nerd_fmt[] = "%u.%u.%u.%u.zz.countries.nerd.dk";
+static const char *nerd_ver1 = nerd_fmt + 14; /* .countries.nerd.dk */
+static const char *nerd_ver2 = nerd_fmt + 11; /* .zz.countries.nerd.dk */
+static int verbose = 0;
+
+#define TRACE(fmt) \
+ do { \
+ if (verbose > 0) \
+ printf fmt; \
+ } \
+ WHILE_FALSE
+
+static void wait_ares(ares_channel_t *channel);
+static void callback(void *arg, int status, int timeouts, struct hostent *host);
+static void callback2(void *arg, int status, int timeouts,
+ struct hostent *host);
+static void find_country_from_cname(const char *cname, struct in_addr addr);
+static void print_help_info_acountry(void);
+
+static void Abort(const char *fmt, ...)
+{
+ va_list args;
+ va_start(args, fmt);
+ vfprintf(stderr, fmt, args);
+ va_end(args);
+ exit(1);
+}
+
+int main(int argc, char **argv)
+{
+ ares_channel_t *channel;
+ int ch, status;
+
+#if defined(WIN32) && !defined(WATT32)
+ WORD wVersionRequested = MAKEWORD(USE_WINSOCK, USE_WINSOCK);
+ WSADATA wsaData;
+ WSAStartup(wVersionRequested, &wsaData);
+#endif
+
+ status = ares_library_init(ARES_LIB_INIT_ALL);
+ if (status != ARES_SUCCESS) {
+ fprintf(stderr, "ares_library_init: %s\n", ares_strerror(status));
+ return 1;
+ }
+
+ while ((ch = ares_getopt(argc, argv, "dvh?")) != -1) {
+ switch (ch) {
+ case 'd':
+#ifdef WATT32
+ dbug_init();
+#endif
+ break;
+ case 'v':
+ verbose++;
+ break;
+ case 'h':
+ print_help_info_acountry();
+ break;
+ case '?':
+ print_help_info_acountry();
+ break;
+ default:
+ Abort(usage);
+ }
+ }
+
+ argc -= optind;
+ argv += optind;
+ if (argc < 1) {
+ Abort(usage);
+ }
+
+ status = ares_init(&channel);
+ if (status != ARES_SUCCESS) {
+ fprintf(stderr, "ares_init: %s\n", ares_strerror(status));
+ return 1;
+ }
+
+ /* Initiate the queries, one per command-line argument. */
+ for (; *argv; argv++) {
+ struct in_addr addr;
+ char *buf;
+
+ /* If this fails, assume '*argv' is a host-name that
+ * must be resolved first
+ */
+ if (ares_inet_pton(AF_INET, *argv, &addr) != 1) {
+ ares_gethostbyname(channel, *argv, AF_INET, callback2, &addr);
+ wait_ares(channel);
+ if (addr.s_addr == INADDR_NONE) {
+ printf("Failed to lookup %s\n", *argv);
+ continue;
+ }
+ }
+
+ buf = malloc(100);
+ snprintf(buf, 100, nerd_fmt, (unsigned int)(addr.s_addr >> 24),
+ (unsigned int)((addr.s_addr >> 16) & 255),
+ (unsigned int)((addr.s_addr >> 8) & 255),
+ (unsigned int)(addr.s_addr & 255));
+ TRACE(("Looking up %s...", buf));
+ fflush(stdout);
+ ares_gethostbyname(channel, buf, AF_INET, callback, buf);
+ }
+
+ wait_ares(channel);
+ ares_destroy(channel);
+
+ ares_library_cleanup();
+
+#if defined(WIN32) && !defined(WATT32)
+ WSACleanup();
+#endif
+
+ return 0;
+}
+
+/*
+ * Wait for the queries to complete.
+ */
+static void wait_ares(ares_channel_t *channel)
+{
+ for (;;) {
+ struct timeval *tvp, tv;
+ fd_set read_fds, write_fds;
+ int nfds;
+
+ FD_ZERO(&read_fds);
+ FD_ZERO(&write_fds);
+ nfds = ares_fds(channel, &read_fds, &write_fds);
+ if (nfds == 0) {
+ break;
+ }
+ tvp = ares_timeout(channel, NULL, &tv);
+ if (tvp == NULL) {
+ break;
+ }
+ nfds = select(nfds, &read_fds, &write_fds, NULL, tvp);
+ if (nfds < 0) {
+ continue;
+ }
+ ares_process(channel, &read_fds, &write_fds);
+ }
+}
+
+/*
+ * This is the callback used when we have the IP-address of interest.
+ * Extract the CNAME and figure out the country-code from it.
+ */
+static void callback(void *arg, int status, int timeouts, struct hostent *host)
+{
+ const char *name = (const char *)arg;
+ const char *cname;
+ char buf[20];
+
+ (void)timeouts;
+
+ if (!host || status != ARES_SUCCESS) {
+ printf("Failed to lookup %s: %s\n", name, ares_strerror(status));
+ free(arg);
+ return;
+ }
+
+ TRACE(("\nFound address %s, name %s\n",
+ ares_inet_ntop(AF_INET, (const char *)host->h_addr, buf, sizeof(buf)),
+ host->h_name));
+
+ cname = host->h_name; /* CNAME gets put here */
+ if (!cname) {
+ printf("Failed to get CNAME for %s\n", name);
+ } else {
+ find_country_from_cname(
+ cname, *(CARES_INADDR_CAST(struct in_addr *, host->h_addr)));
+ }
+ free(arg);
+}
+
+/*
+ * This is the callback used to obtain the IP-address of the host of interest.
+ */
+static void callback2(void *arg, int status, int timeouts, struct hostent *host)
+{
+ struct in_addr *addr = (struct in_addr *)arg;
+
+ (void)timeouts;
+ if (!host || status != ARES_SUCCESS) {
+ memset(addr, INADDR_NONE, sizeof(*addr));
+ } else {
+ memcpy(addr, host->h_addr, sizeof(*addr));
+ }
+}
+
+struct search_list {
+ int country_number; /* ISO-3166 country number */
+ char short_name[3]; /* A2 short country code */
+ const char *long_name; /* normal country name */
+};
+
+static const struct search_list *
+ list_lookup(int number, const struct search_list *list, int num)
+{
+ while (num > 0 && list->long_name) {
+ if (list->country_number == number) {
+ return (list);
+ }
+ num--;
+ list++;
+ }
+ return (NULL);
+}
+
+/*
+ * Ref: https://en.wikipedia.org/wiki/ISO_3166-1
+ */
+static const struct search_list country_list[] = {
+ {4, "af", "Afghanistan" },
+ { 248, "ax", "Åland Island" },
+ { 8, "al", "Albania" },
+ { 12, "dz", "Algeria" },
+ { 16, "as", "American Samoa" },
+ { 20, "ad", "Andorra" },
+ { 24, "ao", "Angola" },
+ { 660, "ai", "Anguilla" },
+ { 10, "aq", "Antarctica" },
+ { 28, "ag", "Antigua & Barbuda" },
+ { 32, "ar", "Argentina" },
+ { 51, "am", "Armenia" },
+ { 533, "aw", "Aruba" },
+ { 36, "au", "Australia" },
+ { 40, "at", "Austria" },
+ { 31, "az", "Azerbaijan" },
+ { 44, "bs", "Bahamas" },
+ { 48, "bh", "Bahrain" },
+ { 50, "bd", "Bangladesh" },
+ { 52, "bb", "Barbados" },
+ { 112, "by", "Belarus" },
+ { 56, "be", "Belgium" },
+ { 84, "bz", "Belize" },
+ { 204, "bj", "Benin" },
+ { 60, "bm", "Bermuda" },
+ { 64, "bt", "Bhutan" },
+ { 68, "bo", "Bolivia" },
+ { 535, "bq", "Bonaire, Sint Eustatius and Saba" }, /* Formerly 'Bonaire' /
+ 'Netherlands Antilles' */
+ { 70, "ba", "Bosnia & Herzegovina" },
+ { 72, "bw", "Botswana" },
+ { 74, "bv", "Bouvet Island" },
+ { 76, "br", "Brazil" },
+ { 86, "io", "British Indian Ocean Territory" },
+ { 96, "bn", "Brunei Darussalam" },
+ { 100, "bg", "Bulgaria" },
+ { 854, "bf", "Burkina Faso" },
+ { 108, "bi", "Burundi" },
+ { 116, "kh", "Cambodia" },
+ { 120, "cm", "Cameroon" },
+ { 124, "ca", "Canada" },
+ { 132, "cv", "Cape Verde" },
+ { 136, "ky", "Cayman Islands" },
+ { 140, "cf", "Central African Republic" },
+ { 148, "td", "Chad" },
+ { 152, "cl", "Chile" },
+ { 156, "cn", "China" },
+ { 162, "cx", "Christmas Island" },
+ { 166, "cc", "Cocos Islands" },
+ { 170, "co", "Colombia" },
+ { 174, "km", "Comoros" },
+ { 178, "cg", "Congo" },
+ { 180, "cd", "Congo" },
+ { 184, "ck", "Cook Islands" },
+ { 188, "cr", "Costa Rica" },
+ { 384, "ci", "Cote d'Ivoire" },
+ { 191, "hr", "Croatia" },
+ { 192, "cu", "Cuba" },
+ { 531, "cw", "Curaçao" },
+ { 196, "cy", "Cyprus" },
+ { 203, "cz", "Czech Republic" },
+ { 208, "dk", "Denmark" },
+ { 262, "dj", "Djibouti" },
+ { 212, "dm", "Dominica" },
+ { 214, "do", "Dominican Republic" },
+ { 218, "ec", "Ecuador" },
+ { 818, "eg", "Egypt" },
+ { 222, "sv", "El Salvador" },
+ { 226, "gq", "Equatorial Guinea" },
+ { 232, "er", "Eritrea" },
+ { 233, "ee", "Estonia" },
+ { 748, "sz", "Eswatini" }, /* Formerly Swaziland */
+ { 231, "et", "Ethiopia" },
+ { 65281, "eu", "European Union" }, /* 127.0.255.1 */
+ { 238, "fk", "Falkland Islands" },
+ { 234, "fo", "Faroe Islands" },
+ { 242, "fj", "Fiji" },
+ { 246, "fi", "Finland" },
+ { 250, "fr", "France" },
+ { 249, "fx", "France, Metropolitan" },
+ { 254, "gf", "French Guiana" },
+ { 258, "pf", "French Polynesia" },
+ { 260, "tf", "French Southern Territories" },
+ { 266, "ga", "Gabon" },
+ { 270, "gm", "Gambia" },
+ { 268, "ge", "Georgia" },
+ { 276, "de", "Germany" },
+ { 288, "gh", "Ghana" },
+ { 292, "gi", "Gibraltar" },
+ { 300, "gr", "Greece" },
+ { 304, "gl", "Greenland" },
+ { 308, "gd", "Grenada" },
+ { 312, "gp", "Guadeloupe" },
+ { 316, "gu", "Guam" },
+ { 320, "gt", "Guatemala" },
+ { 831, "gg", "Guernsey" },
+ { 324, "gn", "Guinea" },
+ { 624, "gw", "Guinea-Bissau" },
+ { 328, "gy", "Guyana" },
+ { 332, "ht", "Haiti" },
+ { 334, "hm", "Heard & Mc Donald Islands" },
+ { 336, "va", "Holy See" }, /* Vatican City */
+ { 340, "hn", "Honduras" },
+ { 344, "hk", "Hong kong" },
+ { 348, "hu", "Hungary" },
+ { 352, "is", "Iceland" },
+ { 356, "in", "India" },
+ { 360, "id", "Indonesia" },
+ { 364, "ir", "Iran" },
+ { 368, "iq", "Iraq" },
+ { 372, "ie", "Ireland" },
+ { 833, "im", "Isle of Man" },
+ { 376, "il", "Israel" },
+ { 380, "it", "Italy" },
+ { 388, "jm", "Jamaica" },
+ { 392, "jp", "Japan" },
+ { 832, "je", "Jersey" },
+ { 400, "jo", "Jordan" },
+ { 398, "kz", "Kazakhstan" },
+ { 404, "ke", "Kenya" },
+ { 296, "ki", "Kiribati" },
+ { 408, "kp", "Korea (north)" },
+ { 410, "kr", "Korea (south)" },
+ { 0, "xk", "Kosovo" }, /* https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2 */
+ { 414, "kw", "Kuwait" },
+ { 417, "kg", "Kyrgyzstan" },
+ { 418, "la", "Laos" },
+ { 428, "lv", "Latvia" },
+ { 422, "lb", "Lebanon" },
+ { 426, "ls", "Lesotho" },
+ { 430, "lr", "Liberia" },
+ { 434, "ly", "Libya" },
+ { 438, "li", "Liechtenstein" },
+ { 440, "lt", "Lithuania" },
+ { 442, "lu", "Luxembourg" },
+ { 446, "mo", "Macao" },
+ { 450, "mg", "Madagascar" },
+ { 454, "mw", "Malawi" },
+ { 458, "my", "Malaysia" },
+ { 462, "mv", "Maldives" },
+ { 466, "ml", "Mali" },
+ { 470, "mt", "Malta" },
+ { 584, "mh", "Marshall Islands" },
+ { 474, "mq", "Martinique" },
+ { 478, "mr", "Mauritania" },
+ { 480, "mu", "Mauritius" },
+ { 175, "yt", "Mayotte" },
+ { 484, "mx", "Mexico" },
+ { 583, "fm", "Micronesia" },
+ { 498, "md", "Moldova" },
+ { 492, "mc", "Monaco" },
+ { 496, "mn", "Mongolia" },
+ { 499, "me", "Montenegro" },
+ { 500, "ms", "Montserrat" },
+ { 504, "ma", "Morocco" },
+ { 508, "mz", "Mozambique" },
+ { 104, "mm", "Myanmar" },
+ { 516, "na", "Namibia" },
+ { 520, "nr", "Nauru" },
+ { 524, "np", "Nepal" },
+ { 528, "nl", "Netherlands" },
+ { 540, "nc", "New Caledonia" },
+ { 554, "nz", "New Zealand" },
+ { 558, "ni", "Nicaragua" },
+ { 562, "ne", "Niger" },
+ { 566, "ng", "Nigeria" },
+ { 570, "nu", "Niue" },
+ { 574, "nf", "Norfolk Island" },
+ { 807, "mk", "North Macedonia" }, /* 'Macedonia' until February 2019 */
+ { 580, "mp", "Northern Mariana Islands" },
+ { 578, "no", "Norway" },
+ { 512, "om", "Oman" },
+ { 586, "pk", "Pakistan" },
+ { 585, "pw", "Palau" },
+ { 275, "ps", "Palestinian Territory" },
+ { 591, "pa", "Panama" },
+ { 598, "pg", "Papua New Guinea" },
+ { 600, "py", "Paraguay" },
+ { 604, "pe", "Peru" },
+ { 608, "ph", "Philippines" },
+ { 612, "pn", "Pitcairn" },
+ { 616, "pl", "Poland" },
+ { 620, "pt", "Portugal" },
+ { 630, "pr", "Puerto Rico" },
+ { 634, "qa", "Qatar" },
+ { 638, "re", "Reunion" },
+ { 642, "ro", "Romania" },
+ { 643, "ru", "Russian Federation" },
+ { 646, "rw", "Rwanda" },
+ { 0, "bl",
+ "Saint Barthélemy" }, /* https://en.wikipedia.org/wiki/ISO_3166-2:BL */
+ { 659, "kn", "Saint Kitts & Nevis" },
+ { 662, "lc", "Saint Lucia" },
+ { 663, "mf", "Saint Martin" },
+ { 670, "vc", "Saint Vincent" },
+ { 882, "ws", "Samoa" },
+ { 674, "sm", "San Marino" },
+ { 678, "st", "Sao Tome & Principe" },
+ { 682, "sa", "Saudi Arabia" },
+ { 686, "sn", "Senegal" },
+ { 688, "rs", "Serbia" },
+ { 690, "sc", "Seychelles" },
+ { 694, "sl", "Sierra Leone" },
+ { 702, "sg", "Singapore" },
+ { 534, "sx", "Sint Maarten" },
+ { 703, "sk", "Slovakia" },
+ { 705, "si", "Slovenia" },
+ { 90, "sb", "Solomon Islands" },
+ { 706, "so", "Somalia" },
+ { 710, "za", "South Africa" },
+ { 239, "gs", "South Georgia & South Sandwich Is." },
+ { 728, "ss", "South Sudan" },
+ { 724, "es", "Spain" },
+ { 144, "lk", "Sri Lanka" },
+ { 654, "sh", "St. Helena" },
+ { 666, "pm", "St. Pierre & Miquelon" },
+ { 736, "sd", "Sudan" },
+ { 740, "sr", "Suriname" },
+ { 744, "sj", "Svalbard & Jan Mayen Islands" },
+ { 752, "se", "Sweden" },
+ { 756, "ch", "Switzerland" },
+ { 760, "sy", "Syrian Arab Republic" },
+ { 158, "tw", "Taiwan" },
+ { 762, "tj", "Tajikistan" },
+ { 834, "tz", "Tanzania" },
+ { 764, "th", "Thailand" },
+ { 626, "tl", "Timor-Leste" },
+ { 768, "tg", "Togo" },
+ { 772, "tk", "Tokelau" },
+ { 776, "to", "Tonga" },
+ { 780, "tt", "Trinidad & Tobago" },
+ { 788, "tn", "Tunisia" },
+ { 792, "tr", "Turkey" },
+ { 795, "tm", "Turkmenistan" },
+ { 796, "tc", "Turks & Caicos Islands" },
+ { 798, "tv", "Tuvalu" },
+ { 800, "ug", "Uganda" },
+ { 804, "ua", "Ukraine" },
+ { 784, "ae", "United Arab Emirates" },
+ { 826, "gb", "United Kingdom" },
+ { 840, "us", "United States" },
+ { 581, "um", "United States Minor Outlying Islands"},
+ { 858, "uy", "Uruguay" },
+ { 860, "uz", "Uzbekistan" },
+ { 548, "vu", "Vanuatu" },
+ { 862, "ve", "Venezuela" },
+ { 704, "vn", "Vietnam" },
+ { 92, "vg", "Virgin Islands (British)" },
+ { 850, "vi", "Virgin Islands (US)" },
+ { 876, "wf", "Wallis & Futuna Islands" },
+ { 732, "eh", "Western Sahara" },
+ { 887, "ye", "Yemen" },
+ { 894, "zm", "Zambia" },
+ { 716, "zw", "Zimbabwe" }
+};
+
+/*
+ * Check if start of 'str' is simply an IPv4 address.
+ */
+#define BYTE_OK(x) ((x) >= 0 && (x) <= 255)
+
+static int is_addr(char *str, char **end)
+{
+ int a0, a1, a2, a3, num, rc = 0, length = 0;
+
+ num = sscanf(str, "%3d.%3d.%3d.%3d%n", &a0, &a1, &a2, &a3, &length);
+ if ((num == 4) && BYTE_OK(a0) && BYTE_OK(a1) && BYTE_OK(a2) && BYTE_OK(a3) &&
+ length >= (3 + 4)) {
+ rc = 1;
+ *end = str + length;
+ }
+ return rc;
+}
+
+/*
+ * Find the country-code and name from the CNAME. E.g.:
+ * version 1: CNAME = zzno.countries.nerd.dk with address 127.0.2.66
+ * yields ccode_A" = "no" and cnumber 578 (2.66).
+ * version 2: CNAME = <a.b.c.d>.zz.countries.nerd.dk with address 127.0.2.66
+ * yields cnumber 578 (2.66). ccode_A is "";
+ */
+static void find_country_from_cname(const char *cname, struct in_addr addr)
+{
+ const struct search_list *country;
+ char ccode_A2[3], *ccopy, *dot_4;
+ int cnumber, z0, z1, ver_1, ver_2;
+ unsigned long ip;
+
+ ip = ntohl(addr.s_addr);
+ z0 = TOLOWER(cname[0]);
+ z1 = TOLOWER(cname[1]);
+ ccopy = strdup(cname);
+ dot_4 = NULL;
+
+ ver_1 = (z0 == 'z' && z1 == 'z' && !strcasecmp(cname + 4, nerd_ver1));
+ ver_2 = (is_addr(ccopy, &dot_4) && !strcasecmp(dot_4, nerd_ver2));
+
+ if (ver_1) {
+ const char *dot = strchr(cname, '.');
+ if (dot != cname + 4) {
+ printf("Unexpected CNAME %s (ver_1)\n", cname);
+ free(ccopy);
+ return;
+ }
+ } else if (ver_2) {
+ z0 = TOLOWER(dot_4[1]);
+ z1 = TOLOWER(dot_4[2]);
+ if (z0 != 'z' && z1 != 'z') {
+ printf("Unexpected CNAME %s (ver_2)\n", cname);
+ free(ccopy);
+ return;
+ }
+ } else {
+ printf("Unexpected CNAME %s (ver?)\n", cname);
+ free(ccopy);
+ return;
+ }
+
+ if (ver_1) {
+ ccode_A2[0] = (char)TOLOWER(cname[2]);
+ ccode_A2[1] = (char)TOLOWER(cname[3]);
+ ccode_A2[2] = '\0';
+ } else {
+ ccode_A2[0] = '\0';
+ }
+
+ cnumber = ip & 0xFFFF;
+
+ TRACE(("Found country-code `%s', number %d\n", ver_1 ? ccode_A2 : "<n/a>",
+ cnumber));
+
+ country = list_lookup(cnumber, country_list,
+ sizeof(country_list) / sizeof(country_list[0]));
+ if (!country) {
+ printf("Name for country-number %d not found.\n", cnumber);
+ } else {
+ if (ver_1) {
+ if ((country->short_name[0] != ccode_A2[0]) ||
+ (country->short_name[1] != ccode_A2[1]) ||
+ (country->short_name[2] != ccode_A2[2])) {
+ printf("short-name mismatch; %s vs %s\n", country->short_name,
+ ccode_A2);
+ }
+ }
+ printf("%s (%s), number %d.\n", country->long_name, country->short_name,
+ cnumber);
+ }
+ free(ccopy);
+}
+
+/* Information from the man page. Formatting taken from man -h */
+static void print_help_info_acountry(void)
+{
+ printf("acountry, version %s\n\n", ARES_VERSION_STR);
+ printf("usage: acountry [-hdv] host|addr ...\n\n"
+ " h : Display this help and exit.\n"
+ " d : Print some extra debugging output.\n"
+ " v : Be more verbose. Print extra information.\n\n");
+ exit(0);
+}
diff --git a/subprojects/c-ares/src/tools/adig.c b/subprojects/c-ares/src/tools/adig.c
@@ -0,0 +1,958 @@
+/* MIT License
+ *
+ * Copyright (c) 1998 Massachusetts Institute of Technology
+ * Copyright (c) The c-ares project and its contributors
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice (including the next
+ * paragraph) shall be included in all copies or substantial portions of the
+ * Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ *
+ * SPDX-License-Identifier: MIT
+ */
+#include "ares_setup.h"
+
+#ifdef HAVE_NETINET_IN_H
+# include <netinet/in.h>
+#endif
+#ifdef HAVE_ARPA_INET_H
+# include <arpa/inet.h>
+#endif
+#ifdef HAVE_NETDB_H
+# include <netdb.h>
+#endif
+
+#include "ares_nameser.h"
+
+#ifdef HAVE_STRINGS_H
+# include <strings.h>
+#endif
+
+#include "ares.h"
+#include "ares_dns.h"
+
+#ifndef HAVE_STRDUP
+# define strdup(ptr) ares_strdup(ptr)
+#endif
+
+#ifndef HAVE_STRCASECMP
+# include "ares_strcasecmp.h"
+# define strcasecmp(p1, p2) ares_strcasecmp(p1, p2)
+#endif
+
+#ifndef HAVE_STRNCASECMP
+# include "ares_strcasecmp.h"
+# define strncasecmp(p1, p2, n) ares_strncasecmp(p1, p2, n)
+#endif
+
+#include "ares_getopt.h"
+
+#ifdef WATT32
+# undef WIN32 /* Redefined in MingW headers */
+#endif
+
+
+typedef struct {
+ ares_bool_t is_help;
+ struct ares_options options;
+ int optmask;
+ ares_dns_class_t qclass;
+ ares_dns_rec_type_t qtype;
+ int args_processed;
+ char *servers;
+ char error[256];
+} adig_config_t;
+
+typedef struct {
+ const char *name;
+ int value;
+} nv_t;
+
+static const nv_t configflags[] = {
+ {"usevc", ARES_FLAG_USEVC },
+ { "primary", ARES_FLAG_PRIMARY },
+ { "igntc", ARES_FLAG_IGNTC },
+ { "norecurse", ARES_FLAG_NORECURSE},
+ { "stayopen", ARES_FLAG_STAYOPEN },
+ { "noaliases", ARES_FLAG_NOALIASES}
+};
+static const size_t nconfigflags = sizeof(configflags) / sizeof(*configflags);
+
+static int lookup_flag(const nv_t *nv, size_t num_nv, const char *name)
+{
+ size_t i;
+
+ if (name == NULL) {
+ return 0;
+ }
+
+ for (i = 0; i < num_nv; i++) {
+ if (strcasecmp(nv[i].name, name) == 0) {
+ return nv[i].value;
+ }
+ }
+
+ return 0;
+}
+
+static void free_config(adig_config_t *config)
+{
+ free(config->servers);
+ memset(config, 0, sizeof(*config));
+}
+
+static void print_help(void)
+{
+ printf("adig version %s\n\n", ares_version(NULL));
+ printf(
+ "usage: adig [-h] [-d] [-f flag] [[-s server] ...] [-T|U port] [-c class]\n"
+ " [-t type] name ...\n\n"
+ " -h : Display this help and exit.\n"
+ " -d : Print some extra debugging output.\n"
+ " -f flag : Add a behavior control flag. Possible values are\n"
+ " igntc - do not retry a truncated query as TCP, just\n"
+ " return the truncated answer\n"
+ " noaliases - don't honor the HOSTALIASES environment\n"
+ " variable\n"
+ " norecurse - don't query upstream servers recursively\n"
+ " primary - use the first server\n"
+ " stayopen - don't close the communication sockets\n"
+ " usevc - use TCP only\n"
+ " -s server : Connect to the specified DNS server, instead of the\n"
+ " system's default one(s). Servers are tried in round-robin,\n"
+ " if the previous one failed.\n"
+ " -T port : Connect to the specified TCP port of DNS server.\n"
+ " -U port : Connect to the specified UDP port of DNS server.\n"
+ " -c class : Set the query class. Possible values for class are:\n"
+ " ANY, CHAOS, HS and IN (default)\n"
+ " -t type : Query records of the specified type. Possible values for\n"
+ " type are:\n"
+ " A (default), AAAA, ANY, CNAME, HINFO, MX, NAPTR, NS, PTR,\n"
+ " SOA, SRV, TXT, TLSA, URI, CAA, SVCB, HTTPS\n\n");
+}
+
+static ares_bool_t read_cmdline(int argc, const char **argv,
+ adig_config_t *config)
+{
+ ares_getopt_state_t state;
+ int c;
+
+ ares_getopt_init(&state, argc, argv);
+ state.opterr = 0;
+
+ while ((c = ares_getopt(&state, "dh?f:s:c:t:T:U:")) != -1) {
+ int f;
+
+ switch (c) {
+ case 'd':
+#ifdef WATT32
+ dbug_init();
+#endif
+ break;
+
+ case 'h':
+ config->is_help = ARES_TRUE;
+ return ARES_TRUE;
+
+ case 'f':
+ f = lookup_flag(configflags, nconfigflags, state.optarg);
+ if (f == 0) {
+ snprintf(config->error, sizeof(config->error), "flag %s unknown",
+ state.optarg);
+ }
+
+ config->options.flags |= f;
+ config->optmask |= ARES_OPT_FLAGS;
+ break;
+
+ case 's':
+ if (state.optarg == NULL) {
+ snprintf(config->error, sizeof(config->error), "%s",
+ "missing servers");
+ return ARES_FALSE;
+ }
+ if (config->servers) {
+ free(config->servers);
+ }
+ config->servers = strdup(state.optarg);
+ break;
+
+ case 'c':
+ if (!ares_dns_class_fromstr(&config->qclass, state.optarg)) {
+ snprintf(config->error, sizeof(config->error),
+ "unrecognized class %s", state.optarg);
+ return ARES_FALSE;
+ }
+ break;
+
+ case 't':
+ if (!ares_dns_rec_type_fromstr(&config->qtype, state.optarg)) {
+ snprintf(config->error, sizeof(config->error), "unrecognized type %s",
+ state.optarg);
+ return ARES_FALSE;
+ }
+ break;
+
+ case 'T':
+ /* Set the TCP port number. */
+ if (!isdigit(*state.optarg)) {
+ snprintf(config->error, sizeof(config->error), "invalid port number");
+ return ARES_FALSE;
+ }
+ config->options.tcp_port =
+ (unsigned short)strtol(state.optarg, NULL, 0);
+ config->options.flags |= ARES_FLAG_USEVC;
+ config->optmask |= ARES_OPT_TCP_PORT;
+ break;
+
+ case 'U':
+ /* Set the UDP port number. */
+ if (!isdigit(*state.optarg)) {
+ snprintf(config->error, sizeof(config->error), "invalid port number");
+ return ARES_FALSE;
+ }
+ config->options.udp_port =
+ (unsigned short)strtol(state.optarg, NULL, 0);
+ config->optmask |= ARES_OPT_UDP_PORT;
+ break;
+
+ case ':':
+ snprintf(config->error, sizeof(config->error),
+ "%c requires an argument", state.optopt);
+ return ARES_FALSE;
+
+ default:
+ snprintf(config->error, sizeof(config->error),
+ "unrecognized option: %c", state.optopt);
+ return ARES_FALSE;
+ }
+ }
+
+ config->args_processed = state.optind;
+ if (config->args_processed >= argc) {
+ snprintf(config->error, sizeof(config->error), "missing query name");
+ return ARES_FALSE;
+ }
+ return ARES_TRUE;
+}
+
+static void print_flags(ares_dns_flags_t flags)
+{
+ if (flags & ARES_FLAG_QR) {
+ printf(" qr");
+ }
+ if (flags & ARES_FLAG_AA) {
+ printf(" aa");
+ }
+ if (flags & ARES_FLAG_TC) {
+ printf(" tc");
+ }
+ if (flags & ARES_FLAG_RD) {
+ printf(" rd");
+ }
+ if (flags & ARES_FLAG_RA) {
+ printf(" ra");
+ }
+ if (flags & ARES_FLAG_AD) {
+ printf(" ad");
+ }
+ if (flags & ARES_FLAG_CD) {
+ printf(" cd");
+ }
+}
+
+static void print_header(const ares_dns_record_t *dnsrec)
+{
+ printf(";; ->>HEADER<<- opcode: %s, status: %s, id: %u\n",
+ ares_dns_opcode_tostr(ares_dns_record_get_opcode(dnsrec)),
+ ares_dns_rcode_tostr(ares_dns_record_get_rcode(dnsrec)),
+ ares_dns_record_get_id(dnsrec));
+ printf(";; flags:");
+ print_flags(ares_dns_record_get_flags(dnsrec));
+ printf("; QUERY: %u, ANSWER: %u, AUTHORITY: %u, ADDITIONAL: %u\n\n",
+ (unsigned int)ares_dns_record_query_cnt(dnsrec),
+ (unsigned int)ares_dns_record_rr_cnt(dnsrec, ARES_SECTION_ANSWER),
+ (unsigned int)ares_dns_record_rr_cnt(dnsrec, ARES_SECTION_AUTHORITY),
+ (unsigned int)ares_dns_record_rr_cnt(dnsrec, ARES_SECTION_ADDITIONAL));
+}
+
+static void print_question(const ares_dns_record_t *dnsrec)
+{
+ size_t i;
+ printf(";; QUESTION SECTION:\n");
+ for (i = 0; i < ares_dns_record_query_cnt(dnsrec); i++) {
+ const char *name;
+ ares_dns_rec_type_t qtype;
+ ares_dns_class_t qclass;
+ size_t len;
+ if (ares_dns_record_query_get(dnsrec, i, &name, &qtype, &qclass) !=
+ ARES_SUCCESS) {
+ return;
+ }
+ if (name == NULL) {
+ return;
+ }
+ len = strlen(name);
+ printf(";%s.\t", name);
+ if (len + 1 < 24) {
+ printf("\t");
+ }
+ if (len + 1 < 16) {
+ printf("\t");
+ }
+ printf("%s\t%s\n", ares_dns_class_tostr(qclass),
+ ares_dns_rec_type_tostr(qtype));
+ }
+ printf("\n");
+}
+
+static void print_opt_none(const unsigned char *val, size_t val_len)
+{
+ (void)val;
+ if (val_len != 0) {
+ printf("INVALID!");
+ }
+}
+
+static void print_opt_addr_list(const unsigned char *val, size_t val_len)
+{
+ size_t i;
+ if (val_len % 4 != 0) {
+ printf("INVALID!");
+ return;
+ }
+ for (i = 0; i < val_len; i += 4) {
+ char buf[256] = "";
+ ares_inet_ntop(AF_INET, val + i, buf, sizeof(buf));
+ if (i != 0) {
+ printf(",");
+ }
+ printf("%s", buf);
+ }
+}
+
+static void print_opt_addr6_list(const unsigned char *val, size_t val_len)
+{
+ size_t i;
+ if (val_len % 16 != 0) {
+ printf("INVALID!");
+ return;
+ }
+ for (i = 0; i < val_len; i += 16) {
+ char buf[256] = "";
+
+ ares_inet_ntop(AF_INET6, val + i, buf, sizeof(buf));
+ if (i != 0) {
+ printf(",");
+ }
+ printf("%s", buf);
+ }
+}
+
+static void print_opt_u8_list(const unsigned char *val, size_t val_len)
+{
+ size_t i;
+
+ for (i = 0; i < val_len; i++) {
+ if (i != 0) {
+ printf(",");
+ }
+ printf("%u", (unsigned int)val[i]);
+ }
+}
+
+static void print_opt_u16_list(const unsigned char *val, size_t val_len)
+{
+ size_t i;
+ if (val_len < 2 || val_len % 2 != 0) {
+ printf("INVALID!");
+ return;
+ }
+ for (i = 0; i < val_len; i += 2) {
+ unsigned short u16 = 0;
+ unsigned short c;
+ /* Jumping over backwards to try to avoid odd compiler warnings */
+ c = (unsigned short)val[i];
+ u16 |= (unsigned short)((c << 8) & 0xFFFF);
+ c = (unsigned short)val[i + 1];
+ u16 |= c;
+ if (i != 0) {
+ printf(",");
+ }
+ printf("%u", (unsigned int)u16);
+ }
+}
+
+static void print_opt_u32_list(const unsigned char *val, size_t val_len)
+{
+ size_t i;
+ if (val_len < 4 || val_len % 4 != 0) {
+ printf("INVALID!");
+ return;
+ }
+ for (i = 0; i < val_len; i += 4) {
+ unsigned int u32 = 0;
+
+ u32 |= (unsigned int)(val[i] << 24);
+ u32 |= (unsigned int)(val[i + 1] << 16);
+ u32 |= (unsigned int)(val[i + 2] << 8);
+ u32 |= (unsigned int)(val[i + 3]);
+ if (i != 0) {
+ printf(",");
+ }
+ printf("%u", u32);
+ }
+}
+
+static void print_opt_str_list(const unsigned char *val, size_t val_len)
+{
+ size_t cnt = 0;
+
+ printf("\"");
+ while (val_len) {
+ long read_len = 0;
+ unsigned char *str = NULL;
+ ares_status_t status;
+
+ if (cnt) {
+ printf(",");
+ }
+
+ status = (ares_status_t)ares_expand_string(val, val, (int)val_len, &str,
+ &read_len);
+ if (status != ARES_SUCCESS) {
+ printf("INVALID");
+ break;
+ }
+ printf("%s", str);
+ ares_free_string(str);
+ val_len -= (size_t)read_len;
+ val += read_len;
+ cnt++;
+ }
+ printf("\"");
+}
+
+static void print_opt_name(const unsigned char *val, size_t val_len)
+{
+ char *str = NULL;
+ long read_len = 0;
+
+ if (ares_expand_name(val, val, (int)val_len, &str, &read_len) !=
+ ARES_SUCCESS) {
+ printf("INVALID!");
+ return;
+ }
+
+ printf("%s.", str);
+ ares_free_string(str);
+}
+
+static void print_opt_bin(const unsigned char *val, size_t val_len)
+{
+ size_t i;
+
+ for (i = 0; i < val_len; i++) {
+ printf("%02x", (unsigned int)val[i]);
+ }
+}
+
+static ares_bool_t adig_isprint(int ch)
+{
+ if (ch >= 0x20 && ch <= 0x7E) {
+ return ARES_TRUE;
+ }
+ return ARES_FALSE;
+}
+
+static void print_opt_binp(const unsigned char *val, size_t val_len)
+{
+ size_t i;
+ printf("\"");
+ for (i = 0; i < val_len; i++) {
+ if (adig_isprint(val[i])) {
+ printf("%c", val[i]);
+ } else {
+ printf("\\%03d", val[i]);
+ }
+ }
+ printf("\"");
+}
+
+static void print_opts(const ares_dns_rr_t *rr, ares_dns_rr_key_t key)
+{
+ size_t i;
+
+ for (i = 0; i < ares_dns_rr_get_opt_cnt(rr, key); i++) {
+ size_t val_len = 0;
+ const unsigned char *val = NULL;
+ unsigned short opt;
+ const char *name;
+
+ if (i != 0) {
+ printf(" ");
+ }
+
+ opt = ares_dns_rr_get_opt(rr, key, i, &val, &val_len);
+ name = ares_dns_opt_get_name(key, opt);
+ if (name == NULL) {
+ printf("key%u", (unsigned int)opt);
+ } else {
+ printf("%s", name);
+ }
+ if (val_len == 0) {
+ return;
+ }
+
+ printf("=");
+
+ switch (ares_dns_opt_get_datatype(key, opt)) {
+ case ARES_OPT_DATATYPE_NONE:
+ print_opt_none(val, val_len);
+ break;
+ case ARES_OPT_DATATYPE_U8_LIST:
+ print_opt_u8_list(val, val_len);
+ break;
+ case ARES_OPT_DATATYPE_INADDR4_LIST:
+ print_opt_addr_list(val, val_len);
+ break;
+ case ARES_OPT_DATATYPE_INADDR6_LIST:
+ print_opt_addr6_list(val, val_len);
+ break;
+ case ARES_OPT_DATATYPE_U16:
+ case ARES_OPT_DATATYPE_U16_LIST:
+ print_opt_u16_list(val, val_len);
+ break;
+ case ARES_OPT_DATATYPE_U32:
+ case ARES_OPT_DATATYPE_U32_LIST:
+ print_opt_u32_list(val, val_len);
+ break;
+ case ARES_OPT_DATATYPE_STR_LIST:
+ print_opt_str_list(val, val_len);
+ break;
+ case ARES_OPT_DATATYPE_BIN:
+ print_opt_bin(val, val_len);
+ break;
+ case ARES_OPT_DATATYPE_NAME:
+ print_opt_name(val, val_len);
+ break;
+ }
+ }
+}
+
+static void print_addr(const ares_dns_rr_t *rr, ares_dns_rr_key_t key)
+{
+ const struct in_addr *addr = ares_dns_rr_get_addr(rr, key);
+ char buf[256] = "";
+
+ ares_inet_ntop(AF_INET, addr, buf, sizeof(buf));
+ printf("%s", buf);
+}
+
+static void print_addr6(const ares_dns_rr_t *rr, ares_dns_rr_key_t key)
+{
+ const struct ares_in6_addr *addr = ares_dns_rr_get_addr6(rr, key);
+ char buf[256] = "";
+
+ ares_inet_ntop(AF_INET6, addr, buf, sizeof(buf));
+ printf("%s", buf);
+}
+
+static void print_u8(const ares_dns_rr_t *rr, ares_dns_rr_key_t key)
+{
+ unsigned char u8 = ares_dns_rr_get_u8(rr, key);
+ printf("%u", (unsigned int)u8);
+}
+
+static void print_u16(const ares_dns_rr_t *rr, ares_dns_rr_key_t key)
+{
+ unsigned short u16 = ares_dns_rr_get_u16(rr, key);
+ printf("%u", (unsigned int)u16);
+}
+
+static void print_u32(const ares_dns_rr_t *rr, ares_dns_rr_key_t key)
+{
+ unsigned int u32 = ares_dns_rr_get_u32(rr, key);
+ printf("%u", u32);
+}
+
+static void print_name(const ares_dns_rr_t *rr, ares_dns_rr_key_t key)
+{
+ const char *str = ares_dns_rr_get_str(rr, key);
+ printf("%s.", str);
+}
+
+static void print_str(const ares_dns_rr_t *rr, ares_dns_rr_key_t key)
+{
+ const char *str = ares_dns_rr_get_str(rr, key);
+ printf("\"%s\"", str);
+}
+
+static void print_bin(const ares_dns_rr_t *rr, ares_dns_rr_key_t key)
+{
+ size_t len = 0;
+ const unsigned char *binp = ares_dns_rr_get_bin(rr, key, &len);
+ print_opt_bin(binp, len);
+}
+
+static void print_binp(const ares_dns_rr_t *rr, ares_dns_rr_key_t key)
+{
+ size_t len;
+ const unsigned char *binp = ares_dns_rr_get_bin(rr, key, &len);
+
+ print_opt_binp(binp, len);
+}
+
+static void print_rr(const ares_dns_rr_t *rr)
+{
+ const char *name = ares_dns_rr_get_name(rr);
+ size_t len = 0;
+ size_t keys_cnt = 0;
+ ares_dns_rec_type_t rtype = ares_dns_rr_get_type(rr);
+ const ares_dns_rr_key_t *keys = ares_dns_rr_get_keys(rtype, &keys_cnt);
+ size_t i;
+
+ if (name == NULL) {
+ return;
+ }
+
+ len = strlen(name);
+
+ printf("%s.\t", name);
+ if (len < 24) {
+ printf("\t");
+ }
+
+ printf("%u\t%s\t%s\t", ares_dns_rr_get_ttl(rr),
+ ares_dns_class_tostr(ares_dns_rr_get_class(rr)),
+ ares_dns_rec_type_tostr(rtype));
+
+ /* Output params here */
+ for (i = 0; i < keys_cnt; i++) {
+ ares_dns_datatype_t datatype = ares_dns_rr_key_datatype(keys[i]);
+ if (i != 0) {
+ printf(" ");
+ }
+
+ switch (datatype) {
+ case ARES_DATATYPE_INADDR:
+ print_addr(rr, keys[i]);
+ break;
+ case ARES_DATATYPE_INADDR6:
+ print_addr6(rr, keys[i]);
+ break;
+ case ARES_DATATYPE_U8:
+ print_u8(rr, keys[i]);
+ break;
+ case ARES_DATATYPE_U16:
+ print_u16(rr, keys[i]);
+ break;
+ case ARES_DATATYPE_U32:
+ print_u32(rr, keys[i]);
+ break;
+ case ARES_DATATYPE_NAME:
+ print_name(rr, keys[i]);
+ break;
+ case ARES_DATATYPE_STR:
+ print_str(rr, keys[i]);
+ break;
+ case ARES_DATATYPE_BIN:
+ print_bin(rr, keys[i]);
+ break;
+ case ARES_DATATYPE_BINP:
+ print_binp(rr, keys[i]);
+ break;
+ case ARES_DATATYPE_OPT:
+ print_opts(rr, keys[i]);
+ break;
+ }
+ }
+
+ printf("\n");
+}
+
+static const ares_dns_rr_t *has_opt(ares_dns_record_t *dnsrec,
+ ares_dns_section_t section)
+{
+ size_t i;
+ for (i = 0; i < ares_dns_record_rr_cnt(dnsrec, section); i++) {
+ const ares_dns_rr_t *rr = ares_dns_record_rr_get(dnsrec, section, i);
+ if (ares_dns_rr_get_type(rr) == ARES_REC_TYPE_OPT) {
+ return rr;
+ }
+ }
+ return NULL;
+}
+
+static void print_section(ares_dns_record_t *dnsrec, ares_dns_section_t section)
+{
+ size_t i;
+
+ if (ares_dns_record_rr_cnt(dnsrec, section) == 0 ||
+ (ares_dns_record_rr_cnt(dnsrec, section) == 1 &&
+ has_opt(dnsrec, section) != NULL)) {
+ return;
+ }
+
+ printf(";; %s SECTION:\n", ares_dns_section_tostr(section));
+ for (i = 0; i < ares_dns_record_rr_cnt(dnsrec, section); i++) {
+ const ares_dns_rr_t *rr = ares_dns_record_rr_get(dnsrec, section, i);
+ if (ares_dns_rr_get_type(rr) == ARES_REC_TYPE_OPT) {
+ continue;
+ }
+ print_rr(rr);
+ }
+ printf("\n");
+}
+
+static void print_opt_psuedosection(ares_dns_record_t *dnsrec)
+{
+ const ares_dns_rr_t *rr = has_opt(dnsrec, ARES_SECTION_ADDITIONAL);
+ if (rr == NULL) {
+ return;
+ }
+
+ printf(";; OPT PSEUDOSECTION:\n");
+ printf("; EDNS: version: %u, flags: %u; udp: %u\t",
+ (unsigned int)ares_dns_rr_get_u8(rr, ARES_RR_OPT_VERSION),
+ (unsigned int)ares_dns_rr_get_u16(rr, ARES_RR_OPT_FLAGS),
+ (unsigned int)ares_dns_rr_get_u16(rr, ARES_RR_OPT_UDP_SIZE));
+
+ printf("\n");
+}
+
+static void callback(void *arg, int status, int timeouts, unsigned char *abuf,
+ int alen)
+{
+ ares_dns_record_t *dnsrec = NULL;
+ (void)arg;
+ (void)timeouts;
+
+ printf(";; Got answer:");
+ if (status != ARES_SUCCESS) {
+ printf(" %s", ares_strerror(status));
+ }
+ printf("\n");
+
+ if (abuf == NULL || alen == 0) {
+ return;
+ }
+
+ status = (int)ares_dns_parse(abuf, (size_t)alen, 0, &dnsrec);
+ if (status != ARES_SUCCESS) {
+ fprintf(stderr, ";; FAILED TO PARSE DNS PACKET: %s\n",
+ ares_strerror(status));
+ return;
+ }
+
+ print_header(dnsrec);
+ print_opt_psuedosection(dnsrec);
+ print_question(dnsrec);
+ print_section(dnsrec, ARES_SECTION_ANSWER);
+ print_section(dnsrec, ARES_SECTION_ADDITIONAL);
+ print_section(dnsrec, ARES_SECTION_AUTHORITY);
+
+ printf(";; MSG SIZE rcvd: %d\n\n", alen);
+ ares_dns_record_destroy(dnsrec);
+}
+
+static ares_status_t enqueue_query(ares_channel_t *channel,
+ const adig_config_t *config,
+ const char *name)
+{
+ ares_dns_record_t *dnsrec = NULL;
+ ares_dns_rr_t *rr = NULL;
+ ares_status_t status;
+ unsigned char *buf = NULL;
+ size_t buf_len = 0;
+ unsigned short flags = 0;
+ char *nametemp = NULL;
+
+ if (!(config->options.flags & ARES_FLAG_NORECURSE)) {
+ flags |= ARES_FLAG_RD;
+ }
+
+ status = ares_dns_record_create(&dnsrec, 0, flags, ARES_OPCODE_QUERY,
+ ARES_RCODE_NOERROR);
+ if (status != ARES_SUCCESS) {
+ goto done;
+ }
+
+ /* If it is a PTR record, convert from ip address into in-arpa form
+ * automatically */
+ if (config->qtype == ARES_REC_TYPE_PTR) {
+ struct ares_addr addr;
+ size_t len;
+ addr.family = AF_UNSPEC;
+
+ if (ares_dns_pton(name, &addr, &len) != NULL) {
+ nametemp = ares_dns_addr_to_ptr(&addr);
+ name = nametemp;
+ }
+ }
+
+ status =
+ ares_dns_record_query_add(dnsrec, name, config->qtype, config->qclass);
+ if (status != ARES_SUCCESS) {
+ goto done;
+ }
+
+ status = ares_dns_record_rr_add(&rr, dnsrec, ARES_SECTION_ADDITIONAL, "",
+ ARES_REC_TYPE_OPT, ARES_CLASS_IN, 0);
+ if (status != ARES_SUCCESS) {
+ goto done;
+ }
+ ares_dns_rr_set_u16(rr, ARES_RR_OPT_UDP_SIZE, 1280);
+ ares_dns_rr_set_u8(rr, ARES_RR_OPT_VERSION, 0);
+
+ status = ares_dns_write(dnsrec, &buf, &buf_len);
+ if (status != ARES_SUCCESS) {
+ goto done;
+ }
+
+ ares_send(channel, buf, (int)buf_len, callback, NULL);
+ ares_free_string(buf);
+
+done:
+ ares_free_string(nametemp);
+ ares_dns_record_destroy(dnsrec);
+ return status;
+}
+
+static int event_loop(ares_channel_t *channel)
+{
+ while (1) {
+ fd_set read_fds;
+ fd_set write_fds;
+ int nfds;
+ struct timeval tv;
+ struct timeval *tvp;
+ int count;
+
+ FD_ZERO(&read_fds);
+ FD_ZERO(&write_fds);
+ memset(&tv, 0, sizeof(tv));
+
+ nfds = ares_fds(channel, &read_fds, &write_fds);
+ if (nfds == 0) {
+ break;
+ }
+ tvp = ares_timeout(channel, NULL, &tv);
+ if (tvp == NULL) {
+ break;
+ }
+ count = select(nfds, &read_fds, &write_fds, NULL, tvp);
+ if (count < 0) {
+#ifdef USE_WINSOCK
+ int err = WSAGetLastError();
+#else
+ int err = errno;
+#endif
+ if (err != EAGAIN && err != EINTR) {
+ fprintf(stderr, "select fail: %d", err);
+ return 1;
+ }
+ }
+ ares_process(channel, &read_fds, &write_fds);
+ }
+ return 0;
+}
+
+int main(int argc, char **argv)
+{
+ ares_channel_t *channel = NULL;
+ ares_status_t status;
+ adig_config_t config;
+ int i;
+ int rv = 0;
+
+#ifdef USE_WINSOCK
+ WORD wVersionRequested = MAKEWORD(USE_WINSOCK, USE_WINSOCK);
+ WSADATA wsaData;
+ WSAStartup(wVersionRequested, &wsaData);
+#endif
+
+ status = (ares_status_t)ares_library_init(ARES_LIB_INIT_ALL);
+ if (status != ARES_SUCCESS) {
+ fprintf(stderr, "ares_library_init: %s\n", ares_strerror((int)status));
+ return 1;
+ }
+
+ memset(&config, 0, sizeof(config));
+ config.qclass = ARES_CLASS_IN;
+ config.qtype = ARES_REC_TYPE_A;
+ if (!read_cmdline(argc, (const char **)argv, &config)) {
+ printf("\n** ERROR: %s\n\n", config.error);
+ print_help();
+ rv = 1;
+ goto done;
+ }
+
+ if (config.is_help) {
+ print_help();
+ goto done;
+ }
+
+ status =
+ (ares_status_t)ares_init_options(&channel, &config.options, config.optmask);
+ if (status != ARES_SUCCESS) {
+ fprintf(stderr, "ares_init_options: %s\n", ares_strerror((int)status));
+ rv = 1;
+ goto done;
+ }
+
+ if (config.servers) {
+ status = (ares_status_t)ares_set_servers_ports_csv(channel, config.servers);
+ if (status != ARES_SUCCESS) {
+ fprintf(stderr, "ares_set_servers_ports_csv: %s\n",
+ ares_strerror((int)status));
+ rv = 1;
+ goto done;
+ }
+ }
+
+ /* Enqueue a query for each separate name */
+ for (i = config.args_processed; i < argc; i++) {
+ status = enqueue_query(channel, &config, argv[i]);
+ if (status != ARES_SUCCESS) {
+ fprintf(stderr, "Failed to create query for %s: %s\n", argv[i],
+ ares_strerror((int)status));
+ rv = 1;
+ goto done;
+ }
+ }
+
+ /* Debug */
+ printf("\n; <<>> c-ares DiG %s <<>>", ares_version(NULL));
+ for (i = config.args_processed; i < argc; i++) {
+ printf(" %s", argv[i]);
+ }
+ printf("\n");
+
+ /* Process events */
+ rv = event_loop(channel);
+
+done:
+ free_config(&config);
+ ares_destroy(channel);
+ ares_library_cleanup();
+
+#ifdef USE_WINSOCK
+ WSACleanup();
+#endif
+ return rv;
+}
diff --git a/subprojects/c-ares/src/tools/ahost.c b/subprojects/c-ares/src/tools/ahost.c
@@ -0,0 +1,295 @@
+/* MIT License
+ *
+ * Copyright (c) 1998 Massachusetts Institute of Technology
+ * Copyright (c) The c-ares project and its contributors
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice (including the next
+ * paragraph) shall be included in all copies or substantial portions of the
+ * Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ *
+ * SPDX-License-Identifier: MIT
+ */
+
+#include "ares_setup.h"
+
+#if !defined(WIN32) || defined(WATT32)
+# include <netinet/in.h>
+# include <arpa/inet.h>
+# include <netdb.h>
+#endif
+
+#ifdef HAVE_STRINGS_H
+# include <strings.h>
+#endif
+
+#include "ares.h"
+#include "ares_dns.h"
+#include "ares_getopt.h"
+#include "ares_ipv6.h"
+
+#ifndef HAVE_STRDUP
+# include "ares_strdup.h"
+# define strdup(ptr) ares_strdup(ptr)
+#endif
+
+#ifndef HAVE_STRCASECMP
+# include "ares_strcasecmp.h"
+# define strcasecmp(p1, p2) ares_strcasecmp(p1, p2)
+#endif
+
+#ifndef HAVE_STRNCASECMP
+# include "ares_strcasecmp.h"
+# define strncasecmp(p1, p2, n) ares_strncasecmp(p1, p2, n)
+#endif
+
+static void callback(void *arg, int status, int timeouts, struct hostent *host);
+static void ai_callback(void *arg, int status, int timeouts,
+ struct ares_addrinfo *result);
+static void usage(void);
+static void print_help_info_ahost(void);
+
+int main(int argc, char **argv)
+{
+ struct ares_options options;
+ int optmask = 0;
+ ares_channel_t *channel;
+ int status;
+ int nfds;
+ int c;
+ int addr_family = AF_UNSPEC;
+ fd_set read_fds;
+ fd_set write_fds;
+ struct timeval *tvp;
+ struct timeval tv;
+ struct in_addr addr4;
+ struct ares_in6_addr addr6;
+ ares_getopt_state_t state;
+ char *servers = NULL;
+
+#ifdef USE_WINSOCK
+ WORD wVersionRequested = MAKEWORD(USE_WINSOCK, USE_WINSOCK);
+ WSADATA wsaData;
+ WSAStartup(wVersionRequested, &wsaData);
+#endif
+
+ memset(&options, 0, sizeof(options));
+
+ status = ares_library_init(ARES_LIB_INIT_ALL);
+ if (status != ARES_SUCCESS) {
+ fprintf(stderr, "ares_library_init: %s\n", ares_strerror(status));
+ return 1;
+ }
+
+ ares_getopt_init(&state, argc, (const char **)argv);
+ while ((c = ares_getopt(&state, "dt:h?D:s:")) != -1) {
+ switch (c) {
+ case 'd':
+#ifdef WATT32
+ dbug_init();
+#endif
+ break;
+ case 'D':
+ optmask |= ARES_OPT_DOMAINS;
+ options.ndomains++;
+ options.domains = (char **)realloc(
+ options.domains, (size_t)options.ndomains * sizeof(char *));
+ options.domains[options.ndomains - 1] = strdup(state.optarg);
+ break;
+ case 't':
+ if (!strcasecmp(state.optarg, "a")) {
+ addr_family = AF_INET;
+ } else if (!strcasecmp(state.optarg, "aaaa")) {
+ addr_family = AF_INET6;
+ } else if (!strcasecmp(state.optarg, "u")) {
+ addr_family = AF_UNSPEC;
+ } else {
+ usage();
+ }
+ break;
+ case 's':
+ if (state.optarg == NULL) {
+ fprintf(stderr, "%s", "missing servers");
+ usage();
+ break;
+ }
+ if (servers) {
+ free(servers);
+ }
+ servers = strdup(state.optarg);
+ break;
+ case 'h':
+ case '?':
+ print_help_info_ahost();
+ break;
+ default:
+ usage();
+ break;
+ }
+ }
+
+ argc -= state.optind;
+ argv += state.optind;
+ if (argc < 1) {
+ usage();
+ }
+
+ status = ares_init_options(&channel, &options, optmask);
+ if (status != ARES_SUCCESS) {
+ free(servers);
+ fprintf(stderr, "ares_init: %s\n", ares_strerror(status));
+ return 1;
+ }
+
+ if (servers) {
+ status = ares_set_servers_csv(channel, servers);
+ if (status != ARES_SUCCESS) {
+ fprintf(stderr, "ares_set_serveres_csv: %s\n", ares_strerror(status));
+ free(servers);
+ usage();
+ return 1;
+ }
+ free(servers);
+ }
+
+ /* Initiate the queries, one per command-line argument. */
+ for (; *argv; argv++) {
+ if (ares_inet_pton(AF_INET, *argv, &addr4) == 1) {
+ ares_gethostbyaddr(channel, &addr4, sizeof(addr4), AF_INET, callback,
+ *argv);
+ } else if (ares_inet_pton(AF_INET6, *argv, &addr6) == 1) {
+ ares_gethostbyaddr(channel, &addr6, sizeof(addr6), AF_INET6, callback,
+ *argv);
+ } else {
+ struct ares_addrinfo_hints hints;
+ memset(&hints, 0, sizeof(hints));
+ hints.ai_family = addr_family;
+ ares_getaddrinfo(channel, *argv, NULL, &hints, ai_callback, *argv);
+ }
+ }
+
+ /* Wait for all queries to complete. */
+ for (;;) {
+ int res;
+ FD_ZERO(&read_fds);
+ FD_ZERO(&write_fds);
+ nfds = ares_fds(channel, &read_fds, &write_fds);
+ if (nfds == 0) {
+ break;
+ }
+ tvp = ares_timeout(channel, NULL, &tv);
+ if (tvp == NULL) {
+ break;
+ }
+ res = select(nfds, &read_fds, &write_fds, NULL, tvp);
+ if (-1 == res) {
+ break;
+ }
+ ares_process(channel, &read_fds, &write_fds);
+ }
+
+ ares_destroy(channel);
+
+ ares_library_cleanup();
+
+#ifdef USE_WINSOCK
+ WSACleanup();
+#endif
+
+ return 0;
+}
+
+static void callback(void *arg, int status, int timeouts, struct hostent *host)
+{
+ char **p;
+
+ (void)timeouts;
+
+ if (status != ARES_SUCCESS) {
+ fprintf(stderr, "%s: %s\n", (char *)arg, ares_strerror(status));
+ return;
+ }
+
+ for (p = host->h_addr_list; *p; p++) {
+ char addr_buf[46] = "??";
+
+ ares_inet_ntop(host->h_addrtype, *p, addr_buf, sizeof(addr_buf));
+ printf("%-32s\t%s", host->h_name, addr_buf);
+ puts("");
+ }
+}
+
+static void ai_callback(void *arg, int status, int timeouts,
+ struct ares_addrinfo *result)
+{
+ struct ares_addrinfo_node *node = NULL;
+ (void)timeouts;
+
+
+ if (status != ARES_SUCCESS) {
+ fprintf(stderr, "%s: %s\n", (char *)arg, ares_strerror(status));
+ return;
+ }
+
+ for (node = result->nodes; node != NULL; node = node->ai_next) {
+ char addr_buf[64] = "";
+ const void *ptr = NULL;
+ if (node->ai_family == AF_INET) {
+ const struct sockaddr_in *in_addr =
+ (const struct sockaddr_in *)((void *)node->ai_addr);
+ ptr = &in_addr->sin_addr;
+ } else if (node->ai_family == AF_INET6) {
+ const struct sockaddr_in6 *in_addr =
+ (const struct sockaddr_in6 *)((void *)node->ai_addr);
+ ptr = &in_addr->sin6_addr;
+ } else {
+ continue;
+ }
+ ares_inet_ntop(node->ai_family, ptr, addr_buf, sizeof(addr_buf));
+ printf("%-32s\t%s\n", result->name, addr_buf);
+ }
+
+ ares_freeaddrinfo(result);
+}
+
+static void usage(void)
+{
+ fprintf(stderr, "usage: ahost [-h] [-d] [[-D {domain}] ...] [-s {server}] "
+ "[-t {a|aaaa|u}] {host|addr} ...\n");
+ exit(1);
+}
+
+/* Information from the man page. Formatting taken from man -h */
+static void print_help_info_ahost(void)
+{
+ printf("ahost, version %s\n\n", ARES_VERSION_STR);
+ printf(
+ "usage: ahost [-h] [-d] [-D domain] [-s server] [-t a|aaaa|u] host|addr "
+ "...\n\n"
+ " -h : Display this help and exit.\n"
+ " -d : Print some extra debugging output.\n\n"
+ " -D domain : Specify the domain to search instead of using the default "
+ "values\n"
+ " -s server : Connect to the specified DNS server, instead of the\n"
+ " system's default one(s). Servers are tried in round-robin,\n"
+ " if the previous one failed.\n"
+ " -t type : If type is \"a\", print the A record.\n"
+ " If type is \"aaaa\", print the AAAA record.\n"
+ " If type is \"u\" (default), print both A and AAAA records.\n"
+ "\n");
+ exit(0);
+}
diff --git a/subprojects/c-ares/src/tools/ares_getopt.c b/subprojects/c-ares/src/tools/ares_getopt.c
@@ -0,0 +1,137 @@
+/*
+ * Original file name getopt.c Initial import into the c-ares source tree
+ * on 2007-04-11. Lifted from version 5.2 of the 'Open Mash' project with
+ * the modified BSD license, BSD license without the advertising clause.
+ *
+ */
+
+/*
+ * getopt.c --
+ *
+ * Standard UNIX getopt function. Code is from BSD.
+ *
+ * Copyright (c) 1987-2001 The Regents of the University of California.
+ * All rights reserved.
+ *
+ * Redistribution and use in source and binary forms, with or without
+ * modification, are permitted provided that the following conditions are met:
+ *
+ * A. Redistributions of source code must retain the above copyright notice,
+ * this list of conditions and the following disclaimer.
+ * B. Redistributions in binary form must reproduce the above copyright notice,
+ * this list of conditions and the following disclaimer in the documentation
+ * and/or other materials provided with the distribution.
+ * C. Neither the names of the copyright holders nor the names of its
+ * contributors may be used to endorse or promote products derived from this
+ * software without specific prior written permission.
+ *
+ * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS ``AS
+ * IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO,
+ * THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
+ * PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE
+ * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
+ * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
+ * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+ * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
+ * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
+ * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
+ * POSSIBILITY OF SUCH DAMAGE.
+ *
+ * SPDX-License-Identifier: BSD-3-Clause
+ */
+
+#include <stdio.h>
+#include <stdlib.h>
+#include <string.h>
+#include "ares_getopt.h"
+
+#define BADCH (int)'?'
+#define BADARG (int)':'
+#define EMSG (char *)""
+
+void ares_getopt_init(ares_getopt_state_t *state, int nargc, const char **nargv)
+{
+ memset(state, 0, sizeof(*state));
+ state->opterr = 1;
+ state->optind = 1;
+ state->place = EMSG;
+ state->argc = nargc;
+ state->argv = nargv;
+}
+
+/*
+ * ares_getopt --
+ * Parse argc/argv argument vector.
+ */
+int ares_getopt(ares_getopt_state_t *state, const char *ostr)
+{
+ const char *oli; /* option letter list index */
+
+ /* update scanning pointer */
+ if (!*state->place) {
+ if (state->optind >= state->argc) {
+ return -1;
+ }
+ state->place = state->argv[state->optind];
+ if (*(state->place) != '-') {
+ return -1;
+ }
+ state->place++;
+
+ /* found "--" */
+ if (*(state->place) == '-') {
+ state->optind++;
+ return -1;
+ }
+
+ /* Found just - */
+ if (!*(state->place)) {
+ state->optopt = 0;
+ return BADCH;
+ }
+ }
+
+ /* option letter okay? */
+ state->optopt = *(state->place);
+ state->place++;
+ oli = strchr(ostr, state->optopt);
+
+ if (oli == NULL) {
+ if (!(*state->place)) {
+ ++state->optind;
+ }
+ if (state->opterr) {
+ (void)fprintf(stderr, "%s: illegal option -- %c\n", __FILE__,
+ state->optopt);
+ }
+ return BADCH;
+ }
+
+ /* don't need argument */
+ if (*++oli != ':') {
+ state->optarg = NULL;
+ if (!*state->place) {
+ ++state->optind;
+ }
+ } else {
+ /* need an argument */
+ if (*state->place) { /* no white space */
+ state->optarg = state->place;
+ } else if (state->argc <= ++state->optind) { /* no arg */
+ state->place = EMSG;
+ if (*ostr == ':') {
+ return BADARG;
+ }
+ if (state->opterr) {
+ (void)fprintf(stderr, "%s: option requires an argument -- %c\n",
+ __FILE__, state->optopt);
+ }
+ return BADARG;
+ } else { /* white space */
+ state->optarg = state->argv[state->optind];
+ }
+ state->place = EMSG;
+ ++state->optind;
+ }
+ return state->optopt; /* dump back option letter */
+}
diff --git a/subprojects/c-ares/src/tools/ares_getopt.h b/subprojects/c-ares/src/tools/ares_getopt.h
@@ -0,0 +1,49 @@
+#ifndef ARES_GETOPT_H
+#define ARES_GETOPT_H
+
+/*
+ * Copyright (c) 1987-2001 The Regents of the University of California.
+ * All rights reserved.
+ *
+ * Redistribution and use in source and binary forms, with or without
+ * modification, are permitted provided that the following conditions are met:
+ *
+ * A. Redistributions of source code must retain the above copyright notice,
+ * this list of conditions and the following disclaimer.
+ * B. Redistributions in binary form must reproduce the above copyright notice,
+ * this list of conditions and the following disclaimer in the documentation
+ * and/or other materials provided with the distribution.
+ * C. Neither the names of the copyright holders nor the names of its
+ * contributors may be used to endorse or promote products derived from this
+ * software without specific prior written permission.
+ *
+ * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS ``AS
+ * IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO,
+ * THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
+ * PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE
+ * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
+ * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
+ * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+ * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
+ * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
+ * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
+ * POSSIBILITY OF SUCH DAMAGE.
+ *
+ * SPDX-License-Identifier: BSD-3-Clause
+ */
+
+
+typedef struct {
+ const char *optarg; /* argument associated with option */
+ int optind; /* index into parent argv vector */
+ int opterr; /* if error message should be printed */
+ int optopt; /* character checked for validity */
+ const char *place;
+ int argc;
+ const char **argv;
+} ares_getopt_state_t;
+
+void ares_getopt_init(ares_getopt_state_t *state, int argc, const char **argv);
+int ares_getopt(ares_getopt_state_t *state, const char *ostr);
+
+#endif /* ARES_GETOPT_H */
diff --git a/subprojects/c-ares/test/.gitignore b/subprojects/c-ares/test/.gitignore
@@ -0,0 +1,19 @@
+*.o
+libgtest.a
+libgmock.a
+arestest
+aresfuzz
+aresfuzzname
+arestest.log
+arestest.trs
+fuzzcheck.sh.log
+fuzzcheck.sh.trs
+test-suite.log
+fuzzoutput
+config.h.in
+dnsdump
+ares-libfuzzer
+ares-libfuzzer-name
+libFuzzer.a
+Fuzzer
+aminclude_static.am
diff --git a/subprojects/c-ares/test/CMakeLists.txt b/subprojects/c-ares/test/CMakeLists.txt
@@ -0,0 +1,67 @@
+# Copyright (C) The c-ares project and its contributors
+# SPDX-License-Identifier: MIT
+
+# Get rid of: warning C4530: C++ exception handler used, but unwind semantics are not enabled. Specify /EHsc
+IF (MSVC)
+ SET(CMAKE_CXX_FLAGS "${CMAKE_CXX_FLAGS} /EHsc")
+ENDIF ()
+
+find_package(Threads)
+find_package(GTest REQUIRED)
+
+# create target to access and use internal cares library
+add_library(caresinternal INTERFACE)
+target_compile_definitions(caresinternal INTERFACE HAVE_CONFIG_H=1)
+
+target_include_directories(caresinternal
+ INTERFACE "${PROJECT_BINARY_DIR}"
+ "${PROJECT_BINARY_DIR}/src/lib"
+ "${PROJECT_SOURCE_DIR}"
+ "${PROJECT_SOURCE_DIR}/src/lib"
+ "${CARES_TOPLEVEL_DIR}/include"
+ "${CMAKE_INSTALL_INCLUDEDIR}"
+)
+
+IF (CARES_STATIC)
+ target_link_libraries(caresinternal INTERFACE ${PROJECT_NAME}::cares_static)
+ELSE ()
+ target_link_libraries(caresinternal INTERFACE ${PROJECT_NAME}::cares)
+ENDIF ()
+
+transform_makefile_inc("Makefile.inc" "${CMAKE_CURRENT_BINARY_DIR}/Makefile.inc.cmake")
+include(${CMAKE_CURRENT_BINARY_DIR}/Makefile.inc.cmake)
+
+add_executable(arestest ${TESTSOURCES} ${TESTHEADERS})
+target_include_directories(arestest PRIVATE ${CMAKE_CURRENT_BINARY_DIR})
+target_link_libraries(arestest PRIVATE caresinternal GTest::gmock)
+
+IF (CARES_BUILD_CONTAINER_TESTS)
+ target_compile_definitions(arestest PRIVATE HAVE_USER_NAMESPACE HAVE_UTS_NAMESPACE)
+ENDIF ()
+
+add_executable(aresfuzz ${FUZZSOURCES})
+target_link_libraries(aresfuzz PRIVATE caresinternal)
+
+add_executable(aresfuzzname ${FUZZNAMESOURCES})
+target_link_libraries(aresfuzzname PRIVATE caresinternal)
+
+add_executable(dnsdump ${DUMPSOURCES})
+target_link_libraries(dnsdump PRIVATE caresinternal)
+
+# register tests
+
+add_test(NAME arestest COMMAND $<TARGET_FILE:arestest>)
+
+file(GLOB_RECURSE FUZZINPUT_FILES RELATIVE "${CMAKE_CURRENT_SOURCE_DIR}/fuzzinput" "fuzzinput/*")
+add_test(
+ NAME aresfuzz
+ WORKING_DIRECTORY "${CMAKE_CURRENT_SOURCE_DIR}/fuzzinput"
+ COMMAND $<TARGET_FILE:aresfuzz> ${FUZZINPUT_FILES}
+)
+
+file(GLOB_RECURSE FUZZNAMES_FILES RELATIVE "${CMAKE_CURRENT_SOURCE_DIR}/fuzznames" "fuzznames/*")
+add_test(
+ NAME aresfuzzname
+ WORKING_DIRECTORY "${CMAKE_CURRENT_SOURCE_DIR}/fuzznames"
+ COMMAND $<TARGET_FILE:aresfuzzname> ${FUZZNAMES_FILES}
+)
diff --git a/subprojects/c-ares/test/Makefile.am b/subprojects/c-ares/test/Makefile.am
@@ -0,0 +1,37 @@
+# Copyright (C) The c-ares project and its contributors
+# SPDX-License-Identifier: MIT
+AUTOMAKE_OPTIONS = foreign subdir-objects nostdinc 1.9.6
+
+AM_CPPFLAGS = -I$(top_builddir)/include \
+ -I$(top_builddir)/src/lib \
+ -I$(top_srcdir)/include \
+ -I$(top_srcdir)/src/lib \
+ -I$(top_srcdir)/test \
+ -I$(top_builddir)/test \
+ -I$(top_builddir)
+AM_CXXFLAGS = $(PTHREAD_CFLAGS)
+AM_CFLAGS = $(PTHREAD_CFLAGS)
+
+# Makefile.inc provides the various *SOURCES and *HEADERS defines
+include Makefile.inc
+
+TESTS = arestest fuzzcheck.sh
+
+noinst_PROGRAMS = arestest aresfuzz aresfuzzname dnsdump
+EXTRA_DIST = fuzzcheck.sh CMakeLists.txt Makefile.m32 Makefile.msvc README.md $(srcdir)/fuzzinput/* $(srcdir)/fuzznames/*
+arestest_SOURCES = $(TESTSOURCES) $(TESTHEADERS)
+
+# Not interested in coverage of test code, but linking the test binary needs the coverage option
+arestest_CXXFLAGS = $(GMOCK_CFLAGS)
+arestest_LDADD = $(GMOCK_LIBS) $(top_builddir)/src/lib/libcares.la $(PTHREAD_LIBS) $(CODE_COVERAGE_LIBS)
+
+aresfuzz_SOURCES = $(FUZZSOURCES)
+aresfuzz_LDADD = $(top_builddir)/src/lib/libcares.la $(PTHREAD_LIBS) $(CODE_COVERAGE_LIBS)
+
+aresfuzzname_SOURCES = $(FUZZNAMESOURCES)
+aresfuzzname_LDADD = $(top_builddir)/src/lib/libcares.la $(PTHREAD_LIBS) $(CODE_COVERAGE_LIBS)
+
+dnsdump_SOURCES = $(DUMPSOURCES)
+dnsdump_LDADD = $(top_builddir)/src/lib/libcares.la $(PTHREAD_LIBS) $(CODE_COVERAGE_LIBS)
+
+test: check
diff --git a/subprojects/c-ares/test/Makefile.inc b/subprojects/c-ares/test/Makefile.inc
@@ -0,0 +1,39 @@
+# Copyright (C) The c-ares project and its contributors
+# SPDX-License-Identifier: MIT
+TESTSOURCES = ares-test-main.cc \
+ ares-test-init.cc \
+ ares-test.cc \
+ ares-test-ns.cc \
+ ares-test-parse.cc \
+ ares-test-parse-a.cc \
+ ares-test-parse-aaaa.cc \
+ ares-test-parse-caa.cc \
+ ares-test-parse-mx.cc \
+ ares-test-parse-naptr.cc \
+ ares-test-parse-ns.cc \
+ ares-test-parse-ptr.cc \
+ ares-test-parse-soa.cc \
+ ares-test-parse-soa-any.cc \
+ ares-test-parse-srv.cc \
+ ares-test-parse-txt.cc \
+ ares-test-parse-uri.cc \
+ ares-test-misc.cc \
+ ares-test-live.cc \
+ ares-test-mock.cc \
+ ares-test-mock-ai.cc \
+ ares-test-internal.cc \
+ dns-proto.cc \
+ dns-proto-test.cc
+
+TESTHEADERS = ares-test.h \
+ dns-proto.h \
+ ares-test-ai.h
+
+FUZZSOURCES = ares-test-fuzz.c \
+ ares-fuzz.c
+
+FUZZNAMESOURCES = ares-test-fuzz-name.c \
+ ares-fuzz.c
+
+DUMPSOURCES = dns-proto.cc \
+ dns-dump.cc
diff --git a/subprojects/c-ares/test/Makefile.m32 b/subprojects/c-ares/test/Makefile.m32
@@ -0,0 +1,64 @@
+#############################################################
+# Copyright (C) The c-ares project and its contributors
+# SPDX-License-Identifier: MIT
+#
+# Makefile for building arestest.exe with MingW32 (GCC-3.2)
+# Use: make -f Makefile.m32 GTEST_ROOT=....
+#
+########################################################
+CXX = g++
+CC = gcc
+LD = g++
+
+ifeq "$(GTEST_ROOT)" ""
+ $(error missing GTEST_ROOT)
+endif
+
+# Where to find the c-ares source code; needed because the tests use library-internal headers
+ARES_SRC_DIR = ..
+# Where to find the built c-ares static library
+ARES_BLD_DIR = ..
+ARESLIB = $(ARES_BLD_DIR)/src/lib/libcares.a
+CPPFLAGS = -I$(ARES_SRC_DIR)/include -I$(ARES_SRC_DIR)/src/lib -I$(GTEST_ROOT)/include -DCARES_STATICLIB
+CXXFLAGS = -Wall $(PTHREAD_CFLAGS) -std=gnu++14
+LDFLAGS =
+LDLIBS = -lws2_32 -liphlpapi
+
+# Makefile.inc provides the TESTSOURCES and TESTHEADERS defines
+include Makefile.inc
+
+OBJS := $(patsubst %.cc,%.o,$(strip $(TESTSOURCES)))
+FUZZOBJS := $(patsubst %.c,%.o,$(strip $(FUZZSOURCES)))
+FUZZNAMEOBJS := $(patsubst %.c,%.o,$(strip $(FUZZNAMESOURCES)))
+DNSDUMPOBJS := $(patsubst %.cc,%.o,$(strip $(DUMPSOURCES)))
+
+all: arestest.exe aresfuzz.exe aresfuzzname.exe dnsdump.exe
+
+arestest.exe: $(OBJS)
+ $(LD) $(LDFLAGS) -o $@ $^ -L$(ARES_BLD_DIR)/src/lib -lcares $(LDLIBS) -L$(GTEST_ROOT)/lib -lgmock -lgtest
+
+aresfuzz.exe: $(FUZZOBJS)
+ $(LD) $(LDFLAGS) -o $@ $^ -L$(ARES_BLD_DIR)/src/lib -lcares $(LDLIBS)
+
+aresfuzzname.exe: $(FUZZNAMEOBJS)
+ $(LD) $(LDFLAGS) -o $@ $^ -L$(ARES_BLD_DIR)/src/lib -lcares $(LDLIBS)
+
+dnsdump.exe: $(DNSDUMPOBJS)
+ $(LD) $(LDFLAGS) -o $@ $^ -L$(ARES_BLD_DIR)/src/lib -lcares $(LDLIBS)
+
+$(OBJS): $(TESTHEADERS)
+
+.cc.o:
+ $(CXX) $(CPPFLAGS) $(CXXFLAGS) -c $<
+.c.o:
+ $(CC) $(CPPFLAGS) $(CFLAGS) -c $<
+
+test: arestest.exe
+ ./arestest.exe --gtest_filter=-*LiveSearchTXT*:*LiveSearchANY*:*LiveGetLocalhostByAddr*
+vtest: arestest.exe
+ ./arestest.exe -v --gtest_filter=-*LiveSearchTXT*:*LiveSearchANY*:*LiveGetLocalhostByAddr*
+
+clean:
+ $(RM) $(OBJS) arestest.exe aresfuzz.exe aresfuzzname.exe dnsdump.exe
+
+
diff --git a/subprojects/c-ares/test/Makefile.msvc b/subprojects/c-ares/test/Makefile.msvc
@@ -0,0 +1,341 @@
+# Copyright (C) The c-ares project and its contributors
+# SPDX-License-Identifier: MIT
+#
+# Permission to use, copy, modify, and distribute this
+# software and its documentation for any purpose and without
+# fee is hereby granted, provided that the above copyright
+# notice appear in all copies and that both that copyright
+# notice and this permission notice appear in supporting
+# documentation, and that the name of M.I.T. not be used in
+# advertising or publicity pertaining to distribution of the
+# software without specific, written prior permission.
+# M.I.T. makes no representations about the suitability of
+# this software for any purpose. It is provided "as is"
+# without express or implied warranty.
+
+# ------------------------------------------------------------------------------
+#
+# Makefile for building c-ares test suite with MSVC.
+#
+# Usage: nmake /f makefile.msvc CFG=<config> <target>
+#
+# <config> can be one of: [ lib-release | lib-debug | dll-release | dll-debug }
+# <target> can be one of: [ all | arestest | clean }
+#
+# If <target> is not specified then all targets are built.
+# If <config> is not specified then lib-debug will be assumed.
+#
+# This makefile must be processed from the subdir where it is located.
+#
+# All results are generated below a subdirectory named msvcXXX.
+#
+# ------------------------------------------------------------------------------
+
+
+# ------------------------------------------------
+# c-ares static and dynamic libraries common base
+# file names for release and debug configurations
+# ------------------------------------------------
+
+LIBNAME = cares
+STA_LIB_REL = lib$(LIBNAME)
+DYN_LIB_REL = $(LIBNAME)
+STA_LIB_DBG = $(STA_LIB_REL)d
+DYN_LIB_DBG = $(DYN_LIB_REL)d
+
+# -------------------------------------------
+# Base names for c-ares DLL import libraries
+# -------------------------------------------
+
+IMP_LIB_REL = $(DYN_LIB_REL)
+IMP_LIB_DBG = $(DYN_LIB_DBG)
+
+# --------------------------
+# Runtime library selection
+# --------------------------
+
+RTLIB = /MD
+RTLIBD = /MDd
+
+!IF "$(RTLIBCFG)" == "static"
+RTLIB = /MT
+RTLIBD = /MTd
+!ENDIF
+
+# --------------------------------------------------------
+# Detect compiler version.
+# --------------------------------------------------------
+!INCLUDE ..\msvc_ver.inc
+
+# ---------------------------------------------------------
+# Verify that current subdir is below the c-ares source one
+# ---------------------------------------------------------
+
+!IF ! EXIST(..\src\lib\ares_init.c)
+! MESSAGE Can not process Makefile.msvc from outside of c-ares test subdirectory.
+! MESSAGE Change to the subdirectory where Makefile.msvc is found, and try again.
+! ERROR See previous message.
+!ENDIF
+
+# ------------------------------------------------------------------
+# Base subdir is the common root from which other subdirs will hang,
+# the name depends on MSVC version being used when building c-ares.
+# ------------------------------------------------------------------
+
+BASE_DIR = .\msvc
+# Look for a built library of the same configuration in the directory above.
+LIB_BASE_DIR = ..\msvc
+
+# ----------------------------------------
+# Subdir holding sources for all projects
+# ----------------------------------------
+
+SRCDIR = .
+
+# -------------------------
+# Configuration validation
+# -------------------------
+
+!IF "$(CFG)" == ""
+CFG = lib-debug
+!ENDIF
+
+VALID_CFGSET = FALSE
+!IF "$(CFG)" == "lib-release" || "$(CFG)" == "lib-debug" || \
+ "$(CFG)" == "dll-release" || "$(CFG)" == "dll-debug"
+VALID_CFGSET = TRUE
+!ENDIF
+
+!IF "$(VALID_CFGSET)" == "FALSE"
+! MESSAGE MSVC c-ares makefile
+! MESSAGE
+! MESSAGE Usage: nmake /f makefile.msvc CFG=<config> GTEST_ROOT=<google-test-install> <target>
+! MESSAGE
+! MESSAGE <config> can be one of: [ lib-release | lib-debug | dll-release | dll-debug }
+! MESSAGE <target> can be one of: [ all | arestest | aresfuzz | aresfuzzname | dnsdump | clean }
+! MESSAGE
+! MESSAGE If <target> is not specified then all targets are built.
+! MESSAGE If <config> is not specified then lib-debug will be assumed.
+! MESSAGE
+! ERROR Choose a valid configuration.
+!ENDIF
+
+!IF "$(GTEST_ROOT)" == ""
+! ERROR Missing GTEST_ROOT
+!ENDIF
+
+# --------------------------------------------------------
+# Project subdirs independent of configuration being used
+# --------------------------------------------------------
+
+PROG_DIR = $(BASE_DIR)\arestest
+LIB_DIR = $(LIB_BASE_DIR)\cares
+
+# ---------------------------------------------------
+# Subdirs which are configuration dependent are only
+# defined when a valid configuration has been given.
+# ---------------------------------------------------
+
+PROG_OUTDIR = $(PROG_DIR)\$(CFG)
+PROG_OBJDIR = $(PROG_OUTDIR)\obj
+LIB_OUTDIR = $(LIB_DIR)\$(CFG)
+
+
+# -------------------------------------
+# TCP/IP stack settings
+# -------------------------------------
+CFLAGS = /DWIN32
+EX_LIBS_REL = ws2_32.lib advapi32.lib kernel32.lib iphlpapi.lib
+EX_LIBS_DBG = ws2_32.lib advapi32.lib kernel32.lib iphlpapi.lib
+
+# -------------------------------------------------
+# Switches that depend on ancient compiler versions
+# -------------------------------------------------
+
+!IF $(CC_VERS_NUM) == 60
+PDB_NONE = /pdb:none
+PDBTYPE_CONSOLIDATE = /pdbtype:consolidate
+!ELSE
+!UNDEF PDB_NONE
+!UNDEF PDBTYPE_CONSOLIDATE
+!ENDIF
+
+!IF $(CC_VERS_NUM) <= 70
+RT_ERROR_CHECKING = /GZ
+!ELSE
+RT_ERROR_CHECKING = /RTCsu
+!ENDIF
+
+# ----------------------------
+# Assorted commands and flags
+# ----------------------------
+
+CC_CMD_REL = cl.exe /nologo $(RTLIB) /DNDEBUG /O2 /D_CRT_NONSTDC_NO_DEPRECATE /D_CRT_SECURE_NO_WARNINGS
+CC_CMD_DBG = cl.exe /nologo $(RTLIBD) /D_DEBUG /Od /Zi /D_CRT_NONSTDC_NO_DEPRECATE /D_CRT_SECURE_NO_WARNINGS $(RT_ERROR_CHECKING)
+CC_CFLAGS = $(CFLAGS) /I. /I../src/lib /I../include /I $(GTEST_ROOT)/include /W3 /EHsc /FD
+
+RC_CMD_REL = rc.exe /l 0x409 /d "NDEBUG"
+RC_CMD_DBG = rc.exe /l 0x409 /d "_DEBUG"
+
+LINK_CMD_LIB = link.exe /lib /nologo
+LINK_CMD_DLL = link.exe /dll /nologo /incremental:no /fixed:no
+LINK_CMD_EXE = link.exe /nologo /incremental:no /fixed:no /subsystem:console
+
+LINK_CMD_EXE_REL = $(LINK_CMD_EXE) /release $(PDB_NONE)
+LINK_CMD_EXE_DBG = $(LINK_CMD_EXE) /debug $(PDBTYPE_CONSOLIDATE)
+
+# ---------------------------------
+# Configuration dependent settings
+# ---------------------------------
+
+!IF "$(CFG)" == "lib-release"
+CARES_TARGET = $(STA_LIB_REL).lib
+CARES_CFLAGS = /DCARES_BUILDING_LIBRARY /DCARES_STATICLIB
+CARES_LFLAGS =
+SPROG_CFLAGS = /DCARES_STATICLIB
+SPROG_LFLAGS = /libpath:$(LIB_OUTDIR) $(EX_LIBS_REL) $(STA_LIB_REL).lib
+CARES_LINK = $(LINK_CMD_LIB)
+SPROG_LINK = $(LINK_CMD_EXE_REL)
+CC_CMD = $(CC_CMD_REL)
+!ENDIF
+
+!IF "$(CFG)" == "lib-debug"
+CARES_TARGET = $(STA_LIB_DBG).lib
+CARES_CFLAGS = /DCARES_BUILDING_LIBRARY /DCARES_STATICLIB /DDEBUGBUILD
+CARES_LFLAGS =
+SPROG_CFLAGS = /DCARES_STATICLIB
+SPROG_LFLAGS = /libpath:$(LIB_OUTDIR) $(EX_LIBS_DBG) $(STA_LIB_DBG).lib
+CARES_LINK = $(LINK_CMD_LIB)
+SPROG_LINK = $(LINK_CMD_EXE_DBG)
+CC_CMD = $(CC_CMD_DBG)
+!ENDIF
+
+!IF "$(CFG)" == "dll-release"
+CARES_TARGET = $(DYN_LIB_REL).dll
+CARES_CFLAGS = /DCARES_BUILDING_LIBRARY
+CARES_LFLAGS = /release $(EX_LIBS_REL) /implib:$(PROG_OUTDIR)\$(IMP_LIB_REL).lib $(PDB_NONE)
+SPROG_CFLAGS =
+SPROG_LFLAGS = /libpath:$(LIB_OUTDIR) $(EX_LIBS_REL) $(IMP_LIB_REL).lib
+CARES_LINK = $(LINK_CMD_DLL)
+SPROG_LINK = $(LINK_CMD_EXE_REL)
+CC_CMD = $(CC_CMD_REL)
+USE_RES_FILE = TRUE
+RC_CMD = $(RC_CMD_REL)
+!ENDIF
+
+!IF "$(CFG)" == "dll-debug"
+CARES_TARGET = $(DYN_LIB_DBG).dll
+CARES_CFLAGS = /DCARES_BUILDING_LIBRARY /DDEBUGBUILD
+CARES_LFLAGS = /debug $(EX_LIBS_DBG) /implib:$(PROG_OUTDIR)\$(IMP_LIB_DBG).lib /pdb:$(PROG_OUTDIR)\$(DYN_LIB_DBG).pdb $(PDBTYPE_CONSOLIDATE)
+SPROG_CFLAGS =
+SPROG_LFLAGS = /libpath:$(LIB_OUTDIR) $(EX_LIBS_DBG) $(IMP_LIB_DBG).lib
+CARES_LINK = $(LINK_CMD_DLL)
+SPROG_LINK = $(LINK_CMD_EXE_DBG)
+CC_CMD = $(CC_CMD_DBG)
+USE_RES_FILE = TRUE
+RC_CMD = $(RC_CMD_DBG)
+!ENDIF
+
+# --------------------------------------------
+# Makefile.inc provides lists of source files
+# --------------------------------------------
+
+!INCLUDE .\Makefile.inc
+
+# ----------------------------
+# Build lists of object files
+# ----------------------------
+
+!IF [ECHO PROG_OBJS=^$(PROG_OBJDIR)\$(TESTSOURCES: = $(PROG_OBJDIR^)\) > .\prog_objs.inc] == 0
+!INCLUDE .\prog_objs.inc
+!IF [DEL .\prog_objs.inc]
+!ENDIF
+!ELSE
+!ERROR Problem generating PROG_OBJS list.
+!ENDIF
+PROG_OBJS = $(PROG_OBJS:.cc=.obj)
+
+!IF [ECHO FUZZ_OBJS=^$(PROG_OBJDIR)\$(FUZZSOURCES: = $(PROG_OBJDIR^)\) > .\fuzz_objs.inc] == 0
+!INCLUDE .\fuzz_objs.inc
+!IF [DEL .\fuzz_objs.inc]
+!ENDIF
+!ELSE
+!ERROR Problem generating FUZZ_OBJS list.
+!ENDIF
+FUZZ_OBJS = $(FUZZ_OBJS:.c=.obj)
+
+!IF [ECHO FUZZNAME_OBJS=^$(PROG_OBJDIR)\$(FUZZNAMESOURCES: = $(PROG_OBJDIR^)\) > .\fuzzname_objs.inc] == 0
+!INCLUDE .\fuzzname_objs.inc
+!IF [DEL .\fuzzname_objs.inc]
+!ENDIF
+!ELSE
+!ERROR Problem generating FUZZNAME_OBJS list.
+!ENDIF
+FUZZNAME_OBJS = $(FUZZNAME_OBJS:.c=.obj)
+
+!IF [ECHO DNSDUMP_OBJS=^$(PROG_OBJDIR)\$(DUMPSOURCES: = $(PROG_OBJDIR^)\) > .\dnsdump_objs.inc] == 0
+!INCLUDE .\dnsdump_objs.inc
+!IF [DEL .\dnsdump_objs.inc]
+!ENDIF
+!ELSE
+!ERROR Problem generating DNSDUMP_OBJS list.
+!ENDIF
+DNSDUMP_OBJS = $(DNSDUMP_OBJS:.cc=.obj)
+
+# --------------------------------
+# Only our custom inference rules
+# --------------------------------
+
+.SUFFIXES:
+.SUFFIXES: .cc .c
+
+{$(SRCDIR)}.cc{$(PROG_OBJDIR)}.obj:
+ $(CC_CMD) $(CC_CFLAGS) $(SPROG_CFLAGS) /Fo$@ /Fd$(@D)\ /c $<
+{$(SRCDIR)}.c{$(PROG_OBJDIR)}.obj:
+ $(CC_CMD) $(CC_CFLAGS) $(SPROG_CFLAGS) /Fo$@ /Fd$(@D)\ /c $<
+
+
+# ---------------------------------------------------------------------
+# Main targets
+# ---------------------------------------------------------------------
+
+ALL: arestest aresfuzz aresfuzzname dnsdump
+ @
+
+test: arestest
+ $(PROG_OUTDIR)\arestest -4 --gtest_filter=-*LiveSearchTXT*:*LiveSearchANY*:*LiveGetLocalhostByAddr*
+vtest: arestest
+ $(PROG_OUTDIR)\arestest -4 -v --gtest_filter=-*LiveSearchTXT*:*LiveSearchANY*:*LiveGetLocalhostByAddr*
+
+arestest: $(TESTSOURCES) $(PROG_OUTDIR) $(PROG_OBJDIR) $(PROG_OBJS)
+ $(SPROG_LINK) $(SPROG_LFLAGS) /out:$(PROG_OUTDIR)\arestest.exe $(PROG_OBJS) $(GTEST_ROOT)/lib/gmock.lib
+ @if exist $(PROG_OUTDIR)\arestest.exe.manifest mt -nologo -manifest $(PROG_OUTDIR)\arestest.exe.manifest -outputresource:$(PROG_OUTDIR)\arestest.exe;1
+
+aresfuzz: $(FUZZSOURCES) $(PROG_OUTDIR) $(PROG_OBJDIR) $(FUZZ_OBJS)
+ $(SPROG_LINK) $(SPROG_LFLAGS) /out:$(PROG_OUTDIR)\aresfuzz.exe $(FUZZ_OBJS)
+ @if exist $(PROG_OUTDIR)\aresfuzz.exe.manifest mt -nologo -manifest $(PROG_OUTDIR)\aresfuzz.exe.manifest -outputresource:$(PROG_OUTDIR)\aresfuzz.exe;1
+
+aresfuzzname: $(FUZZNAMESOURCES) $(PROG_OUTDIR) $(PROG_OBJDIR) $(FUZZNAME_OBJS)
+ $(SPROG_LINK) $(SPROG_LFLAGS) /out:$(PROG_OUTDIR)\aresfuzzname.exe $(FUZZNAME_OBJS)
+ @if exist $(PROG_OUTDIR)\aresfuzzname.exe.manifest mt -nologo -manifest $(PROG_OUTDIR)\aresfuzzname.exe.manifest -outputresource:$(PROG_OUTDIR)\aresfuzzname.exe;1
+
+dnsdump: $(DUMPSOURCES) $(PROG_OUTDIR) $(PROG_OBJDIR) $(DNSDUMP_OBJS)
+ $(SPROG_LINK) $(SPROG_LFLAGS) /out:$(PROG_OUTDIR)\dnsdump.exe $(DNSDUMP_OBJS)
+ @if exist $(PROG_OUTDIR)\dnsdump.exe.manifest mt -nologo -manifest $(PROG_OUTDIR)\dnsdump.exe.manifest -outputresource:$(PROG_OUTDIR)\dnsdump.exe;1
+
+$(PROG_OUTDIR): $(PROG_DIR)
+ @if not exist $(PROG_OUTDIR) mkdir $(PROG_OUTDIR)
+
+$(PROG_OBJDIR): $(PROG_OUTDIR)
+ @if not exist $(PROG_OBJDIR) mkdir $(PROG_OBJDIR)
+
+clean:
+ @-RMDIR /S /Q $(PROG_OUTDIR) >NUL 2>&1
+
+$(BASE_DIR):
+ @if not exist $(BASE_DIR) mkdir $(BASE_DIR)
+
+$(PROG_DIR): $(BASE_DIR)
+ @if not exist $(PROG_DIR) mkdir $(PROG_DIR)
+
+# End of Makefile.msvc
diff --git a/subprojects/c-ares/test/README.md b/subprojects/c-ares/test/README.md
@@ -0,0 +1,152 @@
+c-ares Unit Test Suite
+======================
+
+This directory holds unit tests for the c-ares library. To build the tests:
+
+ - Build the main c-ares library first, in the directory above this. To
+ enable tests of internal functions, configure the library build to expose
+ hidden symbols with `./configure --disable-symbol-hiding`.
+ - Generate a `configure` file by running `autoreconf -iv` (which requires
+ a local installation of
+ [autotools](https://www.gnu.org/software/automake/manual/html_node/Autotools-Introduction.html)).
+ - `./configure`
+ - `make`
+ - Run the tests with `./arestest`, or `./arestest -v` for extra debug info.
+
+Points to note:
+
+ - The tests are written in C++11, and so need a C++ compiler that supports
+ this. To avoid adding this as a requirement for the library, the
+ configuration and build of the tests is independent from the library.
+ - The tests include some live queries, which will fail when run on a machine
+ without internet connectivity. To skip live tests, run with
+ `./arestest --gtest_filter=-*.Live*`.
+ - The tests include queries of a mock DNS server. This server listens on port
+ 5300 by default, but the port can be changed with the `-p 5300` option to
+ `arestest`.
+
+
+Test Types
+----------
+
+The test suite includes various different types of test.
+
+ - There are live tests (`ares-test-live.cc`), which assume that the
+ current machine has a valid DNS setup and connection to the
+ internet; these tests issue queries for real domains but don't
+ particularly check what gets returned. The tests will fail on
+ an offline machine.
+ - There are some mock tests (`ares-test-mock.cc`) that set up a fake DNS
+ server and inject its port into the c-ares library configuration.
+ These tests allow specific response messages to be crafted and
+ injected, and so are likely to be used for many more tests in
+ future.
+ - To make this generation/injection easier, the `dns-proto.h`
+ file includes C++ helper classes for building DNS packets.
+ - Other library entrypoints that don't require network activity
+ (e.g. `ares_parse_*_reply`) are tested directly.
+ - A couple of the tests use a helper method of the test fixture to
+ inject memory allocation failures, using a recent change to the
+ c-ares library that allows override of `malloc`/`free`.
+ - There are some tests of the internal entrypoints of the library
+ (`ares-test-internal.c`), but these are only enabled if the library
+ was configured with `--disable-symbol-hiding` and/or
+ `--enable-expose-statics`.
+ - There is also an entrypoint to allow Clang's
+ [libfuzzer](http://llvm.org/docs/LibFuzzer.html) to drive
+ the packet parsing code in `ares_parse_*_reply`, together with a
+ standalone wrapper for it (`./aresfuzz`) to allow use of command
+ line fuzzers (such as [afl-fuzz](http://lcamtuf.coredump.cx/afl/))
+ for further [fuzz testing](#fuzzing).
+
+
+Code Coverage Information
+-------------------------
+
+To generate code coverage information:
+
+ - Configure both the library and the tests with `./configure
+ --enable-code-coverage` before building. This requires the relevant code
+ coverage tools ([gcov](https://gcc.gnu.org/onlinedocs/gcc/Gcov.html),
+ [lcov](http://ltp.sourceforge.net/coverage/lcov.php)) to be installed locally.
+ - Run the tests with `test/arestest`.
+ - Generate code coverage output with `make code-coverage-capture` in the
+ library directory (i.e. not in `test/`).
+
+
+Fuzzing
+-------
+
+### libFuzzer
+
+To fuzz the packet parsing code with libFuzzer, follow the main
+[libFuzzer instructions](http://llvm.org/docs/LibFuzzer.html):
+
+ - Configure the c-ares library and test suite with a recent Clang and a sanitizer, for example:
+
+ ```console
+ % export CFLAGS="-fsanitize=fuzzer-no-link,address"
+ % export CC=clang
+ % ./configure --disable-shared && make
+ ```
+ - Link each of the fuzzer entrypoints in with `ares-fuzz.cc`:
+
+ ```
+ % clang -I.. -c ares-test-fuzz.c
+ % clang -I.. -c ares-test-fuzz-name.c
+ % clang++ -fsanitize=fuzzer,address ares-test-fuzz.o ../.libs/libcares.a -o ares-libfuzzer
+ % clang++ -fsanitize=fuzzer,address ares-test-fuzz-name.o ../.libs/libcares.a -o ares-libfuzzer-name
+ ```
+ - Run the fuzzer using the starting corpus with:
+
+ ```console
+ % ./ares-libfuzzer fuzzinput/ # OR
+ % ./ares-libfuzzer-name fuzznames/
+ ```
+
+### AFL
+
+To fuzz using AFL, follow the
+[AFL quick start guide](http://lcamtuf.coredump.cx/afl/QuickStartGuide.txt):
+
+ - Download and build AFL.
+ - Configure the c-ares library and test tool to use AFL's compiler wrappers:
+
+ ```console
+ % export CC=$AFLDIR/afl-gcc
+ % ./configure --disable-shared && make
+ % cd test && ./configure && make aresfuzz aresfuzzname
+ ```
+
+ - Run the AFL fuzzer against the starting corpus:
+
+ ```console
+ % mkdir fuzzoutput
+ % $AFLDIR/afl-fuzz -i fuzzinput -o fuzzoutput -- ./aresfuzz # OR
+ % $AFLDIR/afl-fuzz -i fuzznames -o fuzzoutput -- ./aresfuzzname
+ ```
+
+### AFL Persistent Mode
+
+If a recent version of Clang is available, AFL can use its built-in compiler
+instrumentation; this configuration also allows the use of a (much) faster
+persistent mode, where multiple fuzz inputs are run for each process invocation.
+
+ - Download and build a recent AFL, and run `make` in the `llvm_mode`
+ subdirectory to ensure that `afl-clang-fast` gets built.
+ - Configure the c-ares library and test tool to use AFL's clang wrappers that
+ use compiler instrumentation:
+
+ ```console
+ % export CC=$AFLDIR/afl-clang-fast
+ % ./configure --disable-shared && make
+ % cd test && ./configure && make aresfuzz
+ ```
+
+ - Run the AFL fuzzer (in persistent mode) against the starting corpus:
+
+ ```console
+ % mkdir fuzzoutput
+ % $AFLDIR/afl-fuzz -i fuzzinput -o fuzzoutput -- ./aresfuzz
+ ```
+
diff --git a/subprojects/c-ares/test/ares-fuzz.c b/subprojects/c-ares/test/ares-fuzz.c
@@ -0,0 +1,86 @@
+/*
+ * Copyright (C) The c-ares project
+ *
+ * Permission to use, copy, modify, and distribute this
+ * software and its documentation for any purpose and without
+ * fee is hereby granted, provided that the above copyright
+ * notice appear in all copies and that both that copyright
+ * notice and this permission notice appear in supporting
+ * documentation, and that the name of M.I.T. not be used in
+ * advertising or publicity pertaining to distribution of the
+ * software without specific, written prior permission.
+ * M.I.T. makes no representations about the suitability of
+ * this software for any purpose. It is provided "as is"
+ * without express or implied warranty.
+ *
+ * SPDX-License-Identifier: MIT
+ */
+/*
+ * General driver to allow command-line fuzzer (i.e. afl) to
+ * exercise the libFuzzer entrypoint.
+ */
+
+#include <sys/types.h>
+#include <fcntl.h>
+#include <stdio.h>
+#include <stdlib.h>
+#include <string.h>
+#ifdef WIN32
+# include <io.h>
+#else
+# include <unistd.h>
+#endif
+
+#include "ares.h"
+
+#define kMaxAflInputSize (1 << 20)
+static unsigned char afl_buffer[kMaxAflInputSize];
+
+#ifdef __AFL_LOOP
+/* If we are built with afl-clang-fast, use persistent mode */
+# define KEEP_FUZZING(count) __AFL_LOOP(1000)
+#else
+/* If we are built with afl-clang, execute each input once */
+# define KEEP_FUZZING(count) ((count) < 1)
+#endif
+
+/* In ares-test-fuzz.c and ares-test-fuzz-name.c: */
+int LLVMFuzzerTestOneInput(const unsigned char *data, unsigned long size);
+
+static void ProcessFile(int fd)
+{
+ ares_ssize_t count = read(fd, afl_buffer, kMaxAflInputSize);
+ /*
+ * Make a copy of the data so that it's not part of a larger
+ * buffer (where buffer overflows would go unnoticed).
+ */
+ if (count > 0) {
+ unsigned char *copied_data = (unsigned char *)malloc((size_t)count);
+ memcpy(copied_data, afl_buffer, (size_t)count);
+ LLVMFuzzerTestOneInput(copied_data, (size_t)count);
+ free(copied_data);
+ }
+}
+
+int main(int argc, char *argv[])
+{
+ if (argc == 1) {
+ int count = 0;
+ while (KEEP_FUZZING(count)) {
+ ProcessFile(fileno(stdin));
+ count++;
+ }
+ } else {
+ int ii;
+ for (ii = 1; ii < argc; ++ii) {
+ int fd = open(argv[ii], O_RDONLY);
+ if (fd < 0) {
+ fprintf(stderr, "Failed to open '%s'\n", argv[ii]);
+ continue;
+ }
+ ProcessFile(fd);
+ close(fd);
+ }
+ }
+ return 0;
+}
diff --git a/subprojects/c-ares/test/ares-test-ai.h b/subprojects/c-ares/test/ares-test-ai.h
@@ -0,0 +1,80 @@
+/*
+ * Copyright (C) The c-ares project
+ *
+ * Permission to use, copy, modify, and distribute this
+ * software and its documentation for any purpose and without
+ * fee is hereby granted, provided that the above copyright
+ * notice appear in all copies and that both that copyright
+ * notice and this permission notice appear in supporting
+ * documentation, and that the name of M.I.T. not be used in
+ * advertising or publicity pertaining to distribution of the
+ * software without specific, written prior permission.
+ * M.I.T. makes no representations about the suitability of
+ * this software for any purpose. It is provided "as is"
+ * without express or implied warranty.
+ *
+ * SPDX-License-Identifier: MIT
+ */
+#ifndef ARES_TEST_AI_H
+#define ARES_TEST_AI_H
+
+#include <utility>
+#include "gtest/gtest.h"
+#include "gmock/gmock.h"
+#include "ares-test.h"
+
+namespace ares {
+namespace test {
+
+class MockChannelTestAI
+ : public MockChannelOptsTest,
+ public ::testing::WithParamInterface<std::pair<int, bool>> {
+public:
+ MockChannelTestAI()
+ : MockChannelOptsTest(1, GetParam().first, GetParam().second, nullptr, 0)
+ {
+ }
+};
+
+class MockUDPChannelTestAI : public MockChannelOptsTest,
+ public ::testing::WithParamInterface<int> {
+public:
+ MockUDPChannelTestAI() : MockChannelOptsTest(1, GetParam(), false, nullptr, 0)
+ {
+ }
+};
+
+class MockTCPChannelTestAI : public MockChannelOptsTest,
+ public ::testing::WithParamInterface<int> {
+public:
+ MockTCPChannelTestAI() : MockChannelOptsTest(1, GetParam(), true, nullptr, 0)
+ {
+ }
+};
+
+// Test fixture that uses a default channel.
+class DefaultChannelTestAI : public LibraryTest {
+public:
+ DefaultChannelTestAI() : channel_(nullptr)
+ {
+ EXPECT_EQ(ARES_SUCCESS, ares_init(&channel_));
+ EXPECT_NE(nullptr, channel_);
+ }
+
+ ~DefaultChannelTestAI()
+ {
+ ares_destroy(channel_);
+ channel_ = nullptr;
+ }
+
+ // Process all pending work on ares-owned file descriptors.
+ void Process();
+
+protected:
+ ares_channel_t *channel_;
+};
+
+} // namespace test
+} // namespace ares
+
+#endif
diff --git a/subprojects/c-ares/test/ares-test-fuzz-name.c b/subprojects/c-ares/test/ares-test-fuzz-name.c
@@ -0,0 +1,42 @@
+/*
+ * Copyright (C) The c-ares project
+ *
+ * Permission to use, copy, modify, and distribute this
+ * software and its documentation for any purpose and without
+ * fee is hereby granted, provided that the above copyright
+ * notice appear in all copies and that both that copyright
+ * notice and this permission notice appear in supporting
+ * documentation, and that the name of M.I.T. not be used in
+ * advertising or publicity pertaining to distribution of the
+ * software without specific, written prior permission.
+ * M.I.T. makes no representations about the suitability of
+ * this software for any purpose. It is provided "as is"
+ * without express or implied warranty.
+ *
+ * SPDX-License-Identifier: MIT
+ */
+#include <stddef.h>
+#include <stdlib.h>
+#include <string.h>
+
+#include "ares.h"
+// Include ares internal file for DNS protocol constants
+#include "ares_nameser.h"
+
+int LLVMFuzzerTestOneInput(const unsigned char *data, unsigned long size);
+
+// Entrypoint for Clang's libfuzzer, exercising query creation.
+int LLVMFuzzerTestOneInput(const unsigned char *data, unsigned long size)
+{
+ // Null terminate the data.
+ char *name = malloc(size + 1);
+ unsigned char *buf = NULL;
+ int buflen = 0;
+ name[size] = '\0';
+ memcpy(name, data, size);
+
+ ares_create_query(name, C_IN, T_AAAA, 1234, 0, &buf, &buflen, 1024);
+ free(buf);
+ free(name);
+ return 0;
+}
diff --git a/subprojects/c-ares/test/ares-test-fuzz.c b/subprojects/c-ares/test/ares-test-fuzz.c
@@ -0,0 +1,100 @@
+/*
+ * Copyright (C) The c-ares project
+ *
+ * Permission to use, copy, modify, and distribute this
+ * software and its documentation for any purpose and without
+ * fee is hereby granted, provided that the above copyright
+ * notice appear in all copies and that both that copyright
+ * notice and this permission notice appear in supporting
+ * documentation, and that the name of M.I.T. not be used in
+ * advertising or publicity pertaining to distribution of the
+ * software without specific, written prior permission.
+ * M.I.T. makes no representations about the suitability of
+ * this software for any purpose. It is provided "as is"
+ * without express or implied warranty.
+ *
+ * SPDX-License-Identifier: MIT
+ */
+#include <stddef.h>
+
+#include "ares.h"
+
+int LLVMFuzzerTestOneInput(const unsigned char *data, unsigned long size);
+
+// Entrypoint for Clang's libfuzzer
+int LLVMFuzzerTestOneInput(const unsigned char *data, unsigned long size)
+{
+ // Feed the data into each of the ares_parse_*_reply functions.
+ struct hostent *host = NULL;
+ struct ares_addrttl info[5];
+ struct ares_addr6ttl info6[5];
+ unsigned char addrv4[4] = { 0x10, 0x20, 0x30, 0x40 };
+ struct ares_srv_reply *srv = NULL;
+ struct ares_mx_reply *mx = NULL;
+ struct ares_txt_reply *txt = NULL;
+ struct ares_soa_reply *soa = NULL;
+ struct ares_naptr_reply *naptr = NULL;
+ struct ares_caa_reply *caa = NULL;
+ struct ares_uri_reply *uri = NULL;
+ int count = 5;
+ ares_parse_a_reply(data, (int)size, &host, info, &count);
+ if (host) {
+ ares_free_hostent(host);
+ }
+
+ host = NULL;
+ count = 5;
+ ares_parse_aaaa_reply(data, (int)size, &host, info6, &count);
+ if (host) {
+ ares_free_hostent(host);
+ }
+
+ host = NULL;
+ ares_parse_ptr_reply(data, (int)size, addrv4, sizeof(addrv4), AF_INET, &host);
+ if (host) {
+ ares_free_hostent(host);
+ }
+
+ host = NULL;
+ ares_parse_ns_reply(data, (int)size, &host);
+ if (host) {
+ ares_free_hostent(host);
+ }
+
+ ares_parse_srv_reply(data, (int)size, &srv);
+ if (srv) {
+ ares_free_data(srv);
+ }
+
+ ares_parse_mx_reply(data, (int)size, &mx);
+ if (mx) {
+ ares_free_data(mx);
+ }
+
+ ares_parse_txt_reply(data, (int)size, &txt);
+ if (txt) {
+ ares_free_data(txt);
+ }
+
+ ares_parse_soa_reply(data, (int)size, &soa);
+ if (soa) {
+ ares_free_data(soa);
+ }
+
+ ares_parse_naptr_reply(data, (int)size, &naptr);
+ if (naptr) {
+ ares_free_data(naptr);
+ }
+
+ ares_parse_caa_reply(data, (int)size, &caa);
+ if (caa) {
+ ares_free_data(caa);
+ }
+
+ ares_parse_uri_reply(data, (int)size, &uri);
+ if (uri) {
+ ares_free_data(uri);
+ }
+
+ return 0;
+}
diff --git a/subprojects/c-ares/test/ares-test-init.cc b/subprojects/c-ares/test/ares-test-init.cc
@@ -0,0 +1,711 @@
+/*
+ * Copyright (C) The c-ares project
+ *
+ * Permission to use, copy, modify, and distribute this
+ * software and its documentation for any purpose and without
+ * fee is hereby granted, provided that the above copyright
+ * notice appear in all copies and that both that copyright
+ * notice and this permission notice appear in supporting
+ * documentation, and that the name of M.I.T. not be used in
+ * advertising or publicity pertaining to distribution of the
+ * software without specific, written prior permission.
+ * M.I.T. makes no representations about the suitability of
+ * this software for any purpose. It is provided "as is"
+ * without express or implied warranty.
+ *
+ * SPDX-License-Identifier: MIT
+ */
+#include "ares-test.h"
+
+extern "C" {
+ #include "ares_private.h"
+}
+
+// library initialization is only needed for windows builds
+#ifdef WIN32
+#define EXPECTED_NONINIT ARES_ENOTINITIALIZED
+#else
+#define EXPECTED_NONINIT ARES_SUCCESS
+#endif
+
+namespace ares {
+namespace test {
+
+TEST(LibraryInit, Basic) {
+ EXPECT_EQ(EXPECTED_NONINIT, ares_library_initialized());
+ EXPECT_EQ(ARES_SUCCESS, ares_library_init(ARES_LIB_INIT_ALL));
+ EXPECT_EQ(ARES_SUCCESS, ares_library_initialized());
+ ares_library_cleanup();
+ EXPECT_EQ(EXPECTED_NONINIT, ares_library_initialized());
+}
+
+TEST(LibraryInit, UnexpectedCleanup) {
+ EXPECT_EQ(EXPECTED_NONINIT, ares_library_initialized());
+ ares_library_cleanup();
+ EXPECT_EQ(EXPECTED_NONINIT, ares_library_initialized());
+}
+
+TEST(LibraryInit, DISABLED_InvalidParam) {
+ // TODO: police flags argument to ares_library_init()
+ EXPECT_EQ(ARES_EBADQUERY, ares_library_init(ARES_LIB_INIT_ALL << 2));
+ EXPECT_EQ(EXPECTED_NONINIT, ares_library_initialized());
+ ares_library_cleanup();
+}
+
+TEST(LibraryInit, Nested) {
+ EXPECT_EQ(EXPECTED_NONINIT, ares_library_initialized());
+ EXPECT_EQ(ARES_SUCCESS, ares_library_init(ARES_LIB_INIT_ALL));
+ EXPECT_EQ(ARES_SUCCESS, ares_library_initialized());
+ EXPECT_EQ(ARES_SUCCESS, ares_library_init(ARES_LIB_INIT_ALL));
+ EXPECT_EQ(ARES_SUCCESS, ares_library_initialized());
+ ares_library_cleanup();
+ EXPECT_EQ(ARES_SUCCESS, ares_library_initialized());
+ ares_library_cleanup();
+ EXPECT_EQ(EXPECTED_NONINIT, ares_library_initialized());
+}
+
+TEST(LibraryInit, BasicChannelInit) {
+ EXPECT_EQ(ARES_SUCCESS, ares_library_init(ARES_LIB_INIT_ALL));
+ ares_channel_t *channel = nullptr;
+ EXPECT_EQ(ARES_SUCCESS, ares_init(&channel));
+ EXPECT_NE(nullptr, channel);
+ ares_destroy(channel);
+ ares_library_cleanup();
+}
+
+TEST_F(LibraryTest, OptionsChannelInit) {
+ struct ares_options opts;
+ int optmask = 0;
+ memset(&opts, 0, sizeof(opts));
+ opts.flags = ARES_FLAG_USEVC | ARES_FLAG_PRIMARY;
+ optmask |= ARES_OPT_FLAGS;
+ opts.timeout = 2000;
+ optmask |= ARES_OPT_TIMEOUTMS;
+ opts.tries = 2;
+ optmask |= ARES_OPT_TRIES;
+ opts.ndots = 4;
+ optmask |= ARES_OPT_NDOTS;
+ opts.udp_port = 54;
+ optmask |= ARES_OPT_MAXTIMEOUTMS;
+ opts.maxtimeout = 10000;
+ optmask |= ARES_OPT_UDP_PORT;
+ opts.tcp_port = 54;
+ optmask |= ARES_OPT_TCP_PORT;
+ opts.socket_send_buffer_size = 514;
+ optmask |= ARES_OPT_SOCK_SNDBUF;
+ opts.socket_receive_buffer_size = 514;
+ optmask |= ARES_OPT_SOCK_RCVBUF;
+ opts.ednspsz = 1280;
+ optmask |= ARES_OPT_EDNSPSZ;
+ opts.nservers = 2;
+ opts.servers = (struct in_addr *)malloc((size_t)opts.nservers * sizeof(struct in_addr));
+ opts.servers[0].s_addr = htonl(0x01020304);
+ opts.servers[1].s_addr = htonl(0x02030405);
+ optmask |= ARES_OPT_SERVERS;
+ opts.ndomains = 2;
+ opts.domains = (char **)malloc((size_t)opts.ndomains * sizeof(char *));
+ opts.domains[0] = strdup("example.com");
+ opts.domains[1] = strdup("example2.com");
+ optmask |= ARES_OPT_DOMAINS;
+ opts.lookups = strdup("b");
+ optmask |= ARES_OPT_LOOKUPS;
+ optmask |= ARES_OPT_ROTATE;
+ opts.resolvconf_path = strdup("/etc/resolv.conf");
+ optmask |= ARES_OPT_RESOLVCONF;
+ opts.hosts_path = strdup("/etc/hosts");
+ optmask |= ARES_OPT_HOSTS_FILE;
+
+ ares_channel_t *channel = nullptr;
+ EXPECT_EQ(ARES_SUCCESS, ares_init_options(&channel, &opts, optmask));
+ EXPECT_NE(nullptr, channel);
+
+ ares_channel_t *channel2 = nullptr;
+ EXPECT_EQ(ARES_SUCCESS, ares_dup(&channel2, channel));
+ EXPECT_NE(nullptr, channel2);
+
+ struct ares_options opts2;
+ int optmask2 = 0;
+ memset(&opts2, 0, sizeof(opts2));
+ EXPECT_EQ(ARES_SUCCESS, ares_save_options(channel2, &opts2, &optmask2));
+
+ // Note that not all opts-settable fields are saved (e.g.
+ // ednspsz, socket_{send,receive}_buffer_size).
+ EXPECT_EQ(opts.flags, opts2.flags);
+ EXPECT_EQ(opts.timeout, opts2.timeout);
+ EXPECT_EQ(opts.tries, opts2.tries);
+ EXPECT_EQ(opts.ndots, opts2.ndots);
+ EXPECT_EQ(opts.maxtimeout, opts2.maxtimeout);
+ EXPECT_EQ(opts.udp_port, opts2.udp_port);
+ EXPECT_EQ(opts.tcp_port, opts2.tcp_port);
+ EXPECT_EQ(1, opts2.nservers); // Truncated by ARES_FLAG_PRIMARY
+ EXPECT_EQ(opts.servers[0].s_addr, opts2.servers[0].s_addr);
+ EXPECT_EQ(opts.ndomains, opts2.ndomains);
+ EXPECT_EQ(std::string(opts.domains[0]), std::string(opts2.domains[0]));
+ EXPECT_EQ(std::string(opts.domains[1]), std::string(opts2.domains[1]));
+ EXPECT_EQ(std::string(opts.lookups), std::string(opts2.lookups));
+ EXPECT_EQ(std::string(opts.resolvconf_path), std::string(opts2.resolvconf_path));
+ EXPECT_EQ(std::string(opts.hosts_path), std::string(opts2.hosts_path));
+
+ ares_destroy_options(&opts);
+ ares_destroy_options(&opts2);
+ ares_destroy(channel);
+ ares_destroy(channel2);
+}
+
+TEST_F(LibraryTest, ChannelAllocFail) {
+ ares_channel_t *channel;
+ for (int ii = 1; ii <= 25; ii++) {
+ ClearFails();
+ SetAllocFail(ii);
+ channel = nullptr;
+ int rc = ares_init(&channel);
+ // The number of allocations depends on local environment, so don't expect ENOMEM.
+ if (rc == ARES_ENOMEM) {
+ EXPECT_EQ(nullptr, channel);
+ } else {
+ ares_destroy(channel);
+ }
+ }
+}
+
+TEST_F(LibraryTest, OptionsChannelAllocFail) {
+ struct ares_options opts;
+ int optmask = 0;
+ memset(&opts, 0, sizeof(opts));
+ opts.flags = ARES_FLAG_USEVC;
+ optmask |= ARES_OPT_FLAGS;
+ opts.timeout = 2;
+ optmask |= ARES_OPT_TIMEOUT;
+ opts.tries = 2;
+ optmask |= ARES_OPT_TRIES;
+ opts.ndots = 4;
+ optmask |= ARES_OPT_NDOTS;
+ opts.udp_port = 54;
+ optmask |= ARES_OPT_UDP_PORT;
+ opts.tcp_port = 54;
+ optmask |= ARES_OPT_TCP_PORT;
+ opts.socket_send_buffer_size = 514;
+ optmask |= ARES_OPT_SOCK_SNDBUF;
+ opts.socket_receive_buffer_size = 514;
+ optmask |= ARES_OPT_SOCK_RCVBUF;
+ opts.ednspsz = 1280;
+ optmask |= ARES_OPT_EDNSPSZ;
+ opts.nservers = 2;
+ opts.servers = (struct in_addr *)malloc((size_t)opts.nservers * sizeof(struct in_addr));
+ opts.servers[0].s_addr = htonl(0x01020304);
+ opts.servers[1].s_addr = htonl(0x02030405);
+ optmask |= ARES_OPT_SERVERS;
+ opts.ndomains = 2;
+ opts.domains = (char **)malloc((size_t)opts.ndomains * sizeof(char *));
+ opts.domains[0] = strdup("example.com");
+ opts.domains[1] = strdup("example2.com");
+ optmask |= ARES_OPT_DOMAINS;
+ opts.lookups = strdup("b");
+ optmask |= ARES_OPT_LOOKUPS;
+ optmask |= ARES_OPT_ROTATE;
+ opts.resolvconf_path = strdup("/etc/resolv.conf");
+ optmask |= ARES_OPT_RESOLVCONF;
+ opts.hosts_path = strdup("/etc/hosts");
+ optmask |= ARES_OPT_HOSTS_FILE;
+
+ ares_channel_t *channel = nullptr;
+ for (int ii = 1; ii <= 8; ii++) {
+ ClearFails();
+ SetAllocFail(ii);
+ int rc = ares_init_options(&channel, &opts, optmask);
+ if (rc == ARES_ENOMEM) {
+ EXPECT_EQ(nullptr, channel);
+ } else {
+ EXPECT_EQ(ARES_SUCCESS, rc);
+ ares_destroy(channel);
+ channel = nullptr;
+ }
+ }
+ ClearFails();
+
+ EXPECT_EQ(ARES_SUCCESS, ares_init_options(&channel, &opts, optmask));
+ EXPECT_NE(nullptr, channel);
+
+ // Add some servers and a sortlist for flavour.
+ EXPECT_EQ(ARES_SUCCESS,
+ ares_set_servers_csv(channel, "1.2.3.4,0102:0304:0506:0708:0910:1112:1314:1516,2.3.4.5"));
+ EXPECT_EQ(ARES_SUCCESS, ares_set_sortlist(channel, "1.2.3.4 2.3.4.5"));
+
+ ares_channel_t *channel2 = nullptr;
+ for (int ii = 1; ii <= 18; ii++) {
+ ClearFails();
+ SetAllocFail(ii);
+ EXPECT_EQ(ARES_ENOMEM, ares_dup(&channel2, channel)) << ii;
+ EXPECT_EQ(nullptr, channel2) << ii;
+ }
+
+ struct ares_options opts2;
+ int optmask2 = 0;
+ for (int ii = 1; ii <= 6; ii++) {
+ memset(&opts2, 0, sizeof(opts2));
+ ClearFails();
+ SetAllocFail(ii);
+ EXPECT_EQ(ARES_ENOMEM, ares_save_options(channel, &opts2, &optmask2)) << ii;
+ // May still have allocations even after ARES_ENOMEM return code.
+ ares_destroy_options(&opts2);
+ }
+ ares_destroy_options(&opts);
+ ares_destroy(channel);
+}
+
+TEST_F(LibraryTest, FailChannelInit) {
+ EXPECT_EQ(ARES_SUCCESS,
+ ares_library_init_mem(ARES_LIB_INIT_ALL,
+ &LibraryTest::amalloc,
+ &LibraryTest::afree,
+ &LibraryTest::arealloc));
+ SetAllocFail(1);
+ ares_channel_t *channel = nullptr;
+ EXPECT_EQ(ARES_ENOMEM, ares_init(&channel));
+ EXPECT_EQ(nullptr, channel);
+ ares_library_cleanup();
+}
+
+#ifndef WIN32
+TEST_F(LibraryTest, EnvInit) {
+ ares_channel_t *channel = nullptr;
+ EnvValue v1("LOCALDOMAIN", "this.is.local");
+ EnvValue v2("RES_OPTIONS", "options debug ndots:3 retry:3 rotate retrans:2");
+ EXPECT_EQ(ARES_SUCCESS, ares_init(&channel));
+ ares_destroy(channel);
+}
+
+TEST_F(LibraryTest, EnvInitModernOptions) {
+ ares_channel_t *channel = nullptr;
+ EnvValue v1("LOCALDOMAIN", "this.is.local");
+ EnvValue v2("RES_OPTIONS", "options debug retrans:2 ndots:3 attempts:4 timeout:5 rotate");
+ EXPECT_EQ(ARES_SUCCESS, ares_init(&channel));
+
+ channel->optmask |= ARES_OPT_TRIES;
+ channel->optmask |= ARES_OPT_TIMEOUTMS;
+
+ struct ares_options opts;
+ memset(&opts, 0, sizeof(opts));
+ int optmask = 0;
+ EXPECT_EQ(ARES_SUCCESS, ares_save_options(channel, &opts, &optmask));
+ EXPECT_EQ(5000, opts.timeout);
+ EXPECT_EQ(4, opts.tries);
+
+ ares_destroy(channel);
+}
+
+TEST_F(LibraryTest, EnvInitAllocFail) {
+ ares_channel_t *channel;
+ EnvValue v1("LOCALDOMAIN", "this.is.local");
+ EnvValue v2("RES_OPTIONS", "options debug ndots:3 retry:3 rotate retrans:2");
+ for (int ii = 1; ii <= 10; ii++) {
+ ClearFails();
+ SetAllocFail(ii);
+ channel = nullptr;
+ int rc = ares_init(&channel);
+ if (rc == ARES_SUCCESS) {
+ ares_destroy(channel);
+ } else {
+ EXPECT_EQ(ARES_ENOMEM, rc);
+ }
+ }
+}
+#endif
+
+TEST_F(DefaultChannelTest, SetAddresses) {
+ ares_set_local_ip4(channel_, 0x01020304);
+ byte addr6[16] = {0x01, 0x02, 0x03, 0x04, 0x05, 0x06, 0x07, 0x08,
+ 0x09, 0x0a, 0x0b, 0x0c, 0x0d, 0x0e, 0x0f, 0x10};
+ ares_set_local_ip6(channel_, addr6);
+ ares_set_local_dev(channel_, "dummy");
+}
+
+TEST_F(DefaultChannelTest, SetSortlistFailures) {
+ EXPECT_EQ(ARES_ENODATA, ares_set_sortlist(nullptr, "1.2.3.4"));
+ EXPECT_EQ(ARES_EBADSTR, ares_set_sortlist(channel_, "111.111.111.111*/16"));
+ EXPECT_EQ(ARES_EBADSTR, ares_set_sortlist(channel_, "111.111.111.111/255.255.255.240*"));
+ EXPECT_EQ(ARES_EBADSTR, ares_set_sortlist(channel_, "1 0123456789012345"));
+ EXPECT_EQ(ARES_EBADSTR, ares_set_sortlist(channel_, "1 /01234567890123456789012345678901"));
+ EXPECT_EQ(ARES_EBADSTR, ares_set_sortlist(channel_, "xyzzy ; lwk"));
+ EXPECT_EQ(ARES_EBADSTR, ares_set_sortlist(channel_, "xyzzy ; 0x123"));
+}
+
+TEST_F(DefaultChannelTest, SetSortlistVariants) {
+ EXPECT_EQ(ARES_SUCCESS, ares_set_sortlist(channel_, "1.2.3.4"));
+ EXPECT_EQ(ARES_SUCCESS, ares_set_sortlist(channel_, "1.2.3.4 ; 2.3.4.5"));
+ EXPECT_EQ(ARES_SUCCESS, ares_set_sortlist(channel_, "1.2.3.4/26;1234::5678/126;4.5.6.7;5678::1234"));
+ EXPECT_EQ(ARES_SUCCESS, ares_set_sortlist(channel_, " 1.2.3.4/26 1234::5678/126 4.5.6.7 5678::1234 "));
+ EXPECT_EQ(ARES_SUCCESS, ares_set_sortlist(channel_, "129.1.1.1"));
+ EXPECT_EQ(ARES_SUCCESS, ares_set_sortlist(channel_, "192.1.1.1"));
+ EXPECT_EQ(ARES_SUCCESS, ares_set_sortlist(channel_, "224.1.1.1"));
+ EXPECT_EQ(ARES_SUCCESS, ares_set_sortlist(channel_, "225.1.1.1"));
+}
+
+TEST_F(DefaultChannelTest, SetSortlistAllocFail) {
+ for (int ii = 1; ii <= 3; ii++) {
+ ClearFails();
+ SetAllocFail(ii);
+ EXPECT_EQ(ARES_ENOMEM, ares_set_sortlist(channel_, "12.13.0.0/16 1234::5678/40 1.2.3.4")) << ii;
+ }
+}
+
+#ifdef USE_WINSOCK
+TEST(Init, NoLibraryInit) {
+ ares_channel_t *channel = nullptr;
+ EXPECT_EQ(ARES_ENOTINITIALIZED, ares_init(&channel));
+}
+#endif
+
+#ifdef HAVE_CONTAINER
+// These tests rely on the ability of non-root users to create a chroot
+// using Linux namespaces.
+
+
+// The library uses a variety of information sources to initialize a channel,
+// in particular to determine:
+// - search: the search domains to use
+// - servers: the name servers to use
+// - lookup: whether to check files or DNS or both (e.g. "fb")
+// - options: various resolver options
+// - sortlist: the order of preference for IP addresses
+//
+// The first source from the following list is used:
+// - init_by_options(): explicitly specified values in struct ares_options
+// - init_by_environment(): values from the environment:
+// - LOCALDOMAIN -> search (single value)
+// - RES_OPTIONS -> options
+// - init_by_resolv_conf(): values from various config files:
+// - /etc/resolv.conf -> search, lookup, servers, sortlist, options
+// - /etc/nsswitch.conf -> lookup
+// - /etc/host.conf -> lookup
+// - /etc/svc.conf -> lookup
+// - init_by_defaults(): fallback values:
+// - gethostname(3) -> domain
+// - "fb" -> lookup
+
+NameContentList filelist = {
+ {"/etc/resolv.conf", "nameserver 1.2.3.4\n"
+ "sortlist 1.2.3.4/16 2.3.4.5\n"
+ "search first.com second.com\n"},
+ {"/etc/hosts", "3.4.5.6 ahostname.com\n"},
+ {"/etc/nsswitch.conf", "hosts: files\n"}};
+CONTAINED_TEST_F(LibraryTest, ContainerChannelInit,
+ "myhostname", "mydomainname.org", filelist) {
+ ares_channel_t *channel = nullptr;
+ EXPECT_EQ(ARES_SUCCESS, ares_init(&channel));
+ std::string actual = GetNameServers(channel);
+ std::string expected = "1.2.3.4:53";
+ EXPECT_EQ(expected, actual);
+ EXPECT_EQ(2, channel->ndomains);
+ EXPECT_EQ(std::string("first.com"), std::string(channel->domains[0]));
+ EXPECT_EQ(std::string("second.com"), std::string(channel->domains[1]));
+
+ HostResult result;
+ ares_gethostbyname(channel, "ahostname.com", AF_INET, HostCallback, &result);
+ ProcessWork(channel, NoExtraFDs, nullptr);
+ EXPECT_TRUE(result.done_);
+ std::stringstream ss;
+ ss << result.host_;
+
+ EXPECT_EQ("{'ahostname.com' aliases=[] addrs=[3.4.5.6]}", ss.str());
+
+ ares_destroy(channel);
+ return HasFailure();
+}
+
+CONTAINED_TEST_F(LibraryTest, ContainerSortlistOptionInit,
+ "myhostname", "mydomainname.org", filelist) {
+ ares_channel_t *channel = nullptr;
+ struct ares_options opts = {0};
+ int optmask = 0;
+ optmask |= ARES_OPT_SORTLIST;
+ opts.nsort = 0;
+ // Explicitly specifying an empty sortlist in the options should override the
+ // environment.
+ EXPECT_EQ(ARES_SUCCESS, ares_init_options(&channel, &opts, optmask));
+ EXPECT_EQ(0, channel->nsort);
+ EXPECT_EQ(nullptr, channel->sortlist);
+ EXPECT_EQ(ARES_OPT_SORTLIST, (channel->optmask & ARES_OPT_SORTLIST));
+
+ ares_destroy(channel);
+ return HasFailure();
+}
+
+NameContentList fullresolv = {
+ {"/etc/resolv.conf", " nameserver 1.2.3.4 \n"
+ "search first.com second.com\n"
+ "lookup bind\n"
+ "options debug ndots:5\n"
+ "sortlist 1.2.3.4/16 2.3.4.5\n"}};
+CONTAINED_TEST_F(LibraryTest, ContainerFullResolvInit,
+ "myhostname", "mydomainname.org", fullresolv) {
+ ares_channel_t *channel = nullptr;
+ EXPECT_EQ(ARES_SUCCESS, ares_init(&channel));
+
+ EXPECT_EQ(std::string("b"), std::string(channel->lookups));
+ EXPECT_EQ(5, channel->ndots);
+
+ ares_destroy(channel);
+ return HasFailure();
+}
+
+// Allow path for resolv.conf to be configurable
+NameContentList myresolvconf = {
+ {"/tmp/myresolv.cnf", " nameserver 1.2.3.4 \n"
+ "search first.com second.com\n"
+ "lookup bind\n"
+ "options debug ndots:5\n"
+ "sortlist 1.2.3.4/16 2.3.4.5\n"}};
+CONTAINED_TEST_F(LibraryTest, ContainerMyResolvConfInit,
+ "myhostname", "mydomain.org", myresolvconf) {
+ char filename[] = "/tmp/myresolv.cnf";
+ ares_channel_t *channel = nullptr;
+ struct ares_options options = {0};
+ options.resolvconf_path = strdup(filename);
+ int optmask = ARES_OPT_RESOLVCONF;
+ EXPECT_EQ(ARES_SUCCESS, ares_init_options(&channel, &options, optmask));
+
+ optmask = 0;
+ free(options.resolvconf_path);
+ options.resolvconf_path = NULL;
+
+ EXPECT_EQ(ARES_SUCCESS, ares_save_options(channel, &options, &optmask));
+ EXPECT_EQ(ARES_OPT_RESOLVCONF, (optmask & ARES_OPT_RESOLVCONF));
+ EXPECT_EQ(std::string(filename), std::string(options.resolvconf_path));
+
+ ares_destroy_options(&options);
+ ares_destroy(channel);
+ return HasFailure();
+}
+
+// Allow hosts path to be configurable
+NameContentList myhosts = {
+ {"/tmp/hosts", "10.0.12.26 foobar\n"
+ "2001:A0:C::1A foobar\n"}};
+CONTAINED_TEST_F(LibraryTest, ContainerMyHostsInit,
+ "myhostname", "mydomain.org", myhosts) {
+ char filename[] = "/tmp/hosts";
+ ares_channel_t *channel = nullptr;
+ struct ares_options options = {0};
+ options.hosts_path = strdup(filename);
+ int optmask = ARES_OPT_HOSTS_FILE;
+ EXPECT_EQ(ARES_SUCCESS, ares_init_options(&channel, &options, optmask));
+
+ optmask = 0;
+ free(options.hosts_path);
+ options.hosts_path = NULL;
+
+ EXPECT_EQ(ARES_SUCCESS, ares_save_options(channel, &options, &optmask));
+ EXPECT_EQ(ARES_OPT_HOSTS_FILE, (optmask & ARES_OPT_HOSTS_FILE));
+ EXPECT_EQ(std::string(filename), std::string(options.hosts_path));
+
+ ares_destroy_options(&options);
+ ares_destroy(channel);
+ return HasFailure();
+}
+
+NameContentList hostconf = {
+ {"/etc/resolv.conf", "nameserver 1.2.3.4\n"
+ "sortlist1.2.3.4\n" // malformed line
+ "search first.com second.com\n"},
+ {"/etc/host.conf", "order bind hosts\n"}};
+CONTAINED_TEST_F(LibraryTest, ContainerHostConfInit,
+ "myhostname", "mydomainname.org", hostconf) {
+ ares_channel_t *channel = nullptr;
+ EXPECT_EQ(ARES_SUCCESS, ares_init(&channel));
+
+ EXPECT_EQ(std::string("bf"), std::string(channel->lookups));
+
+ ares_destroy(channel);
+ return HasFailure();
+}
+
+NameContentList svcconf = {
+ {"/etc/resolv.conf", "nameserver 1.2.3.4\n"
+ "search first.com second.com\n"},
+ {"/etc/svc.conf", "hosts= bind\n"}};
+CONTAINED_TEST_F(LibraryTest, ContainerSvcConfInit,
+ "myhostname", "mydomainname.org", svcconf) {
+ ares_channel_t *channel = nullptr;
+ EXPECT_EQ(ARES_SUCCESS, ares_init(&channel));
+
+ EXPECT_EQ(std::string("b"), std::string(channel->lookups));
+
+ ares_destroy(channel);
+ return HasFailure();
+}
+
+NameContentList malformedresolvconflookup = {
+ {"/etc/resolv.conf", "nameserver 1.2.3.4\n"
+ "lookup garbage\n"}}; // malformed line
+CONTAINED_TEST_F(LibraryTest, ContainerMalformedResolvConfLookup,
+ "myhostname", "mydomainname.org", malformedresolvconflookup) {
+ ares_channel_t *channel = nullptr;
+ EXPECT_EQ(ARES_SUCCESS, ares_init(&channel));
+
+ EXPECT_EQ(std::string("fb"), std::string(channel->lookups));
+
+ ares_destroy(channel);
+ return HasFailure();
+}
+
+// Failures when expected config filenames are inaccessible.
+class MakeUnreadable {
+ public:
+ explicit MakeUnreadable(const std::string& filename)
+ : filename_(filename) {
+ chmod(filename_.c_str(), 0000);
+ }
+ ~MakeUnreadable() { chmod(filename_.c_str(), 0644); }
+ private:
+ std::string filename_;
+};
+
+CONTAINED_TEST_F(LibraryTest, ContainerResolvConfNotReadable,
+ "myhostname", "mydomainname.org", filelist) {
+ ares_channel_t *channel = nullptr;
+ MakeUnreadable hide("/etc/resolv.conf");
+ // Unavailable /etc/resolv.conf falls back to defaults
+ EXPECT_EQ(ARES_SUCCESS, ares_init(&channel));
+ return HasFailure();
+}
+CONTAINED_TEST_F(LibraryTest, ContainerNsswitchConfNotReadable,
+ "myhostname", "mydomainname.org", filelist) {
+ ares_channel_t *channel = nullptr;
+ // Unavailable /etc/nsswitch.conf falls back to defaults.
+ MakeUnreadable hide("/etc/nsswitch.conf");
+ EXPECT_EQ(ARES_SUCCESS, ares_init(&channel));
+
+ EXPECT_EQ(std::string("fb"), std::string(channel->lookups));
+
+ ares_destroy(channel);
+ return HasFailure();
+}
+CONTAINED_TEST_F(LibraryTest, ContainerHostConfNotReadable,
+ "myhostname", "mydomainname.org", hostconf) {
+ ares_channel_t *channel = nullptr;
+ // Unavailable /etc/host.conf falls back to defaults.
+ MakeUnreadable hide("/etc/host.conf");
+ EXPECT_EQ(ARES_SUCCESS, ares_init(&channel));
+ ares_destroy(channel);
+ return HasFailure();
+}
+CONTAINED_TEST_F(LibraryTest, ContainerSvcConfNotReadable,
+ "myhostname", "mydomainname.org", svcconf) {
+ ares_channel_t *channel = nullptr;
+ // Unavailable /etc/svc.conf falls back to defaults.
+ MakeUnreadable hide("/etc/svc.conf");
+ EXPECT_EQ(ARES_SUCCESS, ares_init(&channel));
+ ares_destroy(channel);
+ return HasFailure();
+}
+
+NameContentList rotateenv = {
+ {"/etc/resolv.conf", "nameserver 1.2.3.4\n"
+ "search first.com second.com\n"
+ "options rotate\n"}};
+CONTAINED_TEST_F(LibraryTest, ContainerRotateInit,
+ "myhostname", "mydomainname.org", rotateenv) {
+ ares_channel_t *channel = nullptr;
+ EXPECT_EQ(ARES_SUCCESS, ares_init(&channel));
+
+ EXPECT_EQ(ARES_TRUE, channel->rotate);
+
+ ares_destroy(channel);
+ return HasFailure();
+}
+
+CONTAINED_TEST_F(LibraryTest, ContainerRotateOverride,
+ "myhostname", "mydomainname.org", rotateenv) {
+ ares_channel_t *channel = nullptr;
+ struct ares_options opts = {0};
+ int optmask = ARES_OPT_NOROTATE;
+ EXPECT_EQ(ARES_SUCCESS, ares_init_options(&channel, &opts, optmask));
+ optmask = 0;
+ ares_save_options(channel, &opts, &optmask);
+ EXPECT_EQ(ARES_OPT_NOROTATE, (optmask & ARES_OPT_NOROTATE));
+ ares_destroy_options(&opts);
+
+ ares_destroy(channel);
+ return HasFailure();
+}
+
+// Test that blacklisted IPv6 resolves are ignored. They're filtered from any
+// source, so resolv.conf is as good as any.
+NameContentList blacklistedIpv6 = {
+ {"/etc/resolv.conf", " nameserver 254.192.1.1\n" // 0xfe.0xc0.0x01.0x01
+ " nameserver fec0::dead\n" // Blacklisted
+ " nameserver ffc0::c001\n" // Not blacklisted
+ " domain first.com\n"},
+ {"/etc/nsswitch.conf", "hosts: files\n"}};
+CONTAINED_TEST_F(LibraryTest, ContainerBlacklistedIpv6,
+ "myhostname", "mydomainname.org", blacklistedIpv6) {
+ ares_channel_t *channel = nullptr;
+ EXPECT_EQ(ARES_SUCCESS, ares_init(&channel));
+ std::string actual = GetNameServers(channel);
+ std::string expected = "254.192.1.1:53,"
+ "[ffc0::c001]:53";
+ EXPECT_EQ(expected, actual);
+
+ EXPECT_EQ(1, channel->ndomains);
+ EXPECT_EQ(std::string("first.com"), std::string(channel->domains[0]));
+
+ ares_destroy(channel);
+ return HasFailure();
+}
+
+NameContentList multiresolv = {
+ {"/etc/resolv.conf", " nameserver 1::2 ; ;;\n"
+ " domain first.com\n"},
+ {"/etc/nsswitch.conf", "hosts: files\n"}};
+CONTAINED_TEST_F(LibraryTest, ContainerMultiResolvInit,
+ "myhostname", "mydomainname.org", multiresolv) {
+ ares_channel_t *channel = nullptr;
+ EXPECT_EQ(ARES_SUCCESS, ares_init(&channel));
+ std::string actual = GetNameServers(channel);
+ std::string expected = "[1::2]:53";
+ EXPECT_EQ(expected, actual);
+
+ EXPECT_EQ(1, channel->ndomains);
+ EXPECT_EQ(std::string("first.com"), std::string(channel->domains[0]));
+
+ ares_destroy(channel);
+ return HasFailure();
+}
+
+NameContentList systemdresolv = {
+ {"/etc/resolv.conf", "nameserver 1.2.3.4\n"
+ "domain first.com\n"},
+ {"/etc/nsswitch.conf", "hosts: junk resolve files\n"}};
+CONTAINED_TEST_F(LibraryTest, ContainerSystemdResolvInit,
+ "myhostname", "mydomainname.org", systemdresolv) {
+ ares_channel_t *channel = nullptr;
+ EXPECT_EQ(ARES_SUCCESS, ares_init(&channel));
+
+ EXPECT_EQ(std::string("bf"), std::string(channel->lookups));
+
+ ares_destroy(channel);
+ return HasFailure();
+}
+
+NameContentList empty = {}; // no files
+CONTAINED_TEST_F(LibraryTest, ContainerEmptyInit,
+ "host.domain.org", "domain.org", empty) {
+ ares_channel_t *channel = nullptr;
+ EXPECT_EQ(ARES_SUCCESS, ares_init(&channel));
+ std::string actual = GetNameServers(channel);
+ std::string expected = "127.0.0.1:53";
+ EXPECT_EQ(expected, actual);
+
+ EXPECT_EQ(1, channel->ndomains);
+ EXPECT_EQ(std::string("domain.org"), std::string(channel->domains[0]));
+ EXPECT_EQ(std::string("fb"), std::string(channel->lookups));
+
+ ares_destroy(channel);
+ return HasFailure();
+}
+
+#endif
+
+} // namespace test
+} // namespace ares
diff --git a/subprojects/c-ares/test/ares-test-internal.cc b/subprojects/c-ares/test/ares-test-internal.cc
@@ -0,0 +1,991 @@
+/* MIT License
+ *
+ * Copyright (c) The c-ares project and its contributors
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice (including the next
+ * paragraph) shall be included in all copies or substantial portions of the
+ * Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ *
+ * SPDX-License-Identifier: MIT
+ */
+#include "ares-test.h"
+#include "dns-proto.h"
+
+#include <stdio.h>
+
+#ifdef HAVE_UNISTD_H
+#include <unistd.h>
+#endif
+#include <fcntl.h>
+#ifdef HAVE_SYS_IOCTL_H
+# include <sys/ioctl.h>
+#endif
+extern "C" {
+// Remove command-line defines of package variables for the test project...
+#undef PACKAGE_NAME
+#undef PACKAGE_BUGREPORT
+#undef PACKAGE_STRING
+#undef PACKAGE_TARNAME
+// ... so we can include the library's config without symbol redefinitions.
+#include "ares_setup.h"
+#include "ares_inet_net_pton.h"
+#include "ares_data.h"
+#include "ares_strsplit.h"
+#include "ares_private.h"
+#include "ares__htable.h"
+
+#ifdef HAVE_ARPA_INET_H
+#include <arpa/inet.h>
+#endif
+#ifdef HAVE_SYS_UIO_H
+# include <sys/uio.h>
+#endif
+}
+
+#include <string>
+#include <vector>
+
+namespace ares {
+namespace test {
+
+#ifndef CARES_SYMBOL_HIDING
+void CheckPtoN4(int size, unsigned int value, const char *input) {
+ struct in_addr a4;
+ a4.s_addr = 0;
+ uint32_t expected = htonl(value);
+ EXPECT_EQ(size, ares_inet_net_pton(AF_INET, input, &a4, sizeof(a4)))
+ << " for input " << input;
+ EXPECT_EQ(expected, a4.s_addr) << " for input " << input;
+}
+#endif
+
+#ifndef CARES_SYMBOL_HIDING
+TEST_F(LibraryTest, Strsplit) {
+ using std::vector;
+ using std::string;
+ size_t n;
+ struct {
+ vector<string> inputs;
+ vector<string> delimiters;
+ vector<vector<string>> expected;
+ } data = {
+ {
+ "",
+ " ",
+ " ",
+ "example.com, example.co",
+ " a, b, A,c, d, e,,,D,e,e,E",
+ },
+ { ", ", ", ", ", ", ", ", ", " },
+ {
+ {}, {}, {},
+ { "example.com", "example.co" },
+ { "a", "b", "c", "d", "e" },
+ },
+ };
+ for(size_t i = 0; i < data.inputs.size(); i++) {
+ char **out = ares__strsplit(data.inputs.at(i).c_str(),
+ data.delimiters.at(i).c_str(), &n);
+ if(data.expected.at(i).size() == 0) {
+ EXPECT_EQ(out, nullptr);
+ }
+ else {
+ EXPECT_EQ(n, data.expected.at(i).size());
+ for(size_t j = 0; j < n && j < data.expected.at(i).size(); j++) {
+ EXPECT_STREQ(out[j], data.expected.at(i).at(j).c_str());
+ }
+ }
+ ares__strsplit_free(out, n);
+ }
+}
+#endif
+
+TEST_F(LibraryTest, InetPtoN) {
+ struct in_addr a4;
+ struct in6_addr a6;
+
+#ifndef CARES_SYMBOL_HIDING
+ uint32_t expected;
+
+ CheckPtoN4(4 * 8, 0x01020304, "1.2.3.4");
+ CheckPtoN4(4 * 8, 0x81010101, "129.1.1.1");
+ CheckPtoN4(4 * 8, 0xC0010101, "192.1.1.1");
+ CheckPtoN4(4 * 8, 0xE0010101, "224.1.1.1");
+ CheckPtoN4(4 * 8, 0xE1010101, "225.1.1.1");
+ CheckPtoN4(4, 0xE0000000, "224");
+ CheckPtoN4(4 * 8, 0xFD000000, "253");
+ CheckPtoN4(4 * 8, 0xF0010101, "240.1.1.1");
+ CheckPtoN4(4 * 8, 0x02030405, "02.3.4.5");
+ CheckPtoN4(3 * 8, 0x01020304, "1.2.3.4/24");
+ CheckPtoN4(3 * 8, 0x01020300, "1.2.3/24");
+ CheckPtoN4(2 * 8, 0xa0000000, "0xa");
+ CheckPtoN4(0, 0x02030405, "2.3.4.5/000");
+ CheckPtoN4(1 * 8, 0x01020000, "1.2/8");
+ CheckPtoN4(2 * 8, 0x01020000, "0x0102/16");
+ CheckPtoN4(4 * 8, 0x02030405, "02.3.4.5");
+
+ EXPECT_EQ(16 * 8, ares_inet_net_pton(AF_INET6, "::", &a6, sizeof(a6)));
+ EXPECT_EQ(16 * 8, ares_inet_net_pton(AF_INET6, "::1", &a6, sizeof(a6)));
+ EXPECT_EQ(16 * 8, ares_inet_net_pton(AF_INET6, "1234:5678::", &a6, sizeof(a6)));
+ EXPECT_EQ(16 * 8, ares_inet_net_pton(AF_INET6, "12:34::ff", &a6, sizeof(a6)));
+ EXPECT_EQ(16 * 8, ares_inet_net_pton(AF_INET6, "12:34::ffff:1.2.3.4", &a6, sizeof(a6)));
+ EXPECT_EQ(23, ares_inet_net_pton(AF_INET6, "12:34::ffff:1.2.3.4/23", &a6, sizeof(a6)));
+ EXPECT_EQ(3 * 8, ares_inet_net_pton(AF_INET6, "12:34::ff/24", &a6, sizeof(a6)));
+ EXPECT_EQ(0, ares_inet_net_pton(AF_INET6, "12:34::ff/0", &a6, sizeof(a6)));
+ EXPECT_EQ(16 * 8, ares_inet_net_pton(AF_INET6, "12:34::ffff:0.2", &a6, sizeof(a6)));
+ EXPECT_EQ(16 * 8, ares_inet_net_pton(AF_INET6, "1234:1234:1234:1234:1234:1234:1234:1234", &a6, sizeof(a6)));
+ EXPECT_EQ(2, ares_inet_net_pton(AF_INET6, "0::00:00:00/2", &a6, sizeof(a6)));
+
+ // Various malformed versions
+ EXPECT_EQ(-1, ares_inet_net_pton(AF_INET, "", &a4, sizeof(a4)));
+ EXPECT_EQ(-1, ares_inet_net_pton(AF_INET, " ", &a4, sizeof(a4)));
+ EXPECT_EQ(-1, ares_inet_net_pton(AF_INET, "0x", &a4, sizeof(a4)));
+ EXPECT_EQ(-1, ares_inet_net_pton(AF_INET, "0x ", &a4, sizeof(a4)));
+ EXPECT_EQ(-1, ares_inet_net_pton(AF_INET, "x0", &a4, sizeof(a4)));
+ EXPECT_EQ(-1, ares_inet_net_pton(AF_INET, "0xXYZZY", &a4, sizeof(a4)));
+ EXPECT_EQ(-1, ares_inet_net_pton(AF_INET, "xyzzy", &a4, sizeof(a4)));
+ EXPECT_EQ(-1, ares_inet_net_pton(AF_INET+AF_INET6, "1.2.3.4", &a4, sizeof(a4)));
+ EXPECT_EQ(-1, ares_inet_net_pton(AF_INET, "257.2.3.4", &a4, sizeof(a4)));
+ EXPECT_EQ(-1, ares_inet_net_pton(AF_INET, "002.3.4.x", &a4, sizeof(a4)));
+ EXPECT_EQ(-1, ares_inet_net_pton(AF_INET, "00.3.4.x", &a4, sizeof(a4)));
+ EXPECT_EQ(-1, ares_inet_net_pton(AF_INET, "2.3.4.x", &a4, sizeof(a4)));
+ EXPECT_EQ(-1, ares_inet_net_pton(AF_INET, "2.3.4.5.6", &a4, sizeof(a4)));
+ EXPECT_EQ(-1, ares_inet_net_pton(AF_INET, "2.3.4.5.6/12", &a4, sizeof(a4)));
+ EXPECT_EQ(-1, ares_inet_net_pton(AF_INET, "2.3.4:5", &a4, sizeof(a4)));
+ EXPECT_EQ(-1, ares_inet_net_pton(AF_INET, "2.3.4.5/120", &a4, sizeof(a4)));
+ EXPECT_EQ(-1, ares_inet_net_pton(AF_INET, "2.3.4.5/1x", &a4, sizeof(a4)));
+ EXPECT_EQ(-1, ares_inet_net_pton(AF_INET, "2.3.4.5/x", &a4, sizeof(a4)));
+ EXPECT_EQ(-1, ares_inet_net_pton(AF_INET6, "12:34::ff/240", &a6, sizeof(a6)));
+ EXPECT_EQ(-1, ares_inet_net_pton(AF_INET6, "12:34::ff/02", &a6, sizeof(a6)));
+ EXPECT_EQ(-1, ares_inet_net_pton(AF_INET6, "12:34::ff/2y", &a6, sizeof(a6)));
+ EXPECT_EQ(-1, ares_inet_net_pton(AF_INET6, "12:34::ff/y", &a6, sizeof(a6)));
+ EXPECT_EQ(-1, ares_inet_net_pton(AF_INET6, "12:34::ff/", &a6, sizeof(a6)));
+ EXPECT_EQ(-1, ares_inet_net_pton(AF_INET6, "", &a6, sizeof(a6)));
+ EXPECT_EQ(-1, ares_inet_net_pton(AF_INET6, ":x", &a6, sizeof(a6)));
+ EXPECT_EQ(-1, ares_inet_net_pton(AF_INET6, ":", &a6, sizeof(a6)));
+ EXPECT_EQ(-1, ares_inet_net_pton(AF_INET6, ": :1234", &a6, sizeof(a6)));
+ EXPECT_EQ(-1, ares_inet_net_pton(AF_INET6, "::12345", &a6, sizeof(a6)));
+ EXPECT_EQ(-1, ares_inet_net_pton(AF_INET6, "1234::2345:3456::0011", &a6, sizeof(a6)));
+ EXPECT_EQ(-1, ares_inet_net_pton(AF_INET6, "1234:1234:1234:1234:1234:1234:1234:1234:", &a6, sizeof(a6)));
+ EXPECT_EQ(-1, ares_inet_net_pton(AF_INET6, "1234:1234:1234:1234:1234:1234:1234:1234::", &a6, sizeof(a6)));
+ EXPECT_EQ(-1, ares_inet_net_pton(AF_INET6, "1234:1234:1234:1234:1234:1234:1234:1.2.3.4", &a6, sizeof(a6)));
+ EXPECT_EQ(-1, ares_inet_net_pton(AF_INET6, ":1234:1234:1234:1234:1234:1234:1234:1234", &a6, sizeof(a6)));
+ EXPECT_EQ(-1, ares_inet_net_pton(AF_INET6, ":1234:1234:1234:1234:1234:1234:1234:1234:", &a6, sizeof(a6)));
+ EXPECT_EQ(-1, ares_inet_net_pton(AF_INET6, "1234:1234:1234:1234:1234:1234:1234:1234:5678", &a6, sizeof(a6)));
+ EXPECT_EQ(-1, ares_inet_net_pton(AF_INET6, "1234:1234:1234:1234:1234:1234:1234:1234:5678:5678", &a6, sizeof(a6)));
+ EXPECT_EQ(-1, ares_inet_net_pton(AF_INET6, "1234:1234:1234:1234:1234:1234:1234:1234:5678:5678:5678", &a6, sizeof(a6)));
+ EXPECT_EQ(-1, ares_inet_net_pton(AF_INET6, "12:34::ffff:257.2.3.4", &a6, sizeof(a6)));
+ EXPECT_EQ(-1, ares_inet_net_pton(AF_INET6, "12:34::ffff:1.2.3.4.5.6", &a6, sizeof(a6)));
+ EXPECT_EQ(-1, ares_inet_net_pton(AF_INET6, "12:34::ffff:1.2.3.4.5", &a6, sizeof(a6)));
+ EXPECT_EQ(-1, ares_inet_net_pton(AF_INET6, "12:34::ffff:1.2.3.z", &a6, sizeof(a6)));
+ EXPECT_EQ(-1, ares_inet_net_pton(AF_INET6, "12:34::ffff:1.2.3001.4", &a6, sizeof(a6)));
+ EXPECT_EQ(-1, ares_inet_net_pton(AF_INET6, "12:34::ffff:1.2.3..4", &a6, sizeof(a6)));
+ EXPECT_EQ(-1, ares_inet_net_pton(AF_INET6, "12:34::ffff:1.2.3.", &a6, sizeof(a6)));
+
+ // Hex constants are allowed.
+ EXPECT_EQ(4 * 8, ares_inet_net_pton(AF_INET, "0x01020304", &a4, sizeof(a4)));
+ expected = htonl(0x01020304);
+ EXPECT_EQ(expected, a4.s_addr);
+ EXPECT_EQ(4 * 8, ares_inet_net_pton(AF_INET, "0x0a0b0c0d", &a4, sizeof(a4)));
+ expected = htonl(0x0a0b0c0d);
+ EXPECT_EQ(expected, a4.s_addr);
+ EXPECT_EQ(4 * 8, ares_inet_net_pton(AF_INET, "0x0A0B0C0D", &a4, sizeof(a4)));
+ expected = htonl(0x0a0b0c0d);
+ EXPECT_EQ(expected, a4.s_addr);
+ EXPECT_EQ(-1, ares_inet_net_pton(AF_INET, "0x0xyz", &a4, sizeof(a4)));
+ EXPECT_EQ(4 * 8, ares_inet_net_pton(AF_INET, "0x1122334", &a4, sizeof(a4)));
+ expected = htonl(0x11223340);
+ EXPECT_EQ(expected, a4.s_addr); // huh?
+
+ // No room, no room.
+ EXPECT_EQ(-1, ares_inet_net_pton(AF_INET, "1.2.3.4", &a4, sizeof(a4) - 1));
+ EXPECT_EQ(-1, ares_inet_net_pton(AF_INET6, "12:34::ff", &a6, sizeof(a6) - 1));
+ EXPECT_EQ(-1, ares_inet_net_pton(AF_INET, "0x01020304", &a4, 2));
+ EXPECT_EQ(-1, ares_inet_net_pton(AF_INET, "0x01020304", &a4, 0));
+ EXPECT_EQ(-1, ares_inet_net_pton(AF_INET, "0x0a0b0c0d", &a4, 0));
+ EXPECT_EQ(-1, ares_inet_net_pton(AF_INET, "0x0xyz", &a4, 0));
+ EXPECT_EQ(-1, ares_inet_net_pton(AF_INET, "0x1122334", &a4, sizeof(a4) - 1));
+ EXPECT_EQ(-1, ares_inet_net_pton(AF_INET, "253", &a4, sizeof(a4) - 1));
+#endif
+
+ EXPECT_EQ(1, ares_inet_pton(AF_INET, "1.2.3.4", &a4));
+ EXPECT_EQ(1, ares_inet_pton(AF_INET6, "12:34::ff", &a6));
+ EXPECT_EQ(1, ares_inet_pton(AF_INET6, "12:34::ffff:1.2.3.4", &a6));
+ EXPECT_EQ(0, ares_inet_pton(AF_INET, "xyzzy", &a4));
+ EXPECT_EQ(-1, ares_inet_pton(AF_INET+AF_INET6, "1.2.3.4", &a4));
+}
+
+TEST_F(LibraryTest, FreeCorruptData) {
+ // ares_free_data(p) expects that there is a type field and a marker
+ // field in the memory before p. Feed it incorrect versions of each.
+ struct ares_data *data = (struct ares_data *)malloc(sizeof(struct ares_data));
+ void* p = &(data->data);
+
+ // Invalid type
+ data->type = (ares_datatype)ARES_DATATYPE_LAST;
+ data->mark = ARES_DATATYPE_MARK;
+ ares_free_data(p);
+
+ // Invalid marker
+ data->type = (ares_datatype)ARES_DATATYPE_MX_REPLY;
+ data->mark = ARES_DATATYPE_MARK + 1;
+ ares_free_data(p);
+
+ // Null pointer
+ ares_free_data(nullptr);
+
+ free(data);
+}
+
+#ifndef CARES_SYMBOL_HIDING
+TEST_F(LibraryTest, FreeLongChain) {
+ struct ares_addr_node *data = nullptr;
+ for (int ii = 0; ii < 100000; ii++) {
+ struct ares_addr_node *prev = (struct ares_addr_node*)ares_malloc_data(ARES_DATATYPE_ADDR_NODE);
+ prev->next = data;
+ data = prev;
+ }
+
+ ares_free_data(data);
+}
+
+TEST(LibraryInit, StrdupFailures) {
+ EXPECT_EQ(ARES_SUCCESS, ares_library_init(ARES_LIB_INIT_ALL));
+ char* copy = ares_strdup("string");
+ EXPECT_NE(nullptr, copy);
+ ares_free(copy);
+ ares_library_cleanup();
+}
+
+TEST_F(LibraryTest, StrdupFailures) {
+ SetAllocFail(1);
+ char* copy = ares_strdup("string");
+ EXPECT_EQ(nullptr, copy);
+}
+
+TEST_F(LibraryTest, MallocDataFail) {
+ EXPECT_EQ(nullptr, ares_malloc_data((ares_datatype)99));
+ SetAllocSizeFail(sizeof(struct ares_data));
+ EXPECT_EQ(nullptr, ares_malloc_data(ARES_DATATYPE_MX_REPLY));
+}
+
+TEST_F(LibraryTest, ReadLine) {
+ TempFile temp("abcde\n0123456789\nXYZ\n012345678901234567890\n\n");
+ FILE *fp = fopen(temp.filename(), "r");
+ size_t bufsize = 4;
+ char *buf = (char *)ares_malloc(bufsize);
+
+ EXPECT_EQ(ARES_SUCCESS, ares__read_line(fp, &buf, &bufsize));
+ EXPECT_EQ("abcde", std::string(buf));
+ EXPECT_EQ(ARES_SUCCESS, ares__read_line(fp, &buf, &bufsize));
+ EXPECT_EQ("0123456789", std::string(buf));
+ EXPECT_EQ(ARES_SUCCESS, ares__read_line(fp, &buf, &bufsize));
+ EXPECT_EQ("XYZ", std::string(buf));
+ SetAllocFail(1);
+ EXPECT_EQ(ARES_ENOMEM, ares__read_line(fp, &buf, &bufsize));
+ EXPECT_EQ(nullptr, buf);
+
+ fclose(fp);
+ ares_free(buf);
+}
+
+TEST_F(LibraryTest, ReadLineNoBuf) {
+ TempFile temp("abcde\n0123456789\nXYZ\n012345678901234567890");
+ FILE *fp = fopen(temp.filename(), "r");
+ size_t bufsize = 0;
+ char *buf = nullptr;
+
+ SetAllocFail(1);
+ EXPECT_EQ(ARES_ENOMEM, ares__read_line(fp, &buf, &bufsize));
+
+ EXPECT_EQ(ARES_SUCCESS, ares__read_line(fp, &buf, &bufsize));
+ EXPECT_EQ("abcde", std::string(buf));
+ EXPECT_EQ(ARES_SUCCESS, ares__read_line(fp, &buf, &bufsize));
+ EXPECT_EQ("0123456789", std::string(buf));
+ EXPECT_EQ(ARES_SUCCESS, ares__read_line(fp, &buf, &bufsize));
+ EXPECT_EQ("XYZ", std::string(buf));
+ EXPECT_EQ(ARES_SUCCESS, ares__read_line(fp, &buf, &bufsize));
+ EXPECT_EQ("012345678901234567890", std::string(buf));
+
+ fclose(fp);
+ ares_free(buf);
+}
+
+
+TEST_F(FileChannelTest, GetAddrInfoHostsPositive) {
+ TempFile hostsfile("1.2.3.4 example.com \n"
+ " 2.3.4.5\tgoogle.com www.google.com\twww2.google.com\n"
+ "#comment\n"
+ "4.5.6.7\n"
+ "1.3.5.7 \n"
+ "::1 ipv6.com");
+ EnvValue with_env("CARES_HOSTS", hostsfile.filename());
+ struct ares_addrinfo_hints hints = {};
+ AddrInfoResult result = {};
+ hints.ai_family = AF_INET;
+ hints.ai_flags = ARES_AI_CANONNAME | ARES_AI_ENVHOSTS | ARES_AI_NOSORT;
+ ares_getaddrinfo(channel_, "example.com", NULL, &hints, AddrInfoCallback, &result);
+ Process();
+ EXPECT_TRUE(result.done_);
+ std::stringstream ss;
+ ss << result.ai_;
+ EXPECT_EQ("{example.com addr=[1.2.3.4]}", ss.str());
+}
+
+TEST_F(FileChannelTest, GetAddrInfoHostsSpaces) {
+ TempFile hostsfile("1.2.3.4 example.com \n"
+ " 2.3.4.5\tgoogle.com www.google.com\twww2.google.com\n"
+ "#comment\n"
+ "4.5.6.7\n"
+ "1.3.5.7 \n"
+ "::1 ipv6.com");
+ EnvValue with_env("CARES_HOSTS", hostsfile.filename());
+ struct ares_addrinfo_hints hints = {};
+ AddrInfoResult result = {};
+ hints.ai_family = AF_INET;
+ hints.ai_flags = ARES_AI_CANONNAME | ARES_AI_ENVHOSTS | ARES_AI_NOSORT;
+ ares_getaddrinfo(channel_, "google.com", NULL, &hints, AddrInfoCallback, &result);
+ Process();
+ EXPECT_TRUE(result.done_);
+ std::stringstream ss;
+ ss << result.ai_;
+ EXPECT_EQ("{www.google.com->google.com, www2.google.com->google.com addr=[2.3.4.5]}", ss.str());
+}
+
+TEST_F(FileChannelTest, GetAddrInfoHostsByALias) {
+ TempFile hostsfile("1.2.3.4 example.com \n"
+ " 2.3.4.5\tgoogle.com www.google.com\twww2.google.com\n"
+ "#comment\n"
+ "4.5.6.7\n"
+ "1.3.5.7 \n"
+ "::1 ipv6.com");
+ EnvValue with_env("CARES_HOSTS", hostsfile.filename());
+ struct ares_addrinfo_hints hints = {};
+ AddrInfoResult result = {};
+ hints.ai_family = AF_INET;
+ hints.ai_flags = ARES_AI_CANONNAME | ARES_AI_ENVHOSTS | ARES_AI_NOSORT;
+ ares_getaddrinfo(channel_, "www2.google.com", NULL, &hints, AddrInfoCallback, &result);
+ Process();
+ EXPECT_TRUE(result.done_);
+ std::stringstream ss;
+ ss << result.ai_;
+ EXPECT_EQ("{www.google.com->google.com, www2.google.com->google.com addr=[2.3.4.5]}", ss.str());
+}
+
+TEST_F(FileChannelTest, GetAddrInfoHostsIPV6) {
+ TempFile hostsfile("1.2.3.4 example.com \n"
+ " 2.3.4.5\tgoogle.com www.google.com\twww2.google.com\n"
+ "#comment\n"
+ "4.5.6.7\n"
+ "1.3.5.7 \n"
+ "::1 ipv6.com");
+ EnvValue with_env("CARES_HOSTS", hostsfile.filename());
+ struct ares_addrinfo_hints hints = {};
+ AddrInfoResult result = {};
+ hints.ai_family = AF_INET6;
+ hints.ai_flags = ARES_AI_CANONNAME | ARES_AI_ENVHOSTS | ARES_AI_NOSORT;
+ ares_getaddrinfo(channel_, "ipv6.com", NULL, &hints, AddrInfoCallback, &result);
+ Process();
+ EXPECT_TRUE(result.done_);
+ std::stringstream ss;
+ ss << result.ai_;
+ EXPECT_EQ("{ipv6.com addr=[[0000:0000:0000:0000:0000:0000:0000:0001]]}", ss.str());
+}
+
+
+TEST_F(FileChannelTest, GetAddrInfoAllocFail) {
+ TempFile hostsfile("1.2.3.4 example.com alias1 alias2\n");
+ EnvValue with_env("CARES_HOSTS", hostsfile.filename());
+ struct ares_addrinfo_hints hints;
+
+ memset(&hints, 0, sizeof(hints));
+ hints.ai_family = AF_INET;
+
+ // Fail a variety of different memory allocations, and confirm
+ // that the operation either fails with ENOMEM or succeeds
+ // with the expected result.
+ const int kCount = 34;
+ AddrInfoResult results[kCount];
+ for (int ii = 1; ii <= kCount; ii++) {
+ AddrInfoResult* result = &(results[ii - 1]);
+ ClearFails();
+ SetAllocFail(ii);
+ ares_getaddrinfo(channel_, "example.com", NULL, &hints, AddrInfoCallback, result);
+ Process();
+ EXPECT_TRUE(result->done_);
+ if (result->status_ == ARES_SUCCESS) {
+ std::stringstream ss;
+ ss << result->ai_;
+ EXPECT_EQ("{alias1->example.com, alias2->example.com addr=[1.2.3.4]}", ss.str()) << " failed alloc #" << ii;
+ if (verbose) std::cerr << "Succeeded despite failure of alloc #" << ii << std::endl;
+ }
+ }
+}
+
+TEST(Misc, OnionDomain) {
+ EXPECT_EQ(0, ares__is_onion_domain("onion.no"));
+ EXPECT_EQ(0, ares__is_onion_domain(".onion.no"));
+ EXPECT_EQ(1, ares__is_onion_domain(".onion"));
+ EXPECT_EQ(1, ares__is_onion_domain(".onion."));
+ EXPECT_EQ(1, ares__is_onion_domain("yes.onion"));
+ EXPECT_EQ(1, ares__is_onion_domain("yes.onion."));
+ EXPECT_EQ(1, ares__is_onion_domain("YES.ONION"));
+ EXPECT_EQ(1, ares__is_onion_domain("YES.ONION."));
+}
+
+TEST_F(LibraryTest, DNSRecord) {
+ ares_dns_record_t *dnsrec = NULL;
+ ares_dns_rr_t *rr = NULL;
+ struct in_addr addr;
+ struct ares_in6_addr addr6;
+ unsigned char *msg = NULL;
+ size_t msglen = 0;
+ size_t qdcount = 0;
+ size_t ancount = 0;
+ size_t nscount = 0;
+ size_t arcount = 0;
+
+ EXPECT_EQ(ARES_SUCCESS,
+ ares_dns_record_create(&dnsrec, 0x1234,
+ ARES_FLAG_QR|ARES_FLAG_AA|ARES_FLAG_RD|ARES_FLAG_RA,
+ ARES_OPCODE_QUERY, ARES_RCODE_NOERROR));
+
+ /* == Question == */
+ EXPECT_EQ(ARES_SUCCESS,
+ ares_dns_record_query_add(dnsrec, "example.com",
+ ARES_REC_TYPE_ANY,
+ ARES_CLASS_IN));
+
+ /* == Answer == */
+ /* A */
+ EXPECT_EQ(ARES_SUCCESS,
+ ares_dns_record_rr_add(&rr, dnsrec, ARES_SECTION_ANSWER, "example.com",
+ ARES_REC_TYPE_A, ARES_CLASS_IN, 300));
+ EXPECT_LT(0, ares_inet_net_pton(AF_INET, "1.1.1.1", &addr, sizeof(addr)));
+ EXPECT_EQ(ARES_SUCCESS,
+ ares_dns_rr_set_addr(rr, ARES_RR_A_ADDR, &addr));
+ /* AAAA */
+ EXPECT_EQ(ARES_SUCCESS,
+ ares_dns_record_rr_add(&rr, dnsrec, ARES_SECTION_ANSWER, "example.com",
+ ARES_REC_TYPE_AAAA, ARES_CLASS_IN, 300));
+ EXPECT_LT(0, ares_inet_net_pton(AF_INET6, "2600::4", &addr6, sizeof(addr6)));
+ EXPECT_EQ(ARES_SUCCESS,
+ ares_dns_rr_set_addr6(rr, ARES_RR_AAAA_ADDR, &addr6));
+ /* MX */
+ EXPECT_EQ(ARES_SUCCESS,
+ ares_dns_record_rr_add(&rr, dnsrec, ARES_SECTION_ANSWER, "example.com",
+ ARES_REC_TYPE_MX, ARES_CLASS_IN, 3600));
+ EXPECT_EQ(ARES_SUCCESS,
+ ares_dns_rr_set_u16(rr, ARES_RR_MX_PREFERENCE, 10));
+ EXPECT_EQ(ARES_SUCCESS,
+ ares_dns_rr_set_str(rr, ARES_RR_MX_EXCHANGE, "mail.example.com"));
+ /* CNAME */
+ EXPECT_EQ(ARES_SUCCESS,
+ ares_dns_record_rr_add(&rr, dnsrec, ARES_SECTION_ANSWER, "example.com",
+ ARES_REC_TYPE_CNAME, ARES_CLASS_IN, 3600));
+ EXPECT_EQ(ARES_SUCCESS,
+ ares_dns_rr_set_str(rr, ARES_RR_CNAME_CNAME, "b.example.com"));
+ /* TXT */
+ EXPECT_EQ(ARES_SUCCESS,
+ ares_dns_record_rr_add(&rr, dnsrec, ARES_SECTION_ANSWER, "example.com",
+ ARES_REC_TYPE_TXT, ARES_CLASS_IN, 3600));
+ const char txt[] = "blah=here blah=there anywhere";
+ EXPECT_EQ(ARES_SUCCESS,
+ ares_dns_rr_set_bin(rr, ARES_RR_TXT_DATA, (unsigned char *)txt,
+ sizeof(txt)));
+
+ /* == Authority == */
+ /* NS */
+ EXPECT_EQ(ARES_SUCCESS,
+ ares_dns_record_rr_add(&rr, dnsrec, ARES_SECTION_AUTHORITY, "example.com",
+ ARES_REC_TYPE_NS, ARES_CLASS_IN, 38400));
+ EXPECT_EQ(ARES_SUCCESS,
+ ares_dns_rr_set_str(rr, ARES_RR_NS_NSDNAME, "ns1.example.com"));
+ EXPECT_EQ(ARES_SUCCESS,
+ ares_dns_record_rr_add(&rr, dnsrec, ARES_SECTION_AUTHORITY, "example.com",
+ ARES_REC_TYPE_NS, ARES_CLASS_IN, 38400));
+ EXPECT_EQ(ARES_SUCCESS,
+ ares_dns_rr_set_str(rr, ARES_RR_NS_NSDNAME, "ns2.example.com"));
+ /* SOA */
+ EXPECT_EQ(ARES_SUCCESS,
+ ares_dns_record_rr_add(&rr, dnsrec, ARES_SECTION_AUTHORITY, "example.com",
+ ARES_REC_TYPE_SOA, ARES_CLASS_IN, 86400));
+ EXPECT_EQ(ARES_SUCCESS,
+ ares_dns_rr_set_str(rr, ARES_RR_SOA_MNAME, "ns1.example.com"));
+ EXPECT_EQ(ARES_SUCCESS,
+ ares_dns_rr_set_str(rr, ARES_RR_SOA_RNAME, "tech\\.support.example.com"));
+ EXPECT_EQ(ARES_SUCCESS,
+ ares_dns_rr_set_u32(rr, ARES_RR_SOA_SERIAL, 2023110701));
+ EXPECT_EQ(ARES_SUCCESS,
+ ares_dns_rr_set_u32(rr, ARES_RR_SOA_REFRESH, 28800));
+ EXPECT_EQ(ARES_SUCCESS,
+ ares_dns_rr_set_u32(rr, ARES_RR_SOA_RETRY, 7200));
+ EXPECT_EQ(ARES_SUCCESS,
+ ares_dns_rr_set_u32(rr, ARES_RR_SOA_EXPIRE, 604800));
+ EXPECT_EQ(ARES_SUCCESS,
+ ares_dns_rr_set_u32(rr, ARES_RR_SOA_MINIMUM, 86400));
+
+ /* == Additional */
+ /* OPT */
+ EXPECT_EQ(ARES_SUCCESS,
+ ares_dns_record_rr_add(&rr, dnsrec, ARES_SECTION_ADDITIONAL, "",
+ ARES_REC_TYPE_OPT, ARES_CLASS_IN, 0));
+ EXPECT_EQ(ARES_SUCCESS,
+ ares_dns_rr_set_u16(rr, ARES_RR_OPT_UDP_SIZE, 1280));
+ EXPECT_EQ(ARES_SUCCESS,
+ ares_dns_rr_set_u8(rr, ARES_RR_OPT_VERSION, 0));
+ EXPECT_EQ(ARES_SUCCESS,
+ ares_dns_rr_set_u16(rr, ARES_RR_OPT_FLAGS, 0));
+ unsigned char optval[] = { 'c', '-', 'a', 'r', 'e', 's' };
+ EXPECT_EQ(ARES_SUCCESS,
+ ares_dns_rr_set_opt(rr, ARES_RR_OPT_OPTIONS, 3 /* NSID */, optval, sizeof(optval)));
+ /* PTR -- doesn't make sense, but ok */
+ EXPECT_EQ(ARES_SUCCESS,
+ ares_dns_record_rr_add(&rr, dnsrec, ARES_SECTION_ADDITIONAL, "example.com",
+ ARES_REC_TYPE_PTR, ARES_CLASS_IN, 300));
+ EXPECT_EQ(ARES_SUCCESS,
+ ares_dns_rr_set_str(rr, ARES_RR_PTR_DNAME, "b.example.com"));
+ /* HINFO */
+ EXPECT_EQ(ARES_SUCCESS,
+ ares_dns_record_rr_add(&rr, dnsrec, ARES_SECTION_ADDITIONAL, "example.com",
+ ARES_REC_TYPE_HINFO, ARES_CLASS_IN, 300));
+ EXPECT_EQ(ARES_SUCCESS,
+ ares_dns_rr_set_str(rr, ARES_RR_HINFO_CPU, "Virtual"));
+ EXPECT_EQ(ARES_SUCCESS,
+ ares_dns_rr_set_str(rr, ARES_RR_HINFO_OS, "Linux"));
+ /* SRV */
+ EXPECT_EQ(ARES_SUCCESS,
+ ares_dns_record_rr_add(&rr, dnsrec, ARES_SECTION_ADDITIONAL,
+ "_ldap.example.com", ARES_REC_TYPE_SRV, ARES_CLASS_IN, 300));
+ EXPECT_EQ(ARES_SUCCESS,
+ ares_dns_rr_set_u16(rr, ARES_RR_SRV_PRIORITY, 100));
+ EXPECT_EQ(ARES_SUCCESS,
+ ares_dns_rr_set_u16(rr, ARES_RR_SRV_WEIGHT, 1));
+ EXPECT_EQ(ARES_SUCCESS,
+ ares_dns_rr_set_u16(rr, ARES_RR_SRV_PORT, 389));
+ EXPECT_EQ(ARES_SUCCESS,
+ ares_dns_rr_set_str(rr, ARES_RR_SRV_TARGET, "ldap.example.com"));
+ /* TLSA */
+ EXPECT_EQ(ARES_SUCCESS,
+ ares_dns_record_rr_add(&rr, dnsrec, ARES_SECTION_ADDITIONAL,
+ "_443._tcp.example.com", ARES_REC_TYPE_TLSA, ARES_CLASS_IN, 86400));
+ EXPECT_EQ(ARES_SUCCESS,
+ ares_dns_rr_set_u8(rr, ARES_RR_TLSA_CERT_USAGE, ARES_TLSA_USAGE_CA));
+ EXPECT_EQ(ARES_SUCCESS,
+ ares_dns_rr_set_u8(rr, ARES_RR_TLSA_SELECTOR, ARES_TLSA_SELECTOR_FULL));
+ EXPECT_EQ(ARES_SUCCESS,
+ ares_dns_rr_set_u8(rr, ARES_RR_TLSA_MATCH, ARES_TLSA_MATCH_SHA256));
+ const unsigned char tlsa[] = {
+ 0xd2, 0xab, 0xde, 0x24, 0x0d, 0x7c, 0xd3, 0xee, 0x6b, 0x4b, 0x28, 0xc5,
+ 0x4d, 0xf0, 0x34, 0xb9, 0x79, 0x83, 0xa1, 0xd1, 0x6e, 0x8a, 0x41, 0x0e,
+ 0x45, 0x61, 0xcb, 0x10, 0x66, 0x18, 0xe9, 0x71 };
+ EXPECT_EQ(ARES_SUCCESS,
+ ares_dns_rr_set_bin(rr, ARES_RR_TLSA_DATA, tlsa, sizeof(tlsa)));
+ /* SVCB */
+ EXPECT_EQ(ARES_SUCCESS,
+ ares_dns_record_rr_add(&rr, dnsrec, ARES_SECTION_ADDITIONAL,
+ "_1234._bar.example.com", ARES_REC_TYPE_SVCB, ARES_CLASS_IN, 300));
+ EXPECT_EQ(ARES_SUCCESS,
+ ares_dns_rr_set_u16(rr, ARES_RR_SVCB_PRIORITY, 1));
+ EXPECT_EQ(ARES_SUCCESS,
+ ares_dns_rr_set_str(rr, ARES_RR_SVCB_TARGET, "svc1.example.net"));
+ /* IPV6 hint is a list of IPV6 addresses in network byte order, concatenated */
+ struct ares_addr svcb_addr;
+ svcb_addr.family = AF_UNSPEC;
+ size_t svcb_ipv6hint_len = 0;
+ const unsigned char *svcb_ipv6hint = (const unsigned char *)ares_dns_pton("2001:db8::1", &svcb_addr, &svcb_ipv6hint_len);
+ EXPECT_EQ(ARES_SUCCESS,
+ ares_dns_rr_set_opt(rr, ARES_RR_SVCB_PARAMS, ARES_SVCB_PARAM_IPV6HINT,
+ svcb_ipv6hint, svcb_ipv6hint_len));
+ /* Port is 16bit big endian format */
+ unsigned short svcb_port = htons(1234);
+ EXPECT_EQ(ARES_SUCCESS,
+ ares_dns_rr_set_opt(rr, ARES_RR_SVCB_PARAMS, ARES_SVCB_PARAM_PORT,
+ (const unsigned char *)&svcb_port, sizeof(svcb_port)));
+ /* HTTPS */
+ EXPECT_EQ(ARES_SUCCESS,
+ ares_dns_record_rr_add(&rr, dnsrec, ARES_SECTION_ADDITIONAL,
+ "example.com", ARES_REC_TYPE_HTTPS, ARES_CLASS_IN, 300));
+ EXPECT_EQ(ARES_SUCCESS,
+ ares_dns_rr_set_u16(rr, ARES_RR_HTTPS_PRIORITY, 1));
+ EXPECT_EQ(ARES_SUCCESS,
+ ares_dns_rr_set_str(rr, ARES_RR_HTTPS_TARGET, ""));
+
+ /* In DNS string format which is 1 octet length indicator followed by string */
+ const unsigned char https_alpn[] = { 0x02, 'h', '3' };
+ EXPECT_EQ(ARES_SUCCESS,
+ ares_dns_rr_set_opt(rr, ARES_RR_HTTPS_PARAMS, ARES_SVCB_PARAM_ALPN,
+ https_alpn, sizeof(https_alpn)));
+ /* URI */
+ EXPECT_EQ(ARES_SUCCESS,
+ ares_dns_record_rr_add(&rr, dnsrec, ARES_SECTION_ADDITIONAL,
+ "_ftp._tcp.example.com", ARES_REC_TYPE_URI, ARES_CLASS_IN, 3600));
+ EXPECT_EQ(ARES_SUCCESS,
+ ares_dns_rr_set_u16(rr, ARES_RR_URI_PRIORITY, 10));
+ EXPECT_EQ(ARES_SUCCESS,
+ ares_dns_rr_set_u16(rr, ARES_RR_URI_WEIGHT, 1));
+ EXPECT_EQ(ARES_SUCCESS,
+ ares_dns_rr_set_str(rr, ARES_RR_URI_TARGET, "ftp://ftp.example.com/public"));
+ /* CAA */
+ EXPECT_EQ(ARES_SUCCESS,
+ ares_dns_record_rr_add(&rr, dnsrec, ARES_SECTION_ADDITIONAL,
+ "example.com", ARES_REC_TYPE_CAA, ARES_CLASS_IN, 86400));
+ EXPECT_EQ(ARES_SUCCESS,
+ ares_dns_rr_set_u8(rr, ARES_RR_CAA_CRITICAL, 0));
+ EXPECT_EQ(ARES_SUCCESS,
+ ares_dns_rr_set_str(rr, ARES_RR_CAA_TAG, "issue"));
+ unsigned char caa[] = "letsencrypt.org";
+ EXPECT_EQ(ARES_SUCCESS,
+ ares_dns_rr_set_bin(rr, ARES_RR_CAA_VALUE, caa, sizeof(caa)));
+ /* NAPTR */
+ EXPECT_EQ(ARES_SUCCESS,
+ ares_dns_record_rr_add(&rr, dnsrec, ARES_SECTION_ADDITIONAL,
+ "example.com", ARES_REC_TYPE_NAPTR, ARES_CLASS_IN, 86400));
+ EXPECT_EQ(ARES_SUCCESS,
+ ares_dns_rr_set_u16(rr, ARES_RR_NAPTR_ORDER, 100));
+ EXPECT_EQ(ARES_SUCCESS,
+ ares_dns_rr_set_u16(rr, ARES_RR_NAPTR_PREFERENCE, 10));
+ EXPECT_EQ(ARES_SUCCESS,
+ ares_dns_rr_set_str(rr, ARES_RR_NAPTR_FLAGS, "S"));
+ EXPECT_EQ(ARES_SUCCESS,
+ ares_dns_rr_set_str(rr, ARES_RR_NAPTR_SERVICES, "SIP+D2U"));
+ EXPECT_EQ(ARES_SUCCESS,
+ ares_dns_rr_set_str(rr, ARES_RR_NAPTR_REGEXP,
+ "!^.*$!sip:customer-service@example.com!"));
+ EXPECT_EQ(ARES_SUCCESS,
+ ares_dns_rr_set_str(rr, ARES_RR_NAPTR_REPLACEMENT,
+ "_sip._udp.example.com."));
+ /* RAW_RR */
+ EXPECT_EQ(ARES_SUCCESS,
+ ares_dns_record_rr_add(&rr, dnsrec, ARES_SECTION_ADDITIONAL, "",
+ ARES_REC_TYPE_RAW_RR, ARES_CLASS_IN, 0));
+ EXPECT_EQ(ARES_SUCCESS,
+ ares_dns_rr_set_u16(rr, ARES_RR_RAW_RR_TYPE, 65432));
+ unsigned char data[] = { 0x00 };
+ EXPECT_EQ(ARES_SUCCESS,
+ ares_dns_rr_set_bin(rr, ARES_RR_RAW_RR_DATA, data, sizeof(data)));
+
+ qdcount = ares_dns_record_query_cnt(dnsrec);
+ ancount = ares_dns_record_rr_cnt(dnsrec, ARES_SECTION_ANSWER);
+ nscount = ares_dns_record_rr_cnt(dnsrec, ARES_SECTION_AUTHORITY);
+ arcount = ares_dns_record_rr_cnt(dnsrec, ARES_SECTION_ADDITIONAL);
+
+ /* Write */
+ EXPECT_EQ(ARES_SUCCESS, ares_dns_write(dnsrec, &msg, &msglen));
+
+ ares__buf_t *hexdump = ares__buf_create();
+ EXPECT_EQ(ARES_SUCCESS, ares__buf_hexdump(hexdump, msg, msglen));
+ char *hexdata = ares__buf_finish_str(hexdump, NULL);
+ //printf("HEXDUMP\n%s", hexdata);
+ ares_free(hexdata);
+ ares_dns_record_destroy(dnsrec); dnsrec = NULL;
+
+ /* Parse */
+ EXPECT_EQ(ARES_SUCCESS, ares_dns_parse(msg, msglen, 0, &dnsrec));
+ ares_free(msg); msg = NULL;
+
+ /* Re-write */
+ EXPECT_EQ(ARES_SUCCESS, ares_dns_write(dnsrec, &msg, &msglen));
+
+ EXPECT_EQ(qdcount, ares_dns_record_query_cnt(dnsrec));
+ EXPECT_EQ(ancount, ares_dns_record_rr_cnt(dnsrec, ARES_SECTION_ANSWER));
+ EXPECT_EQ(nscount, ares_dns_record_rr_cnt(dnsrec, ARES_SECTION_AUTHORITY));
+ EXPECT_EQ(arcount, ares_dns_record_rr_cnt(dnsrec, ARES_SECTION_ADDITIONAL));
+
+ /* Iterate and print */
+ ares__buf_t *printmsg = ares__buf_create();
+ ares__buf_append_str(printmsg, ";; ->>HEADER<<- opcode: ");
+ ares__buf_append_str(printmsg, ares_dns_opcode_tostr(ares_dns_record_get_opcode(dnsrec)));
+ ares__buf_append_str(printmsg, ", status: ");
+ ares__buf_append_str(printmsg, ares_dns_rcode_tostr(ares_dns_record_get_rcode(dnsrec)));
+ ares__buf_append_str(printmsg, ", id: ");
+ ares__buf_append_num_dec(printmsg, (size_t)ares_dns_record_get_id(dnsrec), 0);
+ ares__buf_append_str(printmsg, "\n;; flags: ");
+ ares__buf_append_num_hex(printmsg, (size_t)ares_dns_record_get_flags(dnsrec), 0);
+ ares__buf_append_str(printmsg, "; QUERY: ");
+ ares__buf_append_num_dec(printmsg, ares_dns_record_query_cnt(dnsrec), 0);
+ ares__buf_append_str(printmsg, ", ANSWER: ");
+ ares__buf_append_num_dec(printmsg, ares_dns_record_rr_cnt(dnsrec, ARES_SECTION_ANSWER), 0);
+ ares__buf_append_str(printmsg, ", AUTHORITY: ");
+ ares__buf_append_num_dec(printmsg, ares_dns_record_rr_cnt(dnsrec, ARES_SECTION_AUTHORITY), 0);
+ ares__buf_append_str(printmsg, ", ADDITIONAL: ");
+ ares__buf_append_num_dec(printmsg, ares_dns_record_rr_cnt(dnsrec, ARES_SECTION_ADDITIONAL), 0);
+ ares__buf_append_str(printmsg, "\n\n");
+ ares__buf_append_str(printmsg, ";; QUESTION SECTION:\n");
+ for (size_t i = 0; i < ares_dns_record_query_cnt(dnsrec); i++) {
+ const char *name;
+ ares_dns_rec_type_t qtype;
+ ares_dns_class_t qclass;
+ ares_dns_record_query_get(dnsrec, i, &name, &qtype, &qclass);
+ ares__buf_append_str(printmsg, ";");
+ ares__buf_append_str(printmsg, name);
+ ares__buf_append_str(printmsg, ".\t\t\t");
+ ares__buf_append_str(printmsg, ares_dns_class_tostr(qclass));
+ ares__buf_append_str(printmsg, "\t");
+ ares__buf_append_str(printmsg, ares_dns_rec_type_tostr(qtype));
+ ares__buf_append_str(printmsg, "\n");
+ }
+ ares__buf_append_str(printmsg, "\n");
+ for (size_t i = ARES_SECTION_ANSWER; i < ARES_SECTION_ADDITIONAL + 1; i++) {
+ ares__buf_append_str(printmsg, ";; ");
+ ares__buf_append_str(printmsg, ares_dns_section_tostr((ares_dns_section_t)i));
+ ares__buf_append_str(printmsg, " SECTION:\n");
+ for (size_t j = 0; j < ares_dns_record_rr_cnt(dnsrec, (ares_dns_section_t)i); j++) {
+ const ares_dns_rr_t *rr = ares_dns_record_rr_get(dnsrec, (ares_dns_section_t)i, j);
+ ares__buf_append_str(printmsg, ares_dns_rr_get_name(rr));
+ ares__buf_append_str(printmsg, ".\t\t\t");
+ ares__buf_append_str(printmsg, ares_dns_class_tostr(ares_dns_rr_get_class(rr)));
+ ares__buf_append_str(printmsg, "\t");
+ ares__buf_append_str(printmsg, ares_dns_rec_type_tostr(ares_dns_rr_get_type(rr)));
+ ares__buf_append_str(printmsg, "\t");
+ ares__buf_append_num_dec(printmsg, ares_dns_rr_get_ttl(rr), 0);
+ ares__buf_append_str(printmsg, "\t");
+
+ size_t keys_cnt;
+ const ares_dns_rr_key_t *keys = ares_dns_rr_get_keys(ares_dns_rr_get_type(rr), &keys_cnt);
+ for (size_t k = 0; k<keys_cnt; k++) {
+ char buf[256] = "";
+ ares__buf_append_str(printmsg, ares_dns_rr_key_tostr(keys[k]));
+ ares__buf_append_str(printmsg, "=");
+ switch (ares_dns_rr_key_datatype(keys[k])) {
+ case ARES_DATATYPE_INADDR:
+ ares_inet_ntop(AF_INET, ares_dns_rr_get_addr(rr, keys[k]), buf, sizeof(buf));
+ ares__buf_append_str(printmsg, buf);
+ break;
+ case ARES_DATATYPE_INADDR6:
+ ares_inet_ntop(AF_INET6, ares_dns_rr_get_addr6(rr, keys[k]), buf, sizeof(buf));
+ ares__buf_append_str(printmsg, buf);
+ break;
+ case ARES_DATATYPE_U8:
+ ares__buf_append_num_dec(printmsg, ares_dns_rr_get_u8(rr, keys[k]), 0);
+ break;
+ case ARES_DATATYPE_U16:
+ ares__buf_append_num_dec(printmsg, ares_dns_rr_get_u16(rr, keys[k]), 0);
+ break;
+ case ARES_DATATYPE_U32:
+ ares__buf_append_num_dec(printmsg, ares_dns_rr_get_u32(rr, keys[k]), 0);
+ break;
+ case ARES_DATATYPE_NAME:
+ case ARES_DATATYPE_STR:
+ ares__buf_append_byte(printmsg, '"');
+ ares__buf_append_str(printmsg, ares_dns_rr_get_str(rr, keys[k]));
+ ares__buf_append_byte(printmsg, '"');
+ break;
+ case ARES_DATATYPE_BIN:
+ /* TODO */
+ break;
+ case ARES_DATATYPE_BINP:
+ ares__buf_append_byte(printmsg, '"');
+ size_t templen;
+ ares__buf_append_str(printmsg, (const char *)ares_dns_rr_get_bin(rr, keys[k], &templen));
+ ares__buf_append_byte(printmsg, '"');
+ break;
+ case ARES_DATATYPE_OPT:
+ /* TODO */
+ break;
+ }
+ ares__buf_append_str(printmsg, " ");
+ }
+ ares__buf_append_str(printmsg, "\n");
+ }
+ }
+ ares__buf_append_str(printmsg, ";; SIZE: ");
+ ares__buf_append_num_dec(printmsg, msglen, 0);
+ ares__buf_append_str(printmsg, "\n\n");
+
+ char *printdata = ares__buf_finish_str(printmsg, NULL);
+ //printf("%s", printdata);
+ ares_free(printdata);
+
+ ares_dns_record_destroy(dnsrec);
+ ares_free(msg);
+}
+
+TEST_F(LibraryTest, CatDomain) {
+ char *s;
+
+ ares__cat_domain("foo", "example.net", &s);
+ EXPECT_STREQ("foo.example.net", s);
+ ares_free(s);
+
+ ares__cat_domain("foo", ".", &s);
+ EXPECT_STREQ("foo.", s);
+ ares_free(s);
+
+ ares__cat_domain("foo", "example.net.", &s);
+ EXPECT_STREQ("foo.example.net.", s);
+ ares_free(s);
+}
+
+TEST_F(LibraryTest, BufMisuse) {
+ EXPECT_EQ(NULL, ares__buf_create_const(NULL, 0));
+ ares__buf_reclaim(NULL);
+ EXPECT_NE(ARES_SUCCESS, ares__buf_append(NULL, NULL, 0));
+ size_t len = 10;
+ EXPECT_EQ(NULL, ares__buf_append_start(NULL, &len));
+ EXPECT_EQ(NULL, ares__buf_append_start(NULL, NULL));
+ ares__buf_append_finish(NULL, 0);
+ EXPECT_EQ(NULL, ares__buf_finish_bin(NULL, NULL));
+ EXPECT_EQ(NULL, ares__buf_finish_str(NULL, NULL));
+ ares__buf_tag(NULL);
+ EXPECT_NE(ARES_SUCCESS, ares__buf_tag_rollback(NULL));
+ EXPECT_NE(ARES_SUCCESS, ares__buf_tag_clear(NULL));
+ EXPECT_EQ(NULL, ares__buf_tag_fetch(NULL, NULL));
+ EXPECT_EQ((size_t)0, ares__buf_tag_length(NULL));
+ EXPECT_NE(ARES_SUCCESS, ares__buf_tag_fetch_bytes(NULL, NULL, NULL));
+ EXPECT_NE(ARES_SUCCESS, ares__buf_tag_fetch_string(NULL, NULL, 0));
+ EXPECT_NE(ARES_SUCCESS, ares__buf_fetch_bytes_dup(NULL, 0, ARES_FALSE, NULL));
+ EXPECT_NE(ARES_SUCCESS, ares__buf_fetch_str_dup(NULL, 0, NULL));
+ EXPECT_EQ((size_t)0, ares__buf_consume_whitespace(NULL, ARES_FALSE));
+ EXPECT_EQ((size_t)0, ares__buf_consume_nonwhitespace(NULL));
+ EXPECT_EQ((size_t)0, ares__buf_consume_line(NULL, ARES_FALSE));
+ EXPECT_EQ(ARES_FALSE, ares__buf_begins_with(NULL, NULL, 0));
+ EXPECT_EQ((size_t)0, ares__buf_get_position(NULL));
+ EXPECT_NE(ARES_SUCCESS, ares__buf_set_position(NULL, 0));
+ EXPECT_NE(ARES_SUCCESS, ares__dns_name_parse(NULL, NULL, ARES_FALSE));
+ EXPECT_NE(ARES_SUCCESS, ares__buf_parse_dns_binstr(NULL, 0, NULL, NULL, ARES_FALSE));
+}
+
+TEST_F(LibraryTest, HtableMisuse) {
+ EXPECT_EQ(NULL, ares__htable_create(NULL, NULL, NULL, NULL));
+ EXPECT_EQ(ARES_FALSE, ares__htable_insert(NULL, NULL));
+ EXPECT_EQ(NULL, ares__htable_get(NULL, NULL));
+ EXPECT_EQ(ARES_FALSE, ares__htable_remove(NULL, NULL));
+ EXPECT_EQ((size_t)0, ares__htable_num_keys(NULL));
+}
+
+TEST_F(LibraryTest, HtableAsvpMisuse) {
+ EXPECT_EQ(ARES_FALSE, ares__htable_asvp_insert(NULL, ARES_SOCKET_BAD, NULL));
+ EXPECT_EQ(ARES_FALSE, ares__htable_asvp_get(NULL, ARES_SOCKET_BAD, NULL));
+ EXPECT_EQ(ARES_FALSE, ares__htable_asvp_remove(NULL, ARES_SOCKET_BAD));
+ EXPECT_EQ((size_t)0, ares__htable_asvp_num_keys(NULL));
+}
+
+TEST_F(LibraryTest, HtableStrvpMisuse) {
+ EXPECT_EQ(ARES_FALSE, ares__htable_strvp_insert(NULL, NULL, NULL));
+ EXPECT_EQ(ARES_FALSE, ares__htable_strvp_get(NULL, NULL, NULL));
+ EXPECT_EQ(ARES_FALSE, ares__htable_strvp_remove(NULL, NULL));
+ EXPECT_EQ((size_t)0, ares__htable_strvp_num_keys(NULL));
+}
+
+TEST_F(LibraryTest, HtableSzvpMisuse) {
+ EXPECT_EQ(ARES_FALSE, ares__htable_szvp_insert(NULL, 0, NULL));
+ EXPECT_EQ(ARES_FALSE, ares__htable_szvp_get(NULL, 0, NULL));
+ EXPECT_EQ(ARES_FALSE, ares__htable_szvp_remove(NULL, 0));
+ EXPECT_EQ((size_t)0, ares__htable_szvp_num_keys(NULL));
+}
+
+TEST_F(LibraryTest, LlistMisuse) {
+ ares__llist_replace_destructor(NULL, NULL);
+ EXPECT_EQ(NULL, ares__llist_insert_before(NULL, NULL));
+ EXPECT_EQ(NULL, ares__llist_insert_after(NULL, NULL));
+ EXPECT_EQ(NULL, ares__llist_node_last(NULL));
+ EXPECT_EQ(NULL, ares__llist_node_next(NULL));
+ EXPECT_EQ(NULL, ares__llist_node_prev(NULL));
+ EXPECT_EQ((size_t)0, ares__llist_len(NULL));
+ EXPECT_EQ(NULL, ares__llist_node_parent(NULL));
+ EXPECT_EQ(NULL, ares__llist_node_claim(NULL));
+ ares__llist_node_replace(NULL, NULL);
+}
+
+TEST_F(LibraryTest, SlistMisuse) {
+ EXPECT_EQ(NULL, ares__slist_create(NULL, NULL, NULL));
+ ares__slist_replace_destructor(NULL, NULL);
+ EXPECT_EQ(NULL, ares__slist_insert(NULL, NULL));
+ EXPECT_EQ(NULL, ares__slist_node_find(NULL, NULL));
+ EXPECT_EQ(NULL, ares__slist_node_first(NULL));
+ EXPECT_EQ(NULL, ares__slist_node_last(NULL));
+ EXPECT_EQ(NULL, ares__slist_node_next(NULL));
+ EXPECT_EQ(NULL, ares__slist_node_prev(NULL));
+ EXPECT_EQ(NULL, ares__slist_node_val(NULL));
+ EXPECT_EQ((size_t)0, ares__slist_len(NULL));
+ EXPECT_EQ(NULL, ares__slist_node_parent(NULL));
+ EXPECT_EQ(NULL, ares__slist_first_val(NULL));
+ EXPECT_EQ(NULL, ares__slist_last_val(NULL));
+ EXPECT_EQ(NULL, ares__slist_node_claim(NULL));
+}
+#endif
+
+TEST_F(DefaultChannelTest, SaveInvalidChannel) {
+ ares__slist_t *saved = channel_->servers;
+ channel_->servers = NULL;
+ struct ares_options opts;
+ int optmask = 0;
+ EXPECT_EQ(ARES_ENODATA, ares_save_options(channel_, &opts, &optmask));
+ channel_->servers = saved;
+}
+
+// Need to put this in own function due to nested lambda bug
+// in VS2013. (C2888)
+static int configure_socket(ares_socket_t s) {
+ // transposed from ares-process, simplified non-block setter.
+#if defined(USE_BLOCKING_SOCKETS)
+ return 0; /* returns success */
+#elif defined(HAVE_FCNTL_O_NONBLOCK)
+ /* most recent unix versions */
+ int flags;
+ flags = fcntl(s, F_GETFL, 0);
+ return fcntl(s, F_SETFL, flags | O_NONBLOCK);
+#elif defined(HAVE_IOCTL_FIONBIO)
+ /* older unix versions */
+ int flags = 1;
+ return ioctl(s, FIONBIO, &flags);
+#elif defined(HAVE_IOCTLSOCKET_FIONBIO)
+#ifdef WATT32
+ char flags = 1;
+#else
+ /* Windows */
+ unsigned long flags = 1UL;
+#endif
+ return ioctlsocket(s, (long)FIONBIO, &flags);
+#elif defined(HAVE_IOCTLSOCKET_CAMEL_FIONBIO)
+ /* Amiga */
+ long flags = 1L;
+ return IoctlSocket(s, FIONBIO, flags);
+#elif defined(HAVE_SETSOCKOPT_SO_NONBLOCK)
+ /* BeOS */
+ long b = 1L;
+ return setsockopt(s, SOL_SOCKET, SO_NONBLOCK, &b, sizeof(b));
+#else
+# error "no non-blocking method was found/used/set"
+#endif
+}
+
+// TODO: This should not really be in this file, but we need ares config
+// flags, and here they are available.
+const struct ares_socket_functions VirtualizeIO::default_functions = {
+ [](int af, int type, int protocol, void *) -> ares_socket_t {
+ auto s = ::socket(af, type, protocol);
+ if (s == ARES_SOCKET_BAD) {
+ return s;
+ }
+ if (configure_socket(s) != 0) {
+ sclose(s);
+ return ares_socket_t(-1);
+ }
+ return s;
+ },
+ NULL,
+ NULL,
+ NULL,
+ NULL
+};
+
+
+} // namespace test
+} // namespace ares
diff --git a/subprojects/c-ares/test/ares-test-live.cc b/subprojects/c-ares/test/ares-test-live.cc
@@ -0,0 +1,823 @@
+/*
+ * Copyright (C) The c-ares project
+ *
+ * Permission to use, copy, modify, and distribute this
+ * software and its documentation for any purpose and without
+ * fee is hereby granted, provided that the above copyright
+ * notice appear in all copies and that both that copyright
+ * notice and this permission notice appear in supporting
+ * documentation, and that the name of M.I.T. not be used in
+ * advertising or publicity pertaining to distribution of the
+ * software without specific, written prior permission.
+ * M.I.T. makes no representations about the suitability of
+ * this software for any purpose. It is provided "as is"
+ * without express or implied warranty.
+ *
+ * SPDX-License-Identifier: MIT
+ */
+// This file includes tests that attempt to do real lookups
+// of DNS names using the local machine's live infrastructure.
+// As a result, we don't check the results very closely, to allow
+// for varying local configurations.
+
+#include "ares-test.h"
+
+#ifdef HAVE_NETDB_H
+#include <netdb.h>
+#endif
+
+namespace ares {
+namespace test {
+
+// Use the address of CloudFlare's public DNS servers as example addresses that are
+// likely to be accessible everywhere/everywhen. We used to use google but they
+// stopped returning reverse dns answers in Dec 2023
+unsigned char cflare_addr4[4] = { 0x01, 0x01, 0x01, 0x01 };
+unsigned char cflare_addr6[16] = {
+ 0x26, 0x06, 0x47, 0x00, 0x47, 0x00, 0x00, 0x00,
+ 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x11, 0x11
+};
+
+MATCHER_P(IncludesAtLeastNumAddresses, n, "") {
+ if(!arg)
+ return false;
+ int cnt = 0;
+ for (const ares_addrinfo_node* ai = arg->nodes; ai != NULL; ai = ai->ai_next)
+ cnt++;
+ return cnt >= n;
+}
+
+MATCHER_P(OnlyIncludesAddrType, addrtype, "") {
+ if(!arg)
+ return false;
+ for (const ares_addrinfo_node* ai = arg->nodes; ai != NULL; ai = ai->ai_next)
+ if (ai->ai_family != addrtype)
+ return false;
+ return true;
+}
+
+MATCHER_P(IncludesAddrType, addrtype, "") {
+ if(!arg)
+ return false;
+ for (const ares_addrinfo_node* ai = arg->nodes; ai != NULL; ai = ai->ai_next)
+ if (ai->ai_family == addrtype)
+ return true;
+ return false;
+}
+
+//VIRT_NONVIRT_TEST_F(DefaultChannelTest, LiveGetAddrInfoV4) {
+ //struct ares_addrinfo_hints hints = {};
+ //hints.ai_family = AF_INET;
+ //AddrInfoResult result;
+ //ares_getaddrinfo(channel_, "www.google.com.", NULL, &hints, AddrInfoCallback, &result);
+ //Process();
+ //EXPECT_TRUE(result.done_);
+ //EXPECT_EQ(ARES_SUCCESS, result.status_);
+ //EXPECT_THAT(result.ai_, IncludesAtLeastNumAddresses(1));
+ //EXPECT_THAT(result.ai_, OnlyIncludesAddrType(AF_INET));
+//}
+
+//VIRT_NONVIRT_TEST_F(DefaultChannelTest, LiveGetAddrInfoV6) {
+ //struct ares_addrinfo_hints hints = {};
+ //hints.ai_family = AF_INET6;
+ //AddrInfoResult result;
+ //ares_getaddrinfo(channel_, "www.google.com.", NULL, &hints, AddrInfoCallback, &result);
+ //Process();
+ //EXPECT_TRUE(result.done_);
+ //EXPECT_EQ(ARES_SUCCESS, result.status_);
+ //EXPECT_THAT(result.ai_, IncludesAtLeastNumAddresses(1));
+ //EXPECT_THAT(result.ai_, OnlyIncludesAddrType(AF_INET6));
+//}
+
+//VIRT_NONVIRT_TEST_F(DefaultChannelTest, LiveGetAddrInfoUnspec) {
+ //struct ares_addrinfo_hints hints = {};
+ //hints.ai_family = AF_UNSPEC;
+ //AddrInfoResult result;
+ //ares_getaddrinfo(channel_, "www.google.com.", NULL, &hints, AddrInfoCallback, &result);
+ //Process();
+ //EXPECT_TRUE(result.done_);
+ //EXPECT_EQ(ARES_SUCCESS, result.status_);
+ //EXPECT_THAT(result.ai_, IncludesAtLeastNumAddresses(2));
+ //EXPECT_THAT(result.ai_, IncludesAddrType(AF_INET6));
+ //EXPECT_THAT(result.ai_, IncludesAddrType(AF_INET));
+//}
+
+VIRT_NONVIRT_TEST_F(DefaultChannelTest, LiveGetHostByNameV4) {
+ HostResult result;
+ ares_gethostbyname(channel_, "www.google.com.", AF_INET, HostCallback, &result);
+ Process();
+ EXPECT_TRUE(result.done_);
+ EXPECT_EQ(ARES_SUCCESS, result.status_);
+ EXPECT_LT(0, (int)result.host_.addrs_.size());
+ EXPECT_EQ(AF_INET, result.host_.addrtype_);
+}
+
+VIRT_NONVIRT_TEST_F(DefaultChannelTest, LiveGetHostByNameV6) {
+ HostResult result;
+ ares_gethostbyname(channel_, "www.google.com.", AF_INET6, HostCallback, &result);
+ Process();
+ EXPECT_TRUE(result.done_);
+ EXPECT_EQ(ARES_SUCCESS, result.status_);
+ EXPECT_LT(0, (int)result.host_.addrs_.size());
+ EXPECT_EQ(AF_INET6, result.host_.addrtype_);
+}
+
+VIRT_NONVIRT_TEST_F(DefaultChannelTest, LiveGetHostByAddrV4) {
+ HostResult result;
+ ares_gethostbyaddr(channel_, cflare_addr4, sizeof(cflare_addr4), AF_INET, HostCallback, &result);
+ Process();
+ EXPECT_TRUE(result.done_);
+ EXPECT_EQ(ARES_SUCCESS, result.status_);
+ EXPECT_LT(0, (int)result.host_.addrs_.size());
+ EXPECT_EQ(AF_INET, result.host_.addrtype_);
+}
+
+VIRT_NONVIRT_TEST_F(DefaultChannelTest, LiveGetHostByAddrV6) {
+ HostResult result;
+ ares_gethostbyaddr(channel_, cflare_addr6, sizeof(cflare_addr6), AF_INET6, HostCallback, &result);
+ Process();
+ EXPECT_TRUE(result.done_);
+ EXPECT_EQ(ARES_SUCCESS, result.status_);
+ EXPECT_LT(0, (int)result.host_.addrs_.size());
+ EXPECT_EQ(AF_INET6, result.host_.addrtype_);
+}
+
+VIRT_NONVIRT_TEST_F(DefaultChannelTest, LiveGetHostByNameFile) {
+ struct hostent *host = nullptr;
+
+ // Still need a channel even to query /etc/hosts.
+ EXPECT_EQ(ARES_ENOTFOUND,
+ ares_gethostbyname_file(nullptr, "localhost", AF_INET, &host));
+
+ int rc = ares_gethostbyname_file(channel_, "bogus.mcname", AF_INET, &host);
+ EXPECT_EQ(nullptr, host);
+ EXPECT_EQ(ARES_ENOTFOUND, rc);
+
+ rc = ares_gethostbyname_file(channel_, "localhost", AF_INET, &host);
+ if (rc == ARES_SUCCESS) {
+ EXPECT_NE(nullptr, host);
+ ares_free_hostent(host);
+ }
+}
+
+TEST_P(DefaultChannelModeTest, LiveGetLocalhostByNameV4) {
+ HostResult result;
+ ares_gethostbyname(channel_, "localhost", AF_INET, HostCallback, &result);
+ Process();
+ EXPECT_TRUE(result.done_);
+ if (result.status_ != ARES_ECONNREFUSED) {
+ EXPECT_EQ(ARES_SUCCESS, result.status_);
+ EXPECT_EQ(1, (int)result.host_.addrs_.size());
+ EXPECT_EQ(AF_INET, result.host_.addrtype_);
+ EXPECT_NE(std::string::npos, result.host_.name_.find("localhost"));
+ }
+}
+
+TEST_P(DefaultChannelModeTest, LiveGetLocalhostByNameV6) {
+ HostResult result;
+ ares_gethostbyname(channel_, "localhost", AF_INET6, HostCallback, &result);
+ Process();
+ EXPECT_TRUE(result.done_);
+ if (result.status_ != ARES_ECONNREFUSED) {
+ EXPECT_EQ(ARES_SUCCESS, result.status_);
+ EXPECT_EQ(1, (int)result.host_.addrs_.size());
+ EXPECT_EQ(AF_INET6, result.host_.addrtype_);
+ std::stringstream ss;
+ ss << HostEnt(result.host_);
+ EXPECT_NE(std::string::npos, result.host_.name_.find("localhost"));
+ }
+}
+
+TEST_P(DefaultChannelModeTest, LiveGetNonExistLocalhostByNameV4) {
+ HostResult result;
+ ares_gethostbyname(channel_, "idonotexist.localhost", AF_INET, HostCallback, &result);
+ Process();
+ EXPECT_TRUE(result.done_);
+ if (result.status_ != ARES_ECONNREFUSED) {
+ EXPECT_EQ(ARES_SUCCESS, result.status_);
+ EXPECT_EQ(1, (int)result.host_.addrs_.size());
+ EXPECT_EQ(AF_INET, result.host_.addrtype_);
+ EXPECT_NE(std::string::npos, result.host_.name_.find("idonotexist.localhost"));
+ }
+}
+
+TEST_P(DefaultChannelModeTest, LiveGetNonExistLocalhostByNameV6) {
+ HostResult result;
+ ares_gethostbyname(channel_, "idonotexist.localhost", AF_INET6, HostCallback, &result);
+ Process();
+ EXPECT_TRUE(result.done_);
+ if (result.status_ != ARES_ECONNREFUSED) {
+ EXPECT_EQ(ARES_SUCCESS, result.status_);
+ EXPECT_EQ(1, (int)result.host_.addrs_.size());
+ EXPECT_EQ(AF_INET6, result.host_.addrtype_);
+ std::stringstream ss;
+ ss << HostEnt(result.host_);
+ EXPECT_NE(std::string::npos, result.host_.name_.find("idonotexist.localhost"));
+ }
+}
+
+TEST_P(DefaultChannelModeTest, LiveGetLocalhostByNameIPV4) {
+ HostResult result;
+ ares_gethostbyname(channel_, "127.0.0.1", AF_INET, HostCallback, &result);
+ Process();
+ EXPECT_TRUE(result.done_);
+ EXPECT_EQ(ARES_SUCCESS, result.status_);
+ EXPECT_EQ(1, (int)result.host_.addrs_.size());
+ EXPECT_EQ(AF_INET, result.host_.addrtype_);
+ std::stringstream ss;
+ ss << HostEnt(result.host_);
+ EXPECT_EQ("{'127.0.0.1' aliases=[] addrs=[127.0.0.1]}", ss.str());
+}
+
+TEST_P(DefaultChannelModeTest, LiveGetLocalhostByNameIPV6) {
+ HostResult result;
+ ares_gethostbyname(channel_, "::1", AF_INET6, HostCallback, &result);
+ Process();
+ EXPECT_TRUE(result.done_);
+ if (result.status_ != ARES_ENOTFOUND) {
+ EXPECT_EQ(ARES_SUCCESS, result.status_);
+ EXPECT_EQ(1, (int)result.host_.addrs_.size());
+ EXPECT_EQ(AF_INET6, result.host_.addrtype_);
+ std::stringstream ss;
+ ss << HostEnt(result.host_);
+ EXPECT_EQ("{'::1' aliases=[] addrs=[0000:0000:0000:0000:0000:0000:0000:0001]}", ss.str());
+ }
+}
+
+TEST_P(DefaultChannelModeTest, LiveGetLocalhostFailFamily) {
+ HostResult result;
+ ares_gethostbyname(channel_, "127.0.0.1", AF_INET+AF_INET6, HostCallback, &result);
+ Process();
+ EXPECT_TRUE(result.done_);
+ EXPECT_EQ(ARES_ENOTIMP, result.status_);
+}
+
+TEST_P(DefaultChannelModeTest, LiveGetLocalhostByAddrV4) {
+ HostResult result;
+ struct in_addr addr;
+ addr.s_addr = htonl(INADDR_LOOPBACK);
+ ares_gethostbyaddr(channel_, &addr, sizeof(addr), AF_INET, HostCallback, &result);
+ Process();
+ EXPECT_TRUE(result.done_);
+ if (result.status_ != ARES_ENOTFOUND) {
+ EXPECT_EQ(ARES_SUCCESS, result.status_);
+ EXPECT_LT(0, (int)result.host_.addrs_.size());
+ EXPECT_EQ(AF_INET, result.host_.addrtype_);
+ // oddly, travis does not resolve to localhost, but a random hostname starting with travis-job
+ if (result.host_.name_.find("travis-job") == std::string::npos) {
+ EXPECT_NE(std::string::npos,
+ result.host_.name_.find("localhost"));
+ }
+ }
+}
+
+TEST_P(DefaultChannelModeTest, LiveGetLocalhostByAddrV6) {
+ HostResult result;
+ struct in6_addr addr;
+ memset(&addr, 0, sizeof(addr));
+ addr.s6_addr[15] = 1; // in6addr_loopback
+ ares_gethostbyaddr(channel_, &addr, sizeof(addr), AF_INET6, HostCallback, &result);
+ Process();
+ EXPECT_TRUE(result.done_);
+ if (result.status_ != ARES_ENOTFOUND) {
+ EXPECT_EQ(ARES_SUCCESS, result.status_);
+ EXPECT_LT(0, (int)result.host_.addrs_.size());
+ EXPECT_EQ(AF_INET6, result.host_.addrtype_);
+ const std::string& name = result.host_.name_;
+ EXPECT_TRUE(std::string::npos != name.find("localhost") ||
+ std::string::npos != name.find("ip6-loopback"));
+ }
+}
+
+TEST_P(DefaultChannelModeTest, LiveGetHostByAddrFailFamily) {
+ HostResult result;
+ unsigned char addr[4] = {8, 8, 8, 8};
+ ares_gethostbyaddr(channel_, addr, sizeof(addr), AF_INET6+AF_INET,
+ HostCallback, &result);
+ EXPECT_TRUE(result.done_);
+ EXPECT_EQ(ARES_ENOTIMP, result.status_);
+}
+
+TEST_P(DefaultChannelModeTest, LiveGetHostByAddrFailAddrSize) {
+ HostResult result;
+ unsigned char addr[4] = {8, 8, 8, 8};
+ ares_gethostbyaddr(channel_, addr, sizeof(addr) - 1, AF_INET,
+ HostCallback, &result);
+ EXPECT_TRUE(result.done_);
+ EXPECT_EQ(ARES_ENOTIMP, result.status_);
+}
+
+TEST_P(DefaultChannelModeTest, LiveGetHostByAddrFailAlloc) {
+ HostResult result;
+ unsigned char addr[4] = {8, 8, 8, 8};
+ SetAllocFail(1);
+ ares_gethostbyaddr(channel_, addr, sizeof(addr), AF_INET,
+ HostCallback, &result);
+ EXPECT_TRUE(result.done_);
+ EXPECT_EQ(ARES_ENOMEM, result.status_);
+}
+
+INSTANTIATE_TEST_SUITE_P(Modes, DefaultChannelModeTest,
+ ::testing::Values("f", "b", "fb", "bf"));
+
+VIRT_NONVIRT_TEST_F(DefaultChannelTest, LiveSearchA) {
+ SearchResult result;
+ ares_search(channel_, "www.youtube.com.", C_IN, T_A,
+ SearchCallback, &result);
+ Process();
+ EXPECT_TRUE(result.done_);
+ EXPECT_EQ(ARES_SUCCESS, result.status_);
+}
+
+VIRT_NONVIRT_TEST_F(DefaultChannelTest, LiveSearchEmptyA) {
+ SearchResult result;
+ ares_search(channel_, "", C_IN, T_A,
+ SearchCallback, &result);
+ Process();
+ EXPECT_TRUE(result.done_);
+ EXPECT_NE(ARES_SUCCESS, result.status_);
+}
+
+VIRT_NONVIRT_TEST_F(DefaultChannelTest, LiveSearchNS) {
+ SearchResult result;
+ ares_search(channel_, "google.com.", C_IN, T_NS,
+ SearchCallback, &result);
+ Process();
+ EXPECT_TRUE(result.done_);
+ EXPECT_EQ(ARES_SUCCESS, result.status_);
+}
+
+VIRT_NONVIRT_TEST_F(DefaultChannelTest, LiveSearchMX) {
+ SearchResult result;
+ ares_search(channel_, "google.com.", C_IN, T_MX,
+ SearchCallback, &result);
+ Process();
+ EXPECT_TRUE(result.done_);
+ EXPECT_EQ(ARES_SUCCESS, result.status_);
+}
+
+VIRT_NONVIRT_TEST_F(DefaultChannelTest, LiveSearchTXT) {
+ SearchResult result;
+ ares_search(channel_, "google.com.", C_IN, T_TXT,
+ SearchCallback, &result);
+ Process();
+ EXPECT_TRUE(result.done_);
+ EXPECT_EQ(ARES_SUCCESS, result.status_);
+}
+
+VIRT_NONVIRT_TEST_F(DefaultChannelTest, LiveSearchSOA) {
+ SearchResult result;
+ ares_search(channel_, "google.com.", C_IN, T_SOA,
+ SearchCallback, &result);
+ Process();
+ EXPECT_TRUE(result.done_);
+ EXPECT_EQ(ARES_SUCCESS, result.status_);
+}
+
+VIRT_NONVIRT_TEST_F(DefaultChannelTest, LiveSearchSRV) {
+ SearchResult result;
+ ares_search(channel_, "_imap._tcp.gmail.com.", C_IN, T_SRV,
+ SearchCallback, &result);
+ Process();
+ EXPECT_TRUE(result.done_);
+ EXPECT_EQ(ARES_SUCCESS, result.status_);
+}
+
+VIRT_NONVIRT_TEST_F(DefaultChannelTest, LiveSearchANY) {
+ SearchResult result;
+ ares_search(channel_, "google.com.", C_IN, T_ANY,
+ SearchCallback, &result);
+ Process();
+ EXPECT_TRUE(result.done_);
+ EXPECT_EQ(ARES_SUCCESS, result.status_);
+}
+
+VIRT_NONVIRT_TEST_F(DefaultChannelTest, LiveGetNameInfoV4) {
+ NameInfoResult result;
+ struct sockaddr_in sockaddr;
+ memset(&sockaddr, 0, sizeof(sockaddr));
+ sockaddr.sin_family = AF_INET;
+ sockaddr.sin_port = htons(53);
+ sockaddr.sin_addr.s_addr = htonl(0x08080808);
+ ares_getnameinfo(channel_, (const struct sockaddr*)&sockaddr, sizeof(sockaddr),
+ ARES_NI_LOOKUPHOST|ARES_NI_LOOKUPSERVICE|ARES_NI_UDP,
+ NameInfoCallback, &result);
+ Process();
+ EXPECT_TRUE(result.done_);
+ EXPECT_EQ(ARES_SUCCESS, result.status_);
+ if (verbose) std::cerr << "8.8.8.8:53 => " << result.node_ << "/" << result.service_ << std::endl;
+}
+
+VIRT_NONVIRT_TEST_F(DefaultChannelTest, LiveGetNameInfoV4NoPort) {
+ NameInfoResult result;
+ struct sockaddr_in sockaddr;
+ memset(&sockaddr, 0, sizeof(sockaddr));
+ sockaddr.sin_family = AF_INET;
+ sockaddr.sin_port = htons(0);
+ sockaddr.sin_addr.s_addr = htonl(0x08080808);
+ ares_getnameinfo(channel_, (const struct sockaddr*)&sockaddr, sizeof(sockaddr),
+ ARES_NI_LOOKUPHOST|ARES_NI_LOOKUPSERVICE|ARES_NI_UDP,
+ NameInfoCallback, &result);
+ Process();
+ EXPECT_TRUE(result.done_);
+ EXPECT_EQ(ARES_SUCCESS, result.status_);
+ if (verbose) std::cerr << "8.8.8.8:0 => " << result.node_ << "/" << result.service_ << std::endl;
+}
+
+VIRT_NONVIRT_TEST_F(DefaultChannelTest, LiveGetNameInfoV4UnassignedPort) {
+ NameInfoResult result;
+ struct sockaddr_in sockaddr;
+ memset(&sockaddr, 0, sizeof(sockaddr));
+ sockaddr.sin_family = AF_INET;
+ sockaddr.sin_port = htons(4); // Unassigned at IANA
+ sockaddr.sin_addr.s_addr = htonl(0x08080808);
+ ares_getnameinfo(channel_, (const struct sockaddr*)&sockaddr, sizeof(sockaddr),
+ ARES_NI_LOOKUPHOST|ARES_NI_LOOKUPSERVICE|ARES_NI_UDP,
+ NameInfoCallback, &result);
+ Process();
+ EXPECT_TRUE(result.done_);
+ EXPECT_EQ(ARES_SUCCESS, result.status_);
+ if (verbose) std::cerr << "8.8.8.8:4 => " << result.node_ << "/" << result.service_ << std::endl;
+}
+
+VIRT_NONVIRT_TEST_F(DefaultChannelTest, LiveGetNameInfoV6Both) {
+ NameInfoResult result;
+ struct sockaddr_in6 sockaddr;
+ memset(&sockaddr, 0, sizeof(sockaddr));
+ sockaddr.sin6_family = AF_INET6;
+ sockaddr.sin6_port = htons(53);
+ memcpy(sockaddr.sin6_addr.s6_addr, cflare_addr6, 16);
+ ares_getnameinfo(channel_, (const struct sockaddr*)&sockaddr, sizeof(sockaddr),
+ ARES_NI_TCP|ARES_NI_LOOKUPHOST|ARES_NI_LOOKUPSERVICE|ARES_NI_NOFQDN,
+ NameInfoCallback, &result);
+ Process();
+ EXPECT_TRUE(result.done_);
+ EXPECT_EQ(ARES_SUCCESS, result.status_);
+ if (verbose) std::cerr << "[2001:4860:4860::8888]:53 => " << result.node_ << "/" << result.service_ << std::endl;
+}
+
+VIRT_NONVIRT_TEST_F(DefaultChannelTest, LiveGetNameInfoV6Neither) {
+ NameInfoResult result;
+ struct sockaddr_in6 sockaddr;
+ memset(&sockaddr, 0, sizeof(sockaddr));
+ sockaddr.sin6_family = AF_INET6;
+ sockaddr.sin6_port = htons(53);
+ memcpy(sockaddr.sin6_addr.s6_addr, cflare_addr6, 16);
+ ares_getnameinfo(channel_, (const struct sockaddr*)&sockaddr, sizeof(sockaddr),
+ ARES_NI_TCP|ARES_NI_NOFQDN, // Neither specified => assume lookup host.
+ NameInfoCallback, &result);
+ Process();
+ EXPECT_TRUE(result.done_);
+ EXPECT_EQ(ARES_SUCCESS, result.status_);
+ if (verbose) std::cerr << "[2001:4860:4860::8888]:53 => " << result.node_ << "/" << result.service_ << std::endl;
+}
+
+VIRT_NONVIRT_TEST_F(DefaultChannelTest, LiveGetNameInfoV4Numeric) {
+ NameInfoResult result;
+ struct sockaddr_in sockaddr;
+ memset(&sockaddr, 0, sizeof(sockaddr));
+ sockaddr.sin_family = AF_INET;
+ sockaddr.sin_port = htons(53);
+ sockaddr.sin_addr.s_addr = htonl(0x08080808);
+ ares_getnameinfo(channel_, (const struct sockaddr*)&sockaddr, sizeof(sockaddr),
+ ARES_NI_LOOKUPHOST|ARES_NI_LOOKUPSERVICE|ARES_NI_TCP|ARES_NI_NUMERICHOST,
+ NameInfoCallback, &result);
+ Process();
+ EXPECT_TRUE(result.done_);
+ EXPECT_EQ(ARES_SUCCESS, result.status_);
+ EXPECT_EQ("8.8.8.8", result.node_);
+ if (verbose) std::cerr << "8.8.8.8:53 => " << result.node_ << "/" << result.service_ << std::endl;
+}
+
+VIRT_NONVIRT_TEST_F(DefaultChannelTest, LiveGetNameInfoV6Numeric) {
+ NameInfoResult result;
+ struct sockaddr_in6 sockaddr;
+ memset(&sockaddr, 0, sizeof(sockaddr));
+ sockaddr.sin6_family = AF_INET6;
+ sockaddr.sin6_port = htons(53);
+ memcpy(sockaddr.sin6_addr.s6_addr, cflare_addr6, 16);
+ ares_getnameinfo(channel_, (const struct sockaddr*)&sockaddr, sizeof(sockaddr),
+ ARES_NI_LOOKUPHOST|ARES_NI_LOOKUPSERVICE|ARES_NI_DCCP|ARES_NI_NUMERICHOST,
+ NameInfoCallback, &result);
+ Process();
+ EXPECT_TRUE(result.done_);
+ EXPECT_EQ(ARES_SUCCESS, result.status_);
+ EXPECT_EQ("2606:4700:4700::1111%0", result.node_);
+ if (verbose) std::cerr << "[2606:4700:4700::1111]:53 => " << result.node_ << "/" << result.service_ << std::endl;
+}
+
+VIRT_NONVIRT_TEST_F(DefaultChannelTest, LiveGetNameInfoV6LinkLocal) {
+ NameInfoResult result;
+ struct sockaddr_in6 sockaddr;
+ memset(&sockaddr, 0, sizeof(sockaddr));
+ sockaddr.sin6_family = AF_INET6;
+ sockaddr.sin6_port = htons(53);
+ unsigned char addr6[16] = {0xfe, 0x80, 0x01, 0x02, 0x01, 0x02, 0x00, 0x00,
+ 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x03, 0x04};
+ memcpy(sockaddr.sin6_addr.s6_addr, addr6, 16);
+ ares_getnameinfo(channel_, (const struct sockaddr*)&sockaddr, sizeof(sockaddr),
+ ARES_NI_LOOKUPHOST|ARES_NI_LOOKUPSERVICE|ARES_NI_DCCP|ARES_NI_NUMERICHOST,
+ NameInfoCallback, &result);
+ Process();
+ EXPECT_TRUE(result.done_);
+ EXPECT_EQ(ARES_SUCCESS, result.status_);
+ EXPECT_EQ("fe80:102:102::304%0", result.node_);
+ if (verbose) std::cerr << "[fe80:102:102::304]:53 => " << result.node_ << "/" << result.service_ << std::endl;
+}
+
+VIRT_NONVIRT_TEST_F(DefaultChannelTest, LiveGetNameInfoV4NotFound) {
+ NameInfoResult result;
+ struct sockaddr_in sockaddr;
+ memset(&sockaddr, 0, sizeof(sockaddr));
+ sockaddr.sin_family = AF_INET;
+ sockaddr.sin_port = htons(4); // Port 4 unassigned at IANA
+ // RFC5737 says 192.0.2.0 should not be used publicly.
+ sockaddr.sin_addr.s_addr = htonl(0xC0000200);
+ ares_getnameinfo(channel_, (const struct sockaddr*)&sockaddr, sizeof(sockaddr),
+ ARES_NI_LOOKUPHOST|ARES_NI_LOOKUPSERVICE|ARES_NI_UDP,
+ NameInfoCallback, &result);
+ Process();
+ EXPECT_TRUE(result.done_);
+ EXPECT_EQ(ARES_SUCCESS, result.status_);
+ EXPECT_EQ("192.0.2.0", result.node_);
+ if (verbose) std::cerr << "192.0.2.0:53 => " << result.node_ << "/" << result.service_ << std::endl;
+}
+
+VIRT_NONVIRT_TEST_F(DefaultChannelTest, LiveGetNameInfoV4NotFoundFail) {
+ NameInfoResult result;
+ struct sockaddr_in sockaddr;
+ memset(&sockaddr, 0, sizeof(sockaddr));
+ sockaddr.sin_family = AF_INET;
+ sockaddr.sin_port = htons(53);
+ // RFC5737 says 192.0.2.0 should not be used publicly.
+ sockaddr.sin_addr.s_addr = htonl(0xC0000200);
+ ares_getnameinfo(channel_, (const struct sockaddr*)&sockaddr, sizeof(sockaddr),
+ ARES_NI_LOOKUPHOST|ARES_NI_LOOKUPSERVICE|ARES_NI_UDP|ARES_NI_NAMEREQD,
+ NameInfoCallback, &result);
+ Process();
+ EXPECT_TRUE(result.done_);
+ EXPECT_EQ(ARES_ENOTFOUND, result.status_);
+}
+
+VIRT_NONVIRT_TEST_F(DefaultChannelTest, LiveGetNameInfoV6NotFound) {
+ NameInfoResult result;
+ struct sockaddr_in6 sockaddr;
+ memset(&sockaddr, 0, sizeof(sockaddr));
+ sockaddr.sin6_family = AF_INET6;
+ sockaddr.sin6_port = htons(53);
+ // 2001:db8::/32 is only supposed to be used in documentation.
+ unsigned char addr6[16] = {0x20, 0x01, 0x0d, 0xb8, 0x01, 0x02, 0x00, 0x00,
+ 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x03, 0x04};
+ memcpy(sockaddr.sin6_addr.s6_addr, addr6, 16);
+ ares_getnameinfo(channel_, (const struct sockaddr*)&sockaddr, sizeof(sockaddr),
+ ARES_NI_LOOKUPHOST|ARES_NI_LOOKUPSERVICE|ARES_NI_UDP,
+ NameInfoCallback, &result);
+ Process();
+ EXPECT_TRUE(result.done_);
+ EXPECT_EQ(ARES_SUCCESS, result.status_);
+ EXPECT_EQ("2001:db8:102::304%0", result.node_);
+ if (verbose) std::cerr << "[2001:db8:102::304]:53 => " << result.node_ << "/" << result.service_ << std::endl;
+}
+
+VIRT_NONVIRT_TEST_F(DefaultChannelTest, LiveGetNameInvalidFamily) {
+ NameInfoResult result;
+ struct sockaddr_in6 sockaddr;
+ memset(&sockaddr, 0, sizeof(sockaddr));
+ sockaddr.sin6_family = AF_INET6 + AF_INET;
+ sockaddr.sin6_port = htons(53);
+ memcpy(sockaddr.sin6_addr.s6_addr, cflare_addr6, 16);
+ ares_getnameinfo(channel_, (const struct sockaddr*)&sockaddr, sizeof(sockaddr),
+ ARES_NI_LOOKUPHOST|ARES_NI_LOOKUPSERVICE|ARES_NI_UDP,
+ NameInfoCallback, &result);
+ Process();
+ EXPECT_TRUE(result.done_);
+ EXPECT_EQ(ARES_ENOTIMP, result.status_);
+}
+
+VIRT_NONVIRT_TEST_F(DefaultChannelTest, LiveGetNameInvalidFlags) {
+ NameInfoResult result;
+ struct sockaddr_in6 sockaddr;
+ memset(&sockaddr, 0, sizeof(sockaddr));
+ sockaddr.sin6_family = AF_INET6;
+ sockaddr.sin6_port = htons(53);
+ memcpy(sockaddr.sin6_addr.s6_addr, cflare_addr6, 16);
+ // Ask for both a name-required, and a numeric host.
+ ares_getnameinfo(channel_, (const struct sockaddr*)&sockaddr, sizeof(sockaddr),
+ ARES_NI_LOOKUPHOST|ARES_NI_LOOKUPSERVICE|ARES_NI_UDP|ARES_NI_NUMERICHOST|ARES_NI_NAMEREQD,
+ NameInfoCallback, &result);
+ Process();
+ EXPECT_TRUE(result.done_);
+ EXPECT_EQ(ARES_EBADFLAGS, result.status_);
+}
+
+VIRT_NONVIRT_TEST_F(DefaultChannelTest, LiveGetServiceInfo) {
+ NameInfoResult result;
+ struct sockaddr_in sockaddr;
+ memset(&sockaddr, 0, sizeof(sockaddr));
+ sockaddr.sin_family = AF_INET;
+ sockaddr.sin_port = htons(53);
+ sockaddr.sin_addr.s_addr = htonl(0x08080808);
+ // Just look up service info
+ ares_getnameinfo(channel_, (const struct sockaddr*)&sockaddr, sizeof(sockaddr),
+ ARES_NI_LOOKUPSERVICE|ARES_NI_SCTP,
+ NameInfoCallback, &result);
+ Process();
+ EXPECT_TRUE(result.done_);
+ EXPECT_EQ(ARES_SUCCESS, result.status_);
+ EXPECT_EQ("", result.node_);
+}
+
+VIRT_NONVIRT_TEST_F(DefaultChannelTest, LiveGetServiceInfoNumeric) {
+ NameInfoResult result;
+ struct sockaddr_in sockaddr;
+ memset(&sockaddr, 0, sizeof(sockaddr));
+ sockaddr.sin_family = AF_INET;
+ sockaddr.sin_port = htons(53);
+ sockaddr.sin_addr.s_addr = htonl(0x08080808);
+ // Just look up service info
+ ares_getnameinfo(channel_, (const struct sockaddr*)&sockaddr, sizeof(sockaddr),
+ ARES_NI_LOOKUPSERVICE|ARES_NI_SCTP|ARES_NI_NUMERICSERV,
+ NameInfoCallback, &result);
+ Process();
+ EXPECT_TRUE(result.done_);
+ EXPECT_EQ(ARES_SUCCESS, result.status_);
+ EXPECT_EQ("", result.node_);
+ EXPECT_EQ("53", result.service_);
+}
+
+VIRT_NONVIRT_TEST_F(DefaultChannelTest, LiveGetNameInfoAllocFail) {
+ NameInfoResult result;
+ struct sockaddr_in sockaddr;
+ memset(&sockaddr, 0, sizeof(sockaddr));
+ sockaddr.sin_family = AF_INET;
+ sockaddr.sin_port = htons(53);
+ sockaddr.sin_addr.s_addr = htonl(0x08080808);
+ SetAllocFail(1);
+ ares_getnameinfo(channel_, (const struct sockaddr*)&sockaddr, sizeof(sockaddr),
+ ARES_NI_LOOKUPHOST|ARES_NI_LOOKUPSERVICE|ARES_NI_UDP,
+ NameInfoCallback, &result);
+ Process();
+ EXPECT_TRUE(result.done_);
+ EXPECT_EQ(ARES_ENOMEM, result.status_);
+}
+
+VIRT_NONVIRT_TEST_F(DefaultChannelTest, GetSock) {
+ ares_socket_t socks[3] = {ARES_SOCKET_BAD, ARES_SOCKET_BAD, ARES_SOCKET_BAD};
+ int bitmask = ares_getsock(channel_, socks, 3);
+ EXPECT_EQ(0, bitmask);
+ bitmask = ares_getsock(channel_, nullptr, 0);
+ EXPECT_EQ(0, bitmask);
+
+ // Ask again with a pending query.
+ HostResult result;
+ ares_gethostbyname(channel_, "www.google.com.", AF_INET, HostCallback, &result);
+ bitmask = ares_getsock(channel_, socks, 3);
+ EXPECT_NE(0, bitmask);
+
+ size_t sock_cnt = 0;
+ for (size_t i=0; i<3; i++) {
+ if (ARES_GETSOCK_READABLE(bitmask, i) || ARES_GETSOCK_WRITABLE(bitmask, i)) {
+ EXPECT_NE(ARES_SOCKET_BAD, socks[i]);
+ if (socks[i] != ARES_SOCKET_BAD)
+ sock_cnt++;
+ }
+ }
+ EXPECT_NE((size_t)0, sock_cnt);
+
+ bitmask = ares_getsock(channel_, nullptr, 0);
+ EXPECT_EQ(0, bitmask);
+
+ Process();
+}
+
+TEST_F(LibraryTest, GetTCPSock) {
+ ares_channel_t *channel;
+ struct ares_options opts;
+ memset(&opts, 0, sizeof(opts));
+ opts.tcp_port = 53;
+ opts.flags = ARES_FLAG_USEVC;
+ int optmask = ARES_OPT_TCP_PORT | ARES_OPT_FLAGS;
+ EXPECT_EQ(ARES_SUCCESS, ares_init_options(&channel, &opts, optmask));
+ EXPECT_NE(nullptr, channel);
+
+ ares_socket_t socks[3] = {ARES_SOCKET_BAD, ARES_SOCKET_BAD, ARES_SOCKET_BAD};
+ int bitmask = ares_getsock(channel, socks, 3);
+ EXPECT_EQ(0, bitmask);
+ bitmask = ares_getsock(channel, nullptr, 0);
+ EXPECT_EQ(0, bitmask);
+
+ // Ask again with a pending query.
+ HostResult result;
+ ares_gethostbyname(channel, "www.google.com.", AF_INET, HostCallback, &result);
+ bitmask = ares_getsock(channel, socks, 3);
+ EXPECT_NE(0, bitmask);
+
+ size_t sock_cnt = 0;
+ for (size_t i=0; i<3; i++) {
+ if (ARES_GETSOCK_READABLE(bitmask, i) || ARES_GETSOCK_WRITABLE(bitmask, i)) {
+ EXPECT_NE(ARES_SOCKET_BAD, socks[i]);
+ if (socks[i] != ARES_SOCKET_BAD)
+ sock_cnt++;
+ }
+ }
+ EXPECT_NE((size_t)0, sock_cnt);
+
+ bitmask = ares_getsock(channel, nullptr, 0);
+ EXPECT_EQ(0, bitmask);
+
+ ProcessWork(channel, NoExtraFDs, nullptr);
+
+ ares_destroy(channel);
+}
+
+TEST_F(DefaultChannelTest, VerifySocketFunctionCallback) {
+ VirtualizeIO vio(channel_);
+
+ auto my_functions = VirtualizeIO::default_functions;
+ size_t count = 0;
+
+ my_functions.asocket = [](int af, int type, int protocol, void * p) -> ares_socket_t {
+ EXPECT_NE(nullptr, p);
+ (*reinterpret_cast<size_t *>(p))++;
+ return ::socket(af, type, protocol);
+ };
+
+ ares_set_socket_functions(channel_, &my_functions, &count);
+
+ {
+ count = 0;
+ HostResult result;
+ ares_gethostbyname(channel_, "www.google.com.", AF_INET, HostCallback, &result);
+ Process();
+
+ EXPECT_TRUE(result.done_);
+ EXPECT_NE((size_t)0, count);
+ }
+
+ {
+ count = 0;
+ ares_channel_t *copy;
+ EXPECT_EQ(ARES_SUCCESS, ares_dup(©, channel_));
+
+ HostResult result;
+ ares_gethostbyname(copy, "www.google.com.", AF_INET, HostCallback, &result);
+
+ ProcessWork(copy, NoExtraFDs, nullptr);
+
+ EXPECT_TRUE(result.done_);
+ ares_destroy(copy);
+ EXPECT_NE((size_t)0, count);
+ }
+
+}
+
+TEST_F(DefaultChannelTest, LiveSetServers) {
+ struct ares_addr_node server1;
+ struct ares_addr_node server2;
+ server1.next = &server2;
+ server1.family = AF_INET;
+ server1.addr.addr4.s_addr = htonl(0x01020304);
+ server2.next = nullptr;
+ server2.family = AF_INET;
+ server2.addr.addr4.s_addr = htonl(0x02030405);
+
+ HostResult result;
+ ares_gethostbyname(channel_, "www.google.com.", AF_INET, HostCallback, &result);
+ EXPECT_EQ(ARES_SUCCESS, ares_set_servers(channel_, &server1));
+ ares_cancel(channel_);
+}
+
+TEST_F(DefaultChannelTest, LiveSetServersPorts) {
+ struct ares_addr_port_node server1;
+ struct ares_addr_port_node server2;
+ server1.next = &server2;
+ server1.family = AF_INET;
+ server1.addr.addr4.s_addr = htonl(0x01020304);
+ server1.udp_port = 111;
+ server1.tcp_port = 111;
+ server2.next = nullptr;
+ server2.family = AF_INET;
+ server2.addr.addr4.s_addr = htonl(0x02030405);
+ server2.udp_port = 0;
+ server2.tcp_port = 0;;
+ EXPECT_EQ(ARES_ENODATA, ares_set_servers_ports(nullptr, &server1));
+
+ // Change while pending will requeue any requests to new servers
+ HostResult result;
+ ares_gethostbyname(channel_, "www.google.com.", AF_INET, HostCallback, &result);
+ EXPECT_EQ(ARES_SUCCESS, ares_set_servers_ports(channel_, &server1));
+ ares_cancel(channel_);
+}
+
+TEST_F(DefaultChannelTest, LiveSetServersCSV) {
+ HostResult result;
+ ares_gethostbyname(channel_, "www.google.com.", AF_INET, HostCallback, &result);
+ // Change while pending will requeue any requests to new servers
+ EXPECT_EQ(ARES_SUCCESS, ares_set_servers_csv(channel_, "1.2.3.4,2.3.4.5"));
+ EXPECT_EQ(ARES_SUCCESS, ares_set_servers_ports_csv(channel_, "1.2.3.4:56,2.3.4.5:67"));
+ ares_cancel(channel_);
+}
+
+
+} // namespace test
+} // namespace ares
diff --git a/subprojects/c-ares/test/ares-test-main.cc b/subprojects/c-ares/test/ares-test-main.cc
@@ -0,0 +1,60 @@
+/*
+ * Copyright (C) The c-ares project
+ *
+ * Permission to use, copy, modify, and distribute this
+ * software and its documentation for any purpose and without
+ * fee is hereby granted, provided that the above copyright
+ * notice appear in all copies and that both that copyright
+ * notice and this permission notice appear in supporting
+ * documentation, and that the name of M.I.T. not be used in
+ * advertising or publicity pertaining to distribution of the
+ * software without specific, written prior permission.
+ * M.I.T. makes no representations about the suitability of
+ * this software for any purpose. It is provided "as is"
+ * without express or implied warranty.
+ *
+ * SPDX-License-Identifier: MIT
+ */
+#include <signal.h>
+#include <stdlib.h>
+
+#include "ares-test.h"
+
+int main(int argc, char* argv[]) {
+ std::vector<char*> gtest_argv = {argv[0]};
+ for (int ii = 1; ii < argc; ii++) {
+ if (strcmp(argv[ii], "-v") == 0) {
+ ares::test::verbose = true;
+ } else if ((strcmp(argv[ii], "-p") == 0) && (ii + 1 < argc)) {
+ ii++;
+ ares::test::mock_port = (unsigned short)atoi(argv[ii]);
+ } else if (strcmp(argv[ii], "-4") == 0) {
+ ares::test::families = ares::test::ipv4_family;
+ ares::test::families_modes = ares::test::ipv4_family_both_modes;
+ } else if (strcmp(argv[ii], "-6") == 0) {
+ ares::test::families = ares::test::ipv6_family;
+ ares::test::families_modes = ares::test::ipv6_family_both_modes;
+ } else {
+ gtest_argv.push_back(argv[ii]);
+ }
+ }
+ int gtest_argc = (int)gtest_argv.size();
+ gtest_argv.push_back(nullptr);
+ ::testing::InitGoogleTest(>est_argc, gtest_argv.data());
+
+#ifdef WIN32
+ WORD wVersionRequested = MAKEWORD(2, 2);
+ WSADATA wsaData;
+ WSAStartup(wVersionRequested, &wsaData);
+#else
+ signal(SIGPIPE, SIG_IGN);
+#endif
+
+ int rc = RUN_ALL_TESTS();
+
+#ifdef WIN32
+ WSACleanup();
+#endif
+
+ return rc;
+}
diff --git a/subprojects/c-ares/test/ares-test-misc.cc b/subprojects/c-ares/test/ares-test-misc.cc
@@ -0,0 +1,572 @@
+/*
+ * Copyright (C) The c-ares project
+ *
+ * Permission to use, copy, modify, and distribute this
+ * software and its documentation for any purpose and without
+ * fee is hereby granted, provided that the above copyright
+ * notice appear in all copies and that both that copyright
+ * notice and this permission notice appear in supporting
+ * documentation, and that the name of M.I.T. not be used in
+ * advertising or publicity pertaining to distribution of the
+ * software without specific, written prior permission.
+ * M.I.T. makes no representations about the suitability of
+ * this software for any purpose. It is provided "as is"
+ * without express or implied warranty.
+ *
+ * SPDX-License-Identifier: MIT
+ */
+#include "ares-test.h"
+#include "dns-proto.h"
+
+#include <string>
+#include <vector>
+
+namespace ares {
+namespace test {
+
+TEST_F(DefaultChannelTest, GetServers) {
+ std::string servers = GetNameServers(channel_);
+ if (verbose) {
+ std::cerr << "Nameserver: " << servers << std::endl;
+ }
+}
+
+TEST_F(DefaultChannelTest, GetServersFailures) {
+ EXPECT_EQ(ARES_SUCCESS,
+ ares_set_servers_csv(channel_, "1.2.3.4,2.3.4.5"));
+ struct ares_addr_node* servers = nullptr;
+ SetAllocFail(1);
+ EXPECT_EQ(ARES_ENOMEM, ares_get_servers(channel_, &servers));
+ SetAllocFail(2);
+ EXPECT_EQ(ARES_ENOMEM, ares_get_servers(channel_, &servers));
+ EXPECT_EQ(ARES_ENODATA, ares_get_servers(nullptr, &servers));
+}
+
+TEST_F(DefaultChannelTest, SetServers) {
+ /* NOTE: This test is because we have actual external users doing test case
+ * simulation and removing all servers to generate various error
+ * conditions in their own code. It would make more sense to return
+ * ARES_ENODATA, but due to historical users, we can't break them.
+ * See: https://github.com/nodejs/node/pull/50800
+ */
+ EXPECT_EQ(ARES_SUCCESS, ares_set_servers(channel_, nullptr));
+ std::string expected_empty = "";
+ EXPECT_EQ(expected_empty, GetNameServers(channel_));
+ HostResult result;
+ ares_gethostbyname(channel_, "www.google.com.", AF_INET, HostCallback, &result);
+ Process();
+ EXPECT_TRUE(result.done_);
+ EXPECT_EQ(ARES_ESERVFAIL, result.status_);
+
+
+ struct ares_addr_node server1;
+ struct ares_addr_node server2;
+ server1.next = &server2;
+ server1.family = AF_INET;
+ server1.addr.addr4.s_addr = htonl(0x01020304);
+ server2.next = nullptr;
+ server2.family = AF_INET;
+ server2.addr.addr4.s_addr = htonl(0x02030405);
+ EXPECT_EQ(ARES_ENODATA, ares_set_servers(nullptr, &server1));
+
+ EXPECT_EQ(ARES_SUCCESS, ares_set_servers(channel_, &server1));
+ std::string expected = "1.2.3.4:53,2.3.4.5:53";
+ EXPECT_EQ(expected, GetNameServers(channel_));
+}
+
+TEST_F(DefaultChannelTest, SetServersPorts) {
+ /* NOTE: This test is because we have actual external users doing test case
+ * simulation and removing all servers to generate various error
+ * conditions in their own code. It would make more sense to return
+ * ARES_ENODATA, but due to historical users, we can't break them.
+ * See: https://github.com/nodejs/node/pull/50800
+ */
+ EXPECT_EQ(ARES_SUCCESS, ares_set_servers_ports(channel_, nullptr));
+ std::string expected_empty = "";
+ EXPECT_EQ(expected_empty, GetNameServers(channel_));
+
+ struct ares_addr_port_node server1;
+ struct ares_addr_port_node server2;
+ server1.next = &server2;
+ server1.family = AF_INET;
+ server1.addr.addr4.s_addr = htonl(0x01020304);
+ server1.udp_port = 111;
+ server1.tcp_port = 111;
+ server2.next = nullptr;
+ server2.family = AF_INET;
+ server2.addr.addr4.s_addr = htonl(0x02030405);
+ server2.udp_port = 0;
+ server2.tcp_port = 0;;
+ EXPECT_EQ(ARES_ENODATA, ares_set_servers_ports(nullptr, &server1));
+
+ EXPECT_EQ(ARES_SUCCESS, ares_set_servers_ports(channel_, &server1));
+ std::string expected = "1.2.3.4:111,2.3.4.5:53";
+ EXPECT_EQ(expected, GetNameServers(channel_));
+}
+
+TEST_F(DefaultChannelTest, SetServersCSV) {
+ EXPECT_EQ(ARES_ENODATA, ares_set_servers_csv(nullptr, "1.2.3.4"));
+ EXPECT_EQ(ARES_ENODATA, ares_set_servers_csv(nullptr, "xyzzy,plugh"));
+ EXPECT_EQ(ARES_ENODATA, ares_set_servers_csv(nullptr, "256.1.2.3"));
+ EXPECT_EQ(ARES_ENODATA, ares_set_servers_csv(nullptr, "1.2.3.4.5"));
+ EXPECT_EQ(ARES_ENODATA, ares_set_servers_csv(nullptr, "1:2:3:4:5"));
+
+ /* NOTE: This test is because we have actual external users doing test case
+ * simulation and removing all servers to generate various error
+ * conditions in their own code. It would make more sense to return
+ * ARES_ENODATA, but due to historical users, we can't break them.
+ * See: https://github.com/nodejs/node/pull/50800
+ */
+ EXPECT_EQ(ARES_SUCCESS, ares_set_servers_csv(channel_, NULL));
+ std::string expected_empty = "";
+ EXPECT_EQ(expected_empty, GetNameServers(channel_));
+ EXPECT_EQ(ARES_SUCCESS, ares_set_servers_csv(channel_, ""));
+ EXPECT_EQ(expected_empty, GetNameServers(channel_));
+
+
+ EXPECT_EQ(ARES_SUCCESS,
+ ares_set_servers_csv(channel_, "1.2.3.4,0102:0304:0506:0708:0910:1112:1314:1516,2.3.4.5"));
+ std::string expected = "1.2.3.4:53,[102:304:506:708:910:1112:1314:1516]:53,2.3.4.5:53";
+ EXPECT_EQ(expected, GetNameServers(channel_));
+
+ // Same, with spaces
+ EXPECT_EQ(ARES_SUCCESS,
+ ares_set_servers_csv(channel_, "1.2.3.4 , [0102:0304:0506:0708:0910:1112:1314:1516]:53, 2.3.4.5"));
+ EXPECT_EQ(expected, GetNameServers(channel_));
+
+ // Ignore invalid link-local interface, keep rest.
+ EXPECT_EQ(ARES_SUCCESS,
+ ares_set_servers_csv(channel_, "1.2.3.4 , [0102:0304:0506:0708:0910:1112:1314:1516]:53, [fe80::1]:53%iface0, 2.3.4.5"));
+ EXPECT_EQ(expected, GetNameServers(channel_));
+
+ // Same, with ports
+ EXPECT_EQ(ARES_SUCCESS,
+ ares_set_servers_ports_csv(channel_, "1.2.3.4:54,[0102:0304:0506:0708:0910:1112:1314:1516]:80,2.3.4.5:55"));
+ std::string expected2 = {"1.2.3.4:54,[102:304:506:708:910:1112:1314:1516]:80,2.3.4.5:55"};
+ EXPECT_EQ(expected2, GetNameServers(channel_));
+
+ // Should survive duplication
+ ares_channel_t *channel2;
+ EXPECT_EQ(ARES_SUCCESS, ares_dup(&channel2, channel_));
+ EXPECT_EQ(expected2, GetNameServers(channel2));
+ ares_destroy(channel2);
+
+ // Allocation failure cases
+ for (int fail = 1; fail <= 5; fail++) {
+ SetAllocFail(fail);
+ EXPECT_EQ(ARES_ENOMEM,
+ ares_set_servers_csv(channel_, "1.2.3.4,0102:0304:0506:0708:0910:1112:1314:1516,2.3.4.5"));
+ }
+
+ EXPECT_EQ(ARES_EBADSTR, ares_set_servers_csv(channel_, "2.3.4.5,1.2.3.4:,3.4.5.6"));
+ EXPECT_EQ(ARES_EBADSTR, ares_set_servers_csv(channel_, "2.3.4.5,1.2.3.4:Z,3.4.5.6"));
+}
+
+TEST_F(DefaultChannelTest, TimeoutValue) {
+ struct timeval tinfo;
+ tinfo.tv_sec = 0;
+ tinfo.tv_usec = 0;
+ struct timeval tmax;
+ tmax.tv_sec = 0;
+ tmax.tv_usec = 10;
+ struct timeval* pt;
+
+ // No timers => get max back.
+ pt = ares_timeout(channel_, &tmax, &tinfo);
+ EXPECT_EQ(&tmax, pt);
+ EXPECT_EQ(0, pt->tv_sec);
+ EXPECT_EQ(10, pt->tv_usec);
+
+ pt = ares_timeout(channel_, nullptr, &tinfo);
+ EXPECT_EQ(nullptr, pt);
+
+ HostResult result;
+ ares_gethostbyname(channel_, "www.google.com.", AF_INET, HostCallback, &result);
+
+ // Now there's a timer running.
+ pt = ares_timeout(channel_, &tmax, &tinfo);
+ EXPECT_EQ(&tmax, pt);
+ EXPECT_EQ(0, pt->tv_sec);
+ EXPECT_EQ(10, pt->tv_usec);
+
+ tmax.tv_sec = 100;
+ pt = ares_timeout(channel_, &tmax, &tinfo);
+ EXPECT_EQ(&tinfo, pt);
+
+ pt = ares_timeout(channel_, nullptr, &tinfo);
+ EXPECT_EQ(&tinfo, pt);
+
+ Process();
+}
+
+TEST_F(LibraryTest, InetNtoP) {
+ struct in_addr addr;
+ addr.s_addr = htonl(0x01020304);
+ char buffer[256];
+ EXPECT_EQ(buffer, ares_inet_ntop(AF_INET, &addr, buffer, sizeof(buffer)));
+ EXPECT_EQ("1.2.3.4", std::string(buffer));
+}
+
+TEST_F(LibraryTest, Mkquery) {
+ byte* p;
+ int len;
+ ares_mkquery("example.com", C_IN, T_A, 0x1234, 0, &p, &len);
+ std::vector<byte> data(p, p + len);
+ ares_free_string(p);
+
+ std::string actual = PacketToString(data);
+ DNSPacket pkt;
+ pkt.set_qid(0x1234).add_question(new DNSQuestion("example.com", T_A));
+ std::string expected = PacketToString(pkt.data());
+ EXPECT_EQ(expected, actual);
+}
+
+TEST_F(LibraryTest, CreateQuery) {
+ byte* p;
+ int len;
+ // This is hard to really test with escaping since DNS names don't allow
+ // bad characters. So we'll escape good characters.
+ EXPECT_EQ(ARES_SUCCESS,
+ ares_create_query("ex\\097m\\ple.com", C_IN, T_A, 0x1234, 0,
+ &p, &len, 0));
+ std::vector<byte> data(p, p + len);
+ ares_free_string(p);
+
+ std::string actual = PacketToString(data);
+ DNSPacket pkt;
+ pkt.set_qid(0x1234).add_question(new DNSQuestion("example.com", T_A));
+ std::string expected = PacketToString(pkt.data());
+ EXPECT_EQ(expected, actual);
+}
+
+TEST_F(LibraryTest, CreateQueryTrailingEscapedDot) {
+ byte* p;
+ int len;
+ EXPECT_EQ(ARES_SUCCESS,
+ ares_create_query("example.com\\.", C_IN, T_A, 0x1234, 0,
+ &p, &len, 0));
+ std::vector<byte> data(p, p + len);
+ ares_free_string(p);
+
+ std::string actual = PacketToString(data);
+ EXPECT_EQ("REQ QRY Q:{'example.com\\.' IN A}", actual);
+}
+
+TEST_F(LibraryTest, CreateQueryNameTooLong) {
+ byte* p;
+ int len;
+ EXPECT_EQ(ARES_EBADNAME,
+ ares_create_query(
+ "a1234567890123456789.b1234567890123456789.c1234567890123456789.d1234567890123456789."
+ "a1234567890123456789.b1234567890123456789.c1234567890123456789.d1234567890123456789."
+ "a1234567890123456789.b1234567890123456789.c1234567890123456789.d1234567890123456789."
+ "x1234567890123456789.y1234567890123456789.",
+ C_IN, T_A, 0x1234, 0, &p, &len, 0));
+}
+
+TEST_F(LibraryTest, CreateQueryFailures) {
+ byte* p;
+ int len;
+ // RC1035 has a 255 byte limit on names.
+ std::string longname;
+ for (int ii = 0; ii < 17; ii++) {
+ longname += "fedcba9876543210";
+ }
+ p = nullptr;
+ EXPECT_EQ(ARES_EBADNAME,
+ ares_create_query(longname.c_str(), C_IN, T_A, 0x1234, 0,
+ &p, &len, 0));
+ if (p) ares_free_string(p);
+
+ SetAllocFail(1);
+
+ p = nullptr;
+ EXPECT_EQ(ARES_ENOMEM,
+ ares_create_query("example.com", C_IN, T_A, 0x1234, 0,
+ &p, &len, 0));
+ if (p) ares_free_string(p);
+
+ // 63-char limit on a single label
+ std::string longlabel = "a.a123456789b123456789c123456789d123456789e123456789f123456789g123456789.org";
+ p = nullptr;
+ EXPECT_EQ(ARES_EBADNAME,
+ ares_create_query(longlabel.c_str(), C_IN, T_A, 0x1234, 0,
+ &p, &len, 0));
+ if (p) ares_free_string(p);
+
+ // Empty non-terminal label
+ p = nullptr;
+ EXPECT_EQ(ARES_EBADNAME,
+ ares_create_query("example..com", C_IN, T_A, 0x1234, 0,
+ &p, &len, 0));
+ if (p) ares_free_string(p);
+}
+
+TEST_F(LibraryTest, CreateQueryOnionDomain) {
+ byte* p;
+ int len;
+ EXPECT_EQ(ARES_ENOTFOUND,
+ ares_create_query("dontleak.onion", C_IN, T_A, 0x1234, 0,
+ &p, &len, 0));
+}
+
+TEST_F(DefaultChannelTest, HostByNameOnionDomain) {
+ HostResult result;
+ ares_gethostbyname(channel_, "dontleak.onion", AF_INET, HostCallback, &result);
+ EXPECT_TRUE(result.done_);
+ EXPECT_EQ(ARES_ENOTFOUND, result.status_);
+}
+
+TEST_F(DefaultChannelTest, HostByNameFileOnionDomain) {
+ struct hostent *h;
+ EXPECT_EQ(ARES_ENOTFOUND,
+ ares_gethostbyname_file(channel_, "dontleak.onion", AF_INET, &h));
+}
+
+TEST_F(DefaultChannelTest, GetAddrinfoOnionDomain) {
+ AddrInfoResult result;
+ struct ares_addrinfo_hints hints = {};
+ hints.ai_family = AF_UNSPEC;
+ ares_getaddrinfo(channel_, "dontleak.onion", NULL, &hints, AddrInfoCallback, &result);
+ EXPECT_TRUE(result.done_);
+ EXPECT_EQ(ARES_ENOTFOUND, result.status_);
+}
+
+// Interesting question: should tacking on a search domain let the query
+// through? It seems safer to reject it because "supersecret.onion.search"
+// still leaks information about the query to malicious resolvers.
+TEST_F(DefaultChannelTest, SearchOnionDomain) {
+ SearchResult result;
+ ares_search(channel_, "dontleak.onion", C_IN, T_A,
+ SearchCallback, &result);
+ EXPECT_TRUE(result.done_);
+ EXPECT_EQ(ARES_ENOTFOUND, result.status_);
+}
+
+TEST_F(DefaultChannelTest, SendFailure) {
+ unsigned char buf[2] = {};
+ SearchResult result;
+ ares_send(channel_, buf, sizeof(buf), SearchCallback, &result);
+ EXPECT_TRUE(result.done_);
+ EXPECT_EQ(ARES_EBADQUERY, result.status_);
+}
+
+static std::string ExpandName(const std::vector<byte>& data, int offset,
+ long *enclen) {
+ char *name = nullptr;
+ int rc = ares_expand_name(data.data() + offset, data.data(), (int)data.size(),
+ &name, enclen);
+ EXPECT_EQ(ARES_SUCCESS, rc);
+ std::string result;
+ if (rc == ARES_SUCCESS) {
+ result = name;
+ } else {
+ result = "<error>";
+ }
+ ares_free_string(name);
+ return result;
+}
+
+TEST_F(LibraryTest, ExpandName) {
+ long enclen;
+ std::vector<byte> data1 = {1, 'a', 2, 'b', 'c', 3, 'd', 'e', 'f', 0};
+ EXPECT_EQ("a.bc.def", ExpandName(data1, 0, &enclen));
+ EXPECT_EQ(data1.size(), (size_t)enclen);
+
+ std::vector<byte> data2 = {0};
+ EXPECT_EQ("", ExpandName(data2, 0, &enclen));
+ EXPECT_EQ(1, enclen);
+
+ // Complete name indirection
+ std::vector<byte> data3 = {0x12, 0x23,
+ 3, 'd', 'e', 'f', 0,
+ 0xC0, 2};
+ EXPECT_EQ("def", ExpandName(data3, 2, &enclen));
+ EXPECT_EQ(5, enclen);
+ EXPECT_EQ("def", ExpandName(data3, 7, &enclen));
+ EXPECT_EQ(2, enclen);
+
+ // One label then indirection
+ std::vector<byte> data4 = {0x12, 0x23,
+ 3, 'd', 'e', 'f', 0,
+ 1, 'a', 0xC0, 2};
+ EXPECT_EQ("def", ExpandName(data4, 2, &enclen));
+ EXPECT_EQ(5, enclen);
+ EXPECT_EQ("a.def", ExpandName(data4, 7, &enclen));
+ EXPECT_EQ(4, enclen);
+
+ // Two labels then indirection
+ std::vector<byte> data5 = {0x12, 0x23,
+ 3, 'd', 'e', 'f', 0,
+ 1, 'a', 1, 'b', 0xC0, 2};
+ EXPECT_EQ("def", ExpandName(data5, 2, &enclen));
+ EXPECT_EQ(5, enclen);
+ EXPECT_EQ("a.b.def", ExpandName(data5, 7, &enclen));
+ EXPECT_EQ(6, enclen);
+
+ // Empty name, indirection to empty name
+ std::vector<byte> data6 = {0x12, 0x23,
+ 0,
+ 0xC0, 2};
+ EXPECT_EQ("", ExpandName(data6, 2, &enclen));
+ EXPECT_EQ(1, enclen);
+ EXPECT_EQ("", ExpandName(data6, 3, &enclen));
+ EXPECT_EQ(2, enclen);
+}
+
+TEST_F(LibraryTest, ExpandNameFailure) {
+ std::vector<byte> data1 = {0x03, 'c', 'o', 'm', 0x00};
+ char *name = nullptr;
+ long enclen;
+ SetAllocFail(1);
+ EXPECT_EQ(ARES_ENOMEM,
+ ares_expand_name(data1.data(), data1.data(), (int)data1.size(),
+ &name, &enclen));
+
+ // Empty packet
+ EXPECT_EQ(ARES_EBADNAME,
+ ares_expand_name(data1.data(), data1.data(), 0, &name, &enclen));
+
+ // Start beyond enclosing data
+ EXPECT_EQ(ARES_EBADNAME,
+ ares_expand_name(data1.data() + data1.size(), data1.data(), (int)data1.size(),
+ &name, &enclen));
+
+ // Length beyond size of enclosing data
+ std::vector<byte> data2a = {0x13, 'c', 'o', 'm', 0x00};
+ EXPECT_EQ(ARES_EBADNAME,
+ ares_expand_name(data2a.data(), data2a.data(), (int)data2a.size(),
+ &name, &enclen));
+ std::vector<byte> data2b = {0x1};
+ EXPECT_EQ(ARES_EBADNAME,
+ ares_expand_name(data2b.data(), data2b.data(), (int)data2b.size(),
+ &name, &enclen));
+ std::vector<byte> data2c = {0xC0};
+ EXPECT_EQ(ARES_EBADNAME,
+ ares_expand_name(data2c.data(), data2c.data(), (int)data2c.size(),
+ &name, &enclen));
+
+ // Indirection beyond enclosing data
+ std::vector<byte> data3a = {0xC0, 0x02};
+ EXPECT_EQ(ARES_EBADNAME,
+ ares_expand_name(data3a.data(), data3a.data(), (int)data3a.size(),
+ &name, &enclen));
+ std::vector<byte> data3b = {0xC0, 0x0A, 'c', 'o', 'm', 0x00};
+ EXPECT_EQ(ARES_EBADNAME,
+ ares_expand_name(data3b.data(), data3b.data(), (int)data3b.size(),
+ &name, &enclen));
+
+ // Invalid top bits in label length
+ std::vector<byte> data4 = {0x03, 'c', 'o', 'm', 0x00, 0x80, 0x00};
+ EXPECT_EQ(ARES_EBADNAME,
+ ares_expand_name(data4.data() + 5, data4.data(), (int)data4.size(),
+ &name, &enclen));
+
+ // Label too long: 64-byte label, with invalid top 2 bits of length (01).
+ std::vector<byte> data5 = {0x40,
+ '0', '1', '2', '3', '4', '5', '6', '7', '8', '9', 'a', 'b', 'c', 'd', 'e', 'f',
+ '0', '1', '2', '3', '4', '5', '6', '7', '8', '9', 'a', 'b', 'c', 'd', 'e', 'f',
+ '0', '1', '2', '3', '4', '5', '6', '7', '8', '9', 'a', 'b', 'c', 'd', 'e', 'f',
+ '0', '1', '2', '3', '4', '5', '6', '7', '8', '9', 'a', 'b', 'c', 'd', 'e', 'f',
+ 0x00};
+ EXPECT_EQ(ARES_EBADNAME,
+ ares_expand_name(data5.data(), data5.data(), (int)data5.size(),
+ &name, &enclen)) << name;
+
+ // Incomplete indirect length
+ std::vector<byte> data6 = {0x03, 'c', 'o', 'm', 0x00, 0xC0};
+ EXPECT_EQ(ARES_EBADNAME,
+ ares_expand_name(data6.data() + 5, data6.data(), (int)data6.size(),
+ &name, &enclen));
+
+ // Indirection loops
+ std::vector<byte> data7 = {0xC0, 0x02, 0xC0, 0x00};
+ EXPECT_EQ(ARES_EBADNAME,
+ ares_expand_name(data7.data(), data7.data(), (int)data7.size(),
+ &name, &enclen));
+ std::vector<byte> data8 = {3, 'd', 'e', 'f', 0xC0, 0x08, 0x00, 0x00,
+ 3, 'a', 'b', 'c', 0xC0, 0x00};
+ EXPECT_EQ(ARES_EBADNAME,
+ ares_expand_name(data8.data(), data8.data(), (int)data8.size(),
+ &name, &enclen));
+ std::vector<byte> data9 = {0x12, 0x23, // start 2 bytes in
+ 3, 'd', 'e', 'f', 0xC0, 0x02};
+ EXPECT_EQ(ARES_EBADNAME,
+ ares_expand_name(data9.data() + 2, data9.data(), (int)data9.size(),
+ &name, &enclen));
+}
+
+TEST_F(LibraryTest, CreateEDNSQuery) {
+ byte* p;
+ int len;
+ EXPECT_EQ(ARES_SUCCESS,
+ ares_create_query("example.com", C_IN, T_A, 0x1234, 0,
+ &p, &len, 1280));
+ std::vector<byte> data(p, p + len);
+ ares_free_string(p);
+
+ std::string actual = PacketToString(data);
+ DNSPacket pkt;
+ pkt.set_qid(0x1234).add_question(new DNSQuestion("example.com", T_A))
+ .add_additional(new DNSOptRR(0, 1280));
+ std::string expected = PacketToString(pkt.data());
+ EXPECT_EQ(expected, actual);
+}
+
+TEST_F(LibraryTest, CreateRootQuery) {
+ byte* p;
+ int len;
+ ares_create_query(".", C_IN, T_A, 0x1234, 0, &p, &len, 0);
+ std::vector<byte> data(p, p + len);
+ ares_free_string(p);
+
+ std::string actual = PacketToString(data);
+ DNSPacket pkt;
+ pkt.set_qid(0x1234).add_question(new DNSQuestion("", T_A));
+ std::string expected = PacketToString(pkt.data());
+ EXPECT_EQ(expected, actual);
+}
+
+TEST_F(LibraryTest, Version) {
+ // Assume linked to same version
+ EXPECT_EQ(std::string(ARES_VERSION_STR),
+ std::string(ares_version(nullptr)));
+ int version;
+ ares_version(&version);
+ EXPECT_EQ(ARES_VERSION, version);
+}
+
+TEST_F(LibraryTest, Strerror) {
+ EXPECT_EQ("Successful completion",
+ std::string(ares_strerror(ARES_SUCCESS)));
+ EXPECT_EQ("DNS query cancelled",
+ std::string(ares_strerror(ARES_ECANCELLED)));
+ EXPECT_EQ("unknown",
+ std::string(ares_strerror(99)));
+}
+
+TEST_F(LibraryTest, ExpandString) {
+ std::vector<byte> s1 = { 3, 'a', 'b', 'c'};
+ char* result = nullptr;
+ long len;
+ EXPECT_EQ(ARES_SUCCESS,
+ ares_expand_string(s1.data(), s1.data(), (int)s1.size(),
+ (unsigned char**)&result, &len));
+ EXPECT_EQ("abc", std::string(result));
+ EXPECT_EQ(1 + 3, len); // amount of data consumed includes 1 byte len
+ ares_free_string(result);
+ result = nullptr;
+ EXPECT_EQ(ARES_EBADSTR,
+ ares_expand_string(s1.data() + 1, s1.data(), (int)s1.size(),
+ (unsigned char**)&result, &len));
+ EXPECT_EQ(ARES_EBADSTR,
+ ares_expand_string(s1.data() + 4, s1.data(), (int)s1.size(),
+ (unsigned char**)&result, &len));
+ SetAllocFail(1);
+ EXPECT_EQ(ARES_ENOMEM,
+ ares_expand_string(s1.data(), s1.data(), (int)s1.size(),
+ (unsigned char**)&result, &len));
+}
+
+} // namespace test
+} // namespace ares
diff --git a/subprojects/c-ares/test/ares-test-mock-ai.cc b/subprojects/c-ares/test/ares-test-mock-ai.cc
@@ -0,0 +1,768 @@
+/*
+ * Copyright (C) The c-ares project
+ *
+ * Permission to use, copy, modify, and distribute this
+ * software and its documentation for any purpose and without
+ * fee is hereby granted, provided that the above copyright
+ * notice appear in all copies and that both that copyright
+ * notice and this permission notice appear in supporting
+ * documentation, and that the name of M.I.T. not be used in
+ * advertising or publicity pertaining to distribution of the
+ * software without specific, written prior permission.
+ * M.I.T. makes no representations about the suitability of
+ * this software for any purpose. It is provided "as is"
+ * without express or implied warranty.
+ *
+ * SPDX-License-Identifier: MIT
+ */
+#include "ares-test-ai.h"
+#include "dns-proto.h"
+
+#ifdef HAVE_NETINET_IN_H
+#include <netinet/in.h>
+#endif
+
+#include <sstream>
+#include <vector>
+
+using testing::InvokeWithoutArgs;
+using testing::DoAll;
+
+namespace ares {
+namespace test {
+
+MATCHER_P(IncludesNumAddresses, n, "") {
+ if(!arg)
+ return false;
+ int cnt = 0;
+ for (const ares_addrinfo_node* ai = arg->nodes; ai != NULL; ai = ai->ai_next)
+ cnt++;
+ return n == cnt;
+}
+
+MATCHER_P(IncludesV4Address, address, "") {
+ if(!arg)
+ return false;
+ in_addr addressnum = {};
+ if (!ares_inet_pton(AF_INET, address, &addressnum))
+ return false; // wrong number format?
+ for (const ares_addrinfo_node* ai = arg->nodes; ai != NULL; ai = ai->ai_next) {
+ if (ai->ai_family != AF_INET)
+ continue;
+ if (ai->ai_addrlen != sizeof(struct sockaddr_in))
+ continue;
+ if (reinterpret_cast<sockaddr_in*>(ai->ai_addr)->sin_addr.s_addr ==
+ addressnum.s_addr)
+ return true; // found
+ }
+ return false;
+}
+
+MATCHER_P(IncludesV6Address, address, "") {
+ if(!arg)
+ return false;
+ in6_addr addressnum = {};
+ if (!ares_inet_pton(AF_INET6, address, &addressnum)) {
+ return false; // wrong number format?
+ }
+ for (const ares_addrinfo_node* ai = arg->nodes; ai != NULL; ai = ai->ai_next) {
+ if (ai->ai_family != AF_INET6)
+ continue;
+ if (ai->ai_addrlen != sizeof(struct sockaddr_in6))
+ continue;
+ if (!memcmp(
+ reinterpret_cast<sockaddr_in6*>(ai->ai_addr)->sin6_addr.s6_addr,
+ addressnum.s6_addr, sizeof(addressnum.s6_addr)))
+ return true; // found
+ }
+ return false;
+}
+
+// UDP only so mock server doesn't get confused by concatenated requests
+TEST_P(MockUDPChannelTestAI, GetAddrInfoParallelLookups) {
+ DNSPacket rsp1;
+ rsp1.set_response().set_aa()
+ .add_question(new DNSQuestion("www.google.com", T_A))
+ .add_answer(new DNSARR("www.google.com", 100, {2, 3, 4, 5}));
+ ON_CALL(server_, OnRequest("www.google.com", T_A))
+ .WillByDefault(SetReply(&server_, &rsp1));
+ DNSPacket rsp2;
+ rsp2.set_response().set_aa()
+ .add_question(new DNSQuestion("www.example.com", T_A))
+ .add_answer(new DNSARR("www.example.com", 100, {1, 2, 3, 4}));
+ ON_CALL(server_, OnRequest("www.example.com", T_A))
+ .WillByDefault(SetReply(&server_, &rsp2));
+
+ struct ares_addrinfo_hints hints = {};
+ hints.ai_family = AF_INET;
+ hints.ai_flags = ARES_AI_NOSORT;
+ AddrInfoResult result1;
+ ares_getaddrinfo(channel_, "www.google.com.", NULL, &hints, AddrInfoCallback, &result1);
+ AddrInfoResult result2;
+ ares_getaddrinfo(channel_, "www.example.com.", NULL, &hints, AddrInfoCallback, &result2);
+ AddrInfoResult result3;
+ ares_getaddrinfo(channel_, "www.google.com.", NULL, &hints, AddrInfoCallback, &result3);
+ Process();
+
+ EXPECT_TRUE(result1.done_);
+ EXPECT_EQ(result1.status_, ARES_SUCCESS);
+ EXPECT_THAT(result1.ai_, IncludesNumAddresses(1));
+ EXPECT_THAT(result1.ai_, IncludesV4Address("2.3.4.5"));
+
+ EXPECT_TRUE(result2.done_);
+ EXPECT_EQ(result2.status_, ARES_SUCCESS);
+ EXPECT_THAT(result2.ai_, IncludesNumAddresses(1));
+ EXPECT_THAT(result2.ai_, IncludesV4Address("1.2.3.4"));
+
+ EXPECT_TRUE(result3.done_);
+ EXPECT_EQ(result3.status_, ARES_SUCCESS);
+ EXPECT_THAT(result3.ai_, IncludesNumAddresses(1));
+ EXPECT_THAT(result3.ai_, IncludesV4Address("2.3.4.5"));
+}
+
+// UDP to TCP specific test
+TEST_P(MockUDPChannelTestAI, TruncationRetry) {
+ DNSPacket rsptruncated;
+ rsptruncated.set_response().set_aa().set_tc()
+ .add_question(new DNSQuestion("www.google.com", T_A));
+ DNSPacket rspok;
+ rspok.set_response()
+ .add_question(new DNSQuestion("www.google.com", T_A))
+ .add_answer(new DNSARR("www.google.com", 100, {1, 2, 3, 4}));
+ EXPECT_CALL(server_, OnRequest("www.google.com", T_A))
+ .WillOnce(SetReply(&server_, &rsptruncated))
+ .WillOnce(SetReply(&server_, &rspok));
+
+ AddrInfoResult result;
+ struct ares_addrinfo_hints hints = {};
+ hints.ai_family = AF_INET;
+ hints.ai_flags = ARES_AI_NOSORT;
+ ares_getaddrinfo(channel_, "www.google.com.", NULL, &hints, AddrInfoCallback, &result);
+ Process();
+ EXPECT_TRUE(result.done_);
+ EXPECT_EQ(result.status_, ARES_SUCCESS);
+ EXPECT_THAT(result.ai_, IncludesNumAddresses(1));
+ EXPECT_THAT(result.ai_, IncludesV4Address("1.2.3.4"));
+}
+
+TEST_P(MockTCPChannelTestAI, MalformedResponse) {
+ std::vector<byte> one = {0x01};
+ ON_CALL(server_, OnRequest("www.google.com", T_A))
+ .WillByDefault(SetReplyData(&server_, one));
+
+ AddrInfoResult result;
+ struct ares_addrinfo_hints hints = {};
+ hints.ai_family = AF_INET;
+ hints.ai_flags = ARES_AI_NOSORT;
+ ares_getaddrinfo(channel_, "www.google.com.", NULL, &hints, AddrInfoCallback, &result);
+ Process();
+ EXPECT_TRUE(result.done_);
+ EXPECT_EQ(ARES_ETIMEOUT, result.status_);
+}
+
+TEST_P(MockTCPChannelTestAI, FormErrResponse) {
+ DNSPacket rsp;
+ rsp.set_response().set_aa()
+ .add_question(new DNSQuestion("www.google.com", T_A));
+ rsp.set_rcode(FORMERR);
+ EXPECT_CALL(server_, OnRequest("www.google.com", T_A))
+ .WillOnce(SetReply(&server_, &rsp));
+
+ AddrInfoResult result;
+ struct ares_addrinfo_hints hints = {};
+ hints.ai_family = AF_INET;
+ hints.ai_flags = ARES_AI_NOSORT;
+ ares_getaddrinfo(channel_, "www.google.com.", NULL, &hints, AddrInfoCallback, &result);
+ Process();
+ EXPECT_TRUE(result.done_);
+ EXPECT_EQ(ARES_EFORMERR, result.status_);
+}
+
+TEST_P(MockTCPChannelTestAI, ServFailResponse) {
+ DNSPacket rsp;
+ rsp.set_response().set_aa()
+ .add_question(new DNSQuestion("www.google.com", T_A));
+ rsp.set_rcode(SERVFAIL);
+ ON_CALL(server_, OnRequest("www.google.com", T_A))
+ .WillByDefault(SetReply(&server_, &rsp));
+
+ AddrInfoResult result;
+ struct ares_addrinfo_hints hints = {};
+ hints.ai_family = AF_INET;
+ hints.ai_flags = ARES_AI_NOSORT;
+ ares_getaddrinfo(channel_, "www.google.com.", NULL, &hints, AddrInfoCallback, &result);
+ Process();
+ EXPECT_TRUE(result.done_);
+ EXPECT_EQ(ARES_ESERVFAIL, result.status_);
+}
+
+TEST_P(MockTCPChannelTestAI, NotImplResponse) {
+ DNSPacket rsp;
+ rsp.set_response().set_aa()
+ .add_question(new DNSQuestion("www.google.com", T_A));
+ rsp.set_rcode(NOTIMP);
+ ON_CALL(server_, OnRequest("www.google.com", T_A))
+ .WillByDefault(SetReply(&server_, &rsp));
+
+ AddrInfoResult result;
+ struct ares_addrinfo_hints hints = {};
+ hints.ai_family = AF_INET;
+ hints.ai_flags = ARES_AI_NOSORT;
+ ares_getaddrinfo(channel_, "www.google.com.", NULL, &hints, AddrInfoCallback, &result);
+ Process();
+ EXPECT_TRUE(result.done_);
+ EXPECT_EQ(ARES_ENOTIMP, result.status_);
+}
+
+TEST_P(MockTCPChannelTestAI, RefusedResponse) {
+ DNSPacket rsp;
+ rsp.set_response().set_aa()
+ .add_question(new DNSQuestion("www.google.com", T_A));
+ rsp.set_rcode(REFUSED);
+ ON_CALL(server_, OnRequest("www.google.com", T_A))
+ .WillByDefault(SetReply(&server_, &rsp));
+
+ AddrInfoResult result;
+ struct ares_addrinfo_hints hints = {};
+ hints.ai_family = AF_INET;
+ hints.ai_flags = ARES_AI_NOSORT;
+ ares_getaddrinfo(channel_, "www.google.com.", NULL, &hints, AddrInfoCallback, &result);
+ Process();
+ EXPECT_TRUE(result.done_);
+ EXPECT_EQ(ARES_EREFUSED, result.status_);
+}
+
+TEST_P(MockTCPChannelTestAI, YXDomainResponse) {
+ DNSPacket rsp;
+ rsp.set_response().set_aa()
+ .add_question(new DNSQuestion("www.google.com", T_A));
+ rsp.set_rcode(YXDOMAIN);
+ EXPECT_CALL(server_, OnRequest("www.google.com", T_A))
+ .WillOnce(SetReply(&server_, &rsp));
+
+ AddrInfoResult result;
+ struct ares_addrinfo_hints hints = {};
+ hints.ai_family = AF_INET;
+ hints.ai_flags = ARES_AI_NOSORT;
+ ares_getaddrinfo(channel_, "www.google.com.", NULL, &hints, AddrInfoCallback, &result);
+ Process();
+ EXPECT_TRUE(result.done_);
+ EXPECT_EQ(ARES_ENODATA, result.status_);
+}
+
+class MockExtraOptsTestAI
+ : public MockChannelOptsTest,
+ public ::testing::WithParamInterface< std::pair<int, bool> > {
+ public:
+ MockExtraOptsTestAI()
+ : MockChannelOptsTest(1, GetParam().first, GetParam().second,
+ FillOptions(&opts_),
+ ARES_OPT_SOCK_SNDBUF|ARES_OPT_SOCK_RCVBUF) {}
+ static struct ares_options* FillOptions(struct ares_options * opts) {
+ memset(opts, 0, sizeof(struct ares_options));
+ // Set a few options that affect socket communications
+ opts->socket_send_buffer_size = 514;
+ opts->socket_receive_buffer_size = 514;
+ return opts;
+ }
+ private:
+ struct ares_options opts_;
+};
+
+TEST_P(MockExtraOptsTestAI, SimpleQuery) {
+ ares_set_local_ip4(channel_, 0x7F000001);
+ byte addr6[16] = {0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00,
+ 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x01};
+ ares_set_local_ip6(channel_, addr6);
+ ares_set_local_dev(channel_, "dummy");
+
+ DNSPacket rsp;
+ rsp.set_response().set_aa()
+ .add_question(new DNSQuestion("www.google.com", T_A))
+ .add_answer(new DNSARR("www.google.com", 100, {2, 3, 4, 5}));
+ ON_CALL(server_, OnRequest("www.google.com", T_A))
+ .WillByDefault(SetReply(&server_, &rsp));
+
+ AddrInfoResult result;
+ struct ares_addrinfo_hints hints = {};
+ hints.ai_family = AF_INET;
+ hints.ai_flags = ARES_AI_NOSORT;
+ ares_getaddrinfo(channel_, "www.google.com.", NULL, &hints, AddrInfoCallback, &result);
+ Process();
+ EXPECT_TRUE(result.done_);
+ EXPECT_EQ(ARES_SUCCESS, result.status_);
+ EXPECT_THAT(result.ai_, IncludesNumAddresses(1));
+ EXPECT_THAT(result.ai_, IncludesV4Address("2.3.4.5"));
+}
+
+class MockExtraOptsNDotsTestAI
+ : public MockChannelOptsTest,
+ public ::testing::WithParamInterface< std::pair<int, bool> > {
+ public:
+ MockExtraOptsNDotsTestAI(int ndots)
+ : MockChannelOptsTest(1, GetParam().first, GetParam().second,
+ FillOptions(&opts_, ndots),
+ ARES_OPT_SOCK_SNDBUF|ARES_OPT_SOCK_RCVBUF|ARES_OPT_NDOTS) {}
+ static struct ares_options* FillOptions(struct ares_options * opts, int ndots) {
+ memset(opts, 0, sizeof(struct ares_options));
+ // Set a few options that affect socket communications
+ opts->socket_send_buffer_size = 514;
+ opts->socket_receive_buffer_size = 514;
+ opts->ndots = ndots;
+ return opts;
+ }
+ private:
+ struct ares_options opts_;
+};
+
+class MockExtraOptsNDots5TestAI : public MockExtraOptsNDotsTestAI {
+ public:
+ MockExtraOptsNDots5TestAI() : MockExtraOptsNDotsTestAI(5) {}
+};
+
+TEST_P(MockExtraOptsNDots5TestAI, SimpleQuery) {
+ ares_set_local_ip4(channel_, 0x7F000001);
+ byte addr6[16] = {0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00,
+ 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x01};
+ ares_set_local_ip6(channel_, addr6);
+ ares_set_local_dev(channel_, "dummy");
+
+ DNSPacket rsp;
+ rsp.set_response().set_aa()
+ .add_question(new DNSQuestion("dynamodb.us-east-1.amazonaws.com", T_A))
+ .add_answer(new DNSARR("dynamodb.us-east-1.amazonaws.com", 100, {123, 45, 67, 8}));
+ ON_CALL(server_, OnRequest("dynamodb.us-east-1.amazonaws.com", T_A))
+ .WillByDefault(SetReply(&server_, &rsp));
+
+ AddrInfoResult result;
+ struct ares_addrinfo_hints hints = {};
+ hints.ai_family = AF_INET;
+ hints.ai_flags = ARES_AI_NOSORT;
+ ares_getaddrinfo(channel_, "dynamodb.us-east-1.amazonaws.com.", NULL, &hints, AddrInfoCallback, &result);
+ Process();
+ EXPECT_TRUE(result.done_);
+ EXPECT_EQ(ARES_SUCCESS, result.status_);
+ EXPECT_THAT(result.ai_, IncludesNumAddresses(1));
+ EXPECT_THAT(result.ai_, IncludesV4Address("123.45.67.8"));
+}
+
+class MockFlagsChannelOptsTestAI
+ : public MockChannelOptsTest,
+ public ::testing::WithParamInterface< std::pair<int, bool> > {
+ public:
+ MockFlagsChannelOptsTestAI(int flags)
+ : MockChannelOptsTest(1, GetParam().first, GetParam().second,
+ FillOptions(&opts_, flags), ARES_OPT_FLAGS) {}
+ static struct ares_options* FillOptions(struct ares_options * opts, int flags) {
+ memset(opts, 0, sizeof(struct ares_options));
+ opts->flags = flags;
+ return opts;
+ }
+ private:
+ struct ares_options opts_;
+};
+
+class MockNoCheckRespChannelTestAI : public MockFlagsChannelOptsTestAI {
+ public:
+ MockNoCheckRespChannelTestAI() : MockFlagsChannelOptsTestAI(ARES_FLAG_NOCHECKRESP) {}
+};
+
+TEST_P(MockNoCheckRespChannelTestAI, ServFailResponse) {
+ DNSPacket rsp;
+ rsp.set_response().set_aa()
+ .add_question(new DNSQuestion("www.google.com", T_A));
+ rsp.set_rcode(SERVFAIL);
+ ON_CALL(server_, OnRequest("www.google.com", T_A))
+ .WillByDefault(SetReply(&server_, &rsp));
+
+ AddrInfoResult result;
+ struct ares_addrinfo_hints hints = {};
+ hints.ai_family = AF_INET;
+ hints.ai_flags = ARES_AI_NOSORT;
+ ares_getaddrinfo(channel_, "www.google.com.", NULL, &hints, AddrInfoCallback, &result);
+ Process();
+ EXPECT_TRUE(result.done_);
+ EXPECT_EQ(ARES_ESERVFAIL, result.status_);
+}
+
+TEST_P(MockNoCheckRespChannelTestAI, NotImplResponse) {
+ DNSPacket rsp;
+ rsp.set_response().set_aa()
+ .add_question(new DNSQuestion("www.google.com", T_A));
+ rsp.set_rcode(NOTIMP);
+ ON_CALL(server_, OnRequest("www.google.com", T_A))
+ .WillByDefault(SetReply(&server_, &rsp));
+
+ AddrInfoResult result;
+ struct ares_addrinfo_hints hints = {};
+ hints.ai_family = AF_INET;
+ hints.ai_flags = ARES_AI_NOSORT;
+ ares_getaddrinfo(channel_, "www.google.com.", NULL, &hints, AddrInfoCallback, &result);
+ Process();
+ EXPECT_TRUE(result.done_);
+ EXPECT_EQ(ARES_ENOTIMP, result.status_);
+}
+
+TEST_P(MockNoCheckRespChannelTestAI, RefusedResponse) {
+ DNSPacket rsp;
+ rsp.set_response().set_aa()
+ .add_question(new DNSQuestion("www.google.com", T_A));
+ rsp.set_rcode(REFUSED);
+ ON_CALL(server_, OnRequest("www.google.com", T_A))
+ .WillByDefault(SetReply(&server_, &rsp));
+
+ AddrInfoResult result;
+ struct ares_addrinfo_hints hints = {};
+ hints.ai_family = AF_INET;
+ hints.ai_flags = ARES_AI_NOSORT;
+ ares_getaddrinfo(channel_, "www.google.com.", NULL, &hints, AddrInfoCallback, &result);
+ Process();
+ EXPECT_TRUE(result.done_);
+ EXPECT_EQ(ARES_EREFUSED, result.status_);
+}
+
+TEST_P(MockChannelTestAI, FamilyV6) {
+ DNSPacket rsp6;
+ rsp6.set_response().set_aa()
+ .add_question(new DNSQuestion("example.com", T_AAAA))
+ .add_answer(new DNSAaaaRR("example.com", 100,
+ {0x21, 0x21, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00,
+ 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x03, 0x03}));
+ ON_CALL(server_, OnRequest("example.com", T_AAAA))
+ .WillByDefault(SetReply(&server_, &rsp6));
+ AddrInfoResult result;
+ struct ares_addrinfo_hints hints = {};
+ hints.ai_family = AF_INET6;
+ hints.ai_flags = ARES_AI_NOSORT;
+ ares_getaddrinfo(channel_, "example.com.", NULL, &hints,
+ AddrInfoCallback, &result);
+ Process();
+ EXPECT_TRUE(result.done_);
+ EXPECT_THAT(result.ai_, IncludesNumAddresses(1));
+ EXPECT_THAT(result.ai_, IncludesV6Address("2121:0000:0000:0000:0000:0000:0000:0303"));
+}
+
+#ifndef CARES_SYMBOL_HIDING
+// Test case for Issue #662
+TEST_P(MockChannelTestAI, PartialQueryCancel) {
+ std::vector<byte> nothing;
+ DNSPacket reply;
+ reply.set_response().set_aa()
+ .add_question(new DNSQuestion("example.com", T_A))
+ .add_answer(new DNSARR("example.com", 0x0100, {0x01, 0x02, 0x03, 0x04}));
+
+ ON_CALL(server_, OnRequest("example.com", T_A))
+ .WillByDefault(SetReply(&server_, &reply));
+
+ ON_CALL(server_, OnRequest("example.com", T_AAAA))
+ .WillByDefault(SetReplyData(&server_, nothing));
+
+
+ AddrInfoResult result;
+ struct ares_addrinfo_hints hints = {};
+ hints.ai_family = AF_UNSPEC;
+ ares_getaddrinfo(channel_, "example.com.", NULL, &hints,
+ AddrInfoCallback, &result);
+
+ // After 100ms, issues ares_cancel(), this should be enough time for the A
+ // record reply, but before the timeout on the AAAA record.
+ Process(100);
+ EXPECT_TRUE(result.done_);
+ EXPECT_EQ(ARES_ECANCELLED, result.status_);
+}
+#endif
+
+TEST_P(MockChannelTestAI, FamilyV4) {
+ DNSPacket rsp4;
+ rsp4.set_response().set_aa()
+ .add_question(new DNSQuestion("example.com", T_A))
+ .add_answer(new DNSARR("example.com", 100, {2, 3, 4, 5}));
+ ON_CALL(server_, OnRequest("example.com", T_A))
+ .WillByDefault(SetReply(&server_, &rsp4));
+ AddrInfoResult result = {};
+ struct ares_addrinfo_hints hints = {};
+ hints.ai_family = AF_INET;
+ hints.ai_flags = ARES_AI_NOSORT;
+ ares_getaddrinfo(channel_, "example.com.", NULL, &hints,
+ AddrInfoCallback, &result);
+ Process();
+ EXPECT_TRUE(result.done_);
+ EXPECT_THAT(result.ai_, IncludesNumAddresses(1));
+ EXPECT_THAT(result.ai_, IncludesV4Address("2.3.4.5"));
+}
+
+TEST_P(MockChannelTestAI, FamilyV4_MultipleAddresses) {
+ DNSPacket rsp4;
+ rsp4.set_response().set_aa()
+ .add_question(new DNSQuestion("example.com", T_A))
+ .add_answer(new DNSARR("example.com", 100, {2, 3, 4, 5}))
+ .add_answer(new DNSARR("example.com", 100, {7, 8, 9, 0}));
+ ON_CALL(server_, OnRequest("example.com", T_A))
+ .WillByDefault(SetReply(&server_, &rsp4));
+ AddrInfoResult result = {};
+ struct ares_addrinfo_hints hints = {};
+ hints.ai_family = AF_INET;
+ hints.ai_flags = ARES_AI_NOSORT;
+ ares_getaddrinfo(channel_, "example.com.", NULL, &hints,
+ AddrInfoCallback, &result);
+ Process();
+ EXPECT_TRUE(result.done_);
+ std::stringstream ss;
+ ss << result.ai_;
+ EXPECT_EQ("{addr=[2.3.4.5], addr=[7.8.9.0]}", ss.str());
+}
+
+TEST_P(MockChannelTestAI, FamilyUnspecified) {
+ DNSPacket rsp6;
+ rsp6.set_response().set_aa()
+ .add_question(new DNSQuestion("example.com", T_AAAA))
+ .add_answer(new DNSAaaaRR("example.com", 100,
+ {0x21, 0x21, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00,
+ 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x03, 0x03}));
+ ON_CALL(server_, OnRequest("example.com", T_AAAA))
+ .WillByDefault(SetReply(&server_, &rsp6));
+ DNSPacket rsp4;
+ rsp4.set_response().set_aa()
+ .add_question(new DNSQuestion("example.com", T_A))
+ .add_answer(new DNSARR("example.com", 100, {2, 3, 4, 5}));
+ ON_CALL(server_, OnRequest("example.com", T_A))
+ .WillByDefault(SetReply(&server_, &rsp4));
+ AddrInfoResult result;
+ struct ares_addrinfo_hints hints = {};
+ hints.ai_family = AF_UNSPEC;
+ hints.ai_flags = ARES_AI_NOSORT;
+ ares_getaddrinfo(channel_, "example.com.", NULL, &hints,
+ AddrInfoCallback, &result);
+ Process();
+ EXPECT_TRUE(result.done_);
+ EXPECT_THAT(result.ai_, IncludesNumAddresses(2));
+ EXPECT_THAT(result.ai_, IncludesV4Address("2.3.4.5"));
+ EXPECT_THAT(result.ai_, IncludesV6Address("2121:0000:0000:0000:0000:0000:0000:0303"));
+}
+
+class MockEDNSChannelTestAI : public MockFlagsChannelOptsTestAI {
+ public:
+ MockEDNSChannelTestAI() : MockFlagsChannelOptsTestAI(ARES_FLAG_EDNS) {}
+};
+
+TEST_P(MockEDNSChannelTestAI, RetryWithoutEDNS) {
+ DNSPacket rspfail;
+ rspfail.set_response().set_aa().set_rcode(FORMERR)
+ .add_question(new DNSQuestion("www.google.com", T_A));
+ DNSPacket rspok;
+ rspok.set_response()
+ .add_question(new DNSQuestion("www.google.com", T_A))
+ .add_answer(new DNSARR("www.google.com", 100, {1, 2, 3, 4}));
+ EXPECT_CALL(server_, OnRequest("www.google.com", T_A))
+ .WillOnce(SetReply(&server_, &rspfail))
+ .WillOnce(SetReply(&server_, &rspok));
+
+ AddrInfoResult result;
+ struct ares_addrinfo_hints hints = {};
+ hints.ai_family = AF_INET;
+ hints.ai_flags = ARES_AI_NOSORT;
+ ares_getaddrinfo(channel_, "www.google.com.", NULL, &hints, AddrInfoCallback, &result);
+ Process();
+ EXPECT_TRUE(result.done_);
+ EXPECT_THAT(result.ai_, IncludesNumAddresses(1));
+ EXPECT_THAT(result.ai_, IncludesV4Address("1.2.3.4"));
+}
+
+TEST_P(MockChannelTestAI, SearchDomains) {
+ DNSPacket nofirst;
+ nofirst.set_response().set_aa().set_rcode(NXDOMAIN)
+ .add_question(new DNSQuestion("www.first.com", T_A));
+ ON_CALL(server_, OnRequest("www.first.com", T_A))
+ .WillByDefault(SetReply(&server_, &nofirst));
+ DNSPacket nosecond;
+ nosecond.set_response().set_aa().set_rcode(NXDOMAIN)
+ .add_question(new DNSQuestion("www.second.org", T_A));
+ ON_CALL(server_, OnRequest("www.second.org", T_A))
+ .WillByDefault(SetReply(&server_, &nosecond));
+ DNSPacket yesthird;
+ yesthird.set_response().set_aa()
+ .add_question(new DNSQuestion("www.third.gov", T_A))
+ .add_answer(new DNSARR("www.third.gov", 0x0200, {2, 3, 4, 5}));
+ ON_CALL(server_, OnRequest("www.third.gov", T_A))
+ .WillByDefault(SetReply(&server_, &yesthird));
+
+ AddrInfoResult result;
+ struct ares_addrinfo_hints hints = {};
+ hints.ai_family = AF_INET;
+ hints.ai_flags = ARES_AI_NOSORT;
+ ares_getaddrinfo(channel_, "www", NULL, &hints, AddrInfoCallback, &result);
+ Process();
+ EXPECT_TRUE(result.done_);
+ EXPECT_THAT(result.ai_, IncludesNumAddresses(1));
+ EXPECT_THAT(result.ai_, IncludesV4Address("2.3.4.5"));
+}
+
+TEST_P(MockChannelTestAI, SearchDomainsServFailOnAAAA) {
+ DNSPacket nofirst;
+ nofirst.set_response().set_aa().set_rcode(NXDOMAIN)
+ .add_question(new DNSQuestion("www.first.com", T_AAAA));
+ ON_CALL(server_, OnRequest("www.first.com", T_AAAA))
+ .WillByDefault(SetReply(&server_, &nofirst));
+ DNSPacket nofirst4;
+ nofirst4.set_response().set_aa().set_rcode(NXDOMAIN)
+ .add_question(new DNSQuestion("www.first.com", T_A));
+ ON_CALL(server_, OnRequest("www.first.com", T_A))
+ .WillByDefault(SetReply(&server_, &nofirst4));
+
+ DNSPacket nosecond;
+ nosecond.set_response().set_aa().set_rcode(NXDOMAIN)
+ .add_question(new DNSQuestion("www.second.org", T_AAAA));
+ ON_CALL(server_, OnRequest("www.second.org", T_AAAA))
+ .WillByDefault(SetReply(&server_, &nosecond));
+ DNSPacket yessecond4;
+ yessecond4.set_response().set_aa()
+ .add_question(new DNSQuestion("www.second.org", T_A))
+ .add_answer(new DNSARR("www.second.org", 0x0200, {2, 3, 4, 5}));
+ ON_CALL(server_, OnRequest("www.second.org", T_A))
+ .WillByDefault(SetReply(&server_, &yessecond4));
+
+ DNSPacket failthird;
+ failthird.set_response().set_aa().set_rcode(SERVFAIL)
+ .add_question(new DNSQuestion("www.third.gov", T_AAAA));
+ ON_CALL(server_, OnRequest("www.third.gov", T_AAAA))
+ .WillByDefault(SetReply(&server_, &failthird));
+ DNSPacket failthird4;
+ failthird4.set_response().set_aa().set_rcode(SERVFAIL)
+ .add_question(new DNSQuestion("www.third.gov", T_A));
+ ON_CALL(server_, OnRequest("www.third.gov", T_A))
+ .WillByDefault(SetReply(&server_, &failthird4));
+
+ AddrInfoResult result;
+ struct ares_addrinfo_hints hints = {};
+ hints.ai_family = AF_UNSPEC;
+ hints.ai_flags = ARES_AI_NOSORT;
+ ares_getaddrinfo(channel_, "www", NULL, &hints, AddrInfoCallback, &result);
+ Process();
+ EXPECT_TRUE(result.done_);
+ EXPECT_THAT(result.ai_, IncludesNumAddresses(1));
+ EXPECT_THAT(result.ai_, IncludesV4Address("2.3.4.5"));
+}
+
+class MockMultiServerChannelTestAI
+ : public MockChannelOptsTest,
+ public ::testing::WithParamInterface< std::pair<int, bool> > {
+ public:
+ MockMultiServerChannelTestAI(bool rotate)
+ : MockChannelOptsTest(3, GetParam().first, GetParam().second, nullptr, rotate ? ARES_OPT_ROTATE : ARES_OPT_NOROTATE) {}
+ void CheckExample() {
+ AddrInfoResult result;
+ struct ares_addrinfo_hints hints = {};
+ hints.ai_family = AF_INET;
+ hints.ai_flags = ARES_AI_NOSORT;
+ ares_getaddrinfo(channel_, "www.example.com.", NULL, &hints, AddrInfoCallback, &result);
+ Process();
+ EXPECT_TRUE(result.done_);
+ EXPECT_EQ(result.status_, ARES_SUCCESS);
+ EXPECT_THAT(result.ai_, IncludesNumAddresses(1));
+ EXPECT_THAT(result.ai_, IncludesV4Address("2.3.4.5"));
+ }
+};
+
+class NoRotateMultiMockTestAI : public MockMultiServerChannelTestAI {
+ public:
+ NoRotateMultiMockTestAI() : MockMultiServerChannelTestAI(false) {}
+};
+
+TEST_P(NoRotateMultiMockTestAI, ThirdServer) {
+ struct ares_options opts;
+ int optmask = 0;
+ memset(&opts, 0, sizeof(opts));
+ EXPECT_EQ(ARES_SUCCESS, ares_save_options(channel_, &opts, &optmask));
+ EXPECT_EQ(ARES_OPT_NOROTATE, (optmask & ARES_OPT_NOROTATE));
+ ares_destroy_options(&opts);
+
+ DNSPacket servfailrsp;
+ servfailrsp.set_response().set_aa().set_rcode(SERVFAIL)
+ .add_question(new DNSQuestion("www.example.com", T_A));
+ DNSPacket notimplrsp;
+ notimplrsp.set_response().set_aa().set_rcode(NOTIMP)
+ .add_question(new DNSQuestion("www.example.com", T_A));
+ DNSPacket okrsp;
+ okrsp.set_response().set_aa()
+ .add_question(new DNSQuestion("www.example.com", T_A))
+ .add_answer(new DNSARR("www.example.com", 100, {2,3,4,5}));
+
+ EXPECT_CALL(*servers_[0], OnRequest("www.example.com", T_A))
+ .WillOnce(SetReply(servers_[0].get(), &servfailrsp));
+ EXPECT_CALL(*servers_[1], OnRequest("www.example.com", T_A))
+ .WillOnce(SetReply(servers_[1].get(), ¬implrsp));
+ EXPECT_CALL(*servers_[2], OnRequest("www.example.com", T_A))
+ .WillOnce(SetReply(servers_[2].get(), &okrsp));
+ CheckExample();
+
+ // Second time around, still starts from server [2], as [0] and [1] both
+ // recorded failures
+ EXPECT_CALL(*servers_[2], OnRequest("www.example.com", T_A))
+ .WillOnce(SetReply(servers_[2].get(), &servfailrsp));
+ EXPECT_CALL(*servers_[0], OnRequest("www.example.com", T_A))
+ .WillOnce(SetReply(servers_[0].get(), ¬implrsp));
+ EXPECT_CALL(*servers_[1], OnRequest("www.example.com", T_A))
+ .WillOnce(SetReply(servers_[1].get(), &okrsp));
+ CheckExample();
+
+ // Third time around, server order is [1] (f0), [2] (f1), [0] (f2), which
+ // means [1] will get called twice in a row as after the first call
+ // order will be [1] (f1), [2] (f1), [0] (f2) since sort order is
+ // (failure count, index)
+ EXPECT_CALL(*servers_[1], OnRequest("www.example.com", T_A))
+ .WillOnce(SetReply(servers_[1].get(), &servfailrsp))
+ .WillOnce(SetReply(servers_[1].get(), ¬implrsp));
+ EXPECT_CALL(*servers_[2], OnRequest("www.example.com", T_A))
+ .WillOnce(SetReply(servers_[2].get(), ¬implrsp));
+ EXPECT_CALL(*servers_[0], OnRequest("www.example.com", T_A))
+ .WillOnce(SetReply(servers_[0].get(), &okrsp));
+ CheckExample();
+}
+
+TEST_P(MockChannelTestAI, FamilyV4ServiceName) {
+ DNSPacket rsp4;
+ rsp4.set_response().set_aa()
+ .add_question(new DNSQuestion("example.com", T_A))
+ .add_answer(new DNSARR("example.com", 100, {1, 1, 1, 1}))
+ .add_answer(new DNSARR("example.com", 100, {2, 2, 2, 2}));
+ ON_CALL(server_, OnRequest("example.com", T_A))
+ .WillByDefault(SetReply(&server_, &rsp4));
+ AddrInfoResult result = {};
+ struct ares_addrinfo_hints hints = {};
+ hints.ai_family = AF_INET;
+ hints.ai_flags = ARES_AI_NOSORT;
+ ares_getaddrinfo(channel_, "example.com", "http", &hints, AddrInfoCallback, &result);
+ Process();
+ EXPECT_TRUE(result.done_);
+ std::stringstream ss;
+ ss << result.ai_;
+ EXPECT_EQ("{addr=[1.1.1.1:80], addr=[2.2.2.2:80]}", ss.str());
+}
+
+INSTANTIATE_TEST_SUITE_P(AddressFamiliesAI, MockChannelTestAI,
+ ::testing::ValuesIn(ares::test::families_modes));
+
+INSTANTIATE_TEST_SUITE_P(AddressFamiliesAI, MockUDPChannelTestAI,
+ ::testing::ValuesIn(ares::test::families));
+
+INSTANTIATE_TEST_SUITE_P(AddressFamiliesAI, MockTCPChannelTestAI,
+ ::testing::ValuesIn(ares::test::families));
+
+INSTANTIATE_TEST_SUITE_P(AddressFamiliesAI, MockExtraOptsTestAI,
+ ::testing::ValuesIn(ares::test::families_modes));
+
+INSTANTIATE_TEST_SUITE_P(AddressFamiliesAI, MockExtraOptsNDots5TestAI,
+ ::testing::ValuesIn(ares::test::families_modes));
+
+INSTANTIATE_TEST_SUITE_P(AddressFamiliesAI, MockNoCheckRespChannelTestAI,
+ ::testing::ValuesIn(ares::test::families_modes));
+
+INSTANTIATE_TEST_SUITE_P(AddressFamiliesAI, MockEDNSChannelTestAI,
+ ::testing::ValuesIn(ares::test::families_modes));
+
+INSTANTIATE_TEST_SUITE_P(TransportModesAI, NoRotateMultiMockTestAI,
+ ::testing::ValuesIn(ares::test::families_modes));
+
+
+} // namespace test
+} // namespace ares
diff --git a/subprojects/c-ares/test/ares-test-mock.cc b/subprojects/c-ares/test/ares-test-mock.cc
@@ -0,0 +1,1464 @@
+/* MIT License
+ *
+ * Copyright (c) The c-ares project and its contributors
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice (including the next
+ * paragraph) shall be included in all copies or substantial portions of the
+ * Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ *
+ * SPDX-License-Identifier: MIT
+ */
+#include "ares-test.h"
+#include "dns-proto.h"
+
+#ifndef WIN32
+#include <sys/types.h>
+#include <sys/stat.h>
+#endif
+
+#include <sstream>
+#include <vector>
+
+using testing::InvokeWithoutArgs;
+using testing::DoAll;
+
+namespace ares {
+namespace test {
+
+TEST_P(MockChannelTest, Basic) {
+ std::vector<byte> reply = {
+ 0x00, 0x00, // qid
+ 0x84, // response + query + AA + not-TC + not-RD
+ 0x00, // not-RA + not-Z + not-AD + not-CD + rc=NoError
+ 0x00, 0x01, // 1 question
+ 0x00, 0x01, // 1 answer RRs
+ 0x00, 0x00, // 0 authority RRs
+ 0x00, 0x00, // 0 additional RRs
+ // Question
+ 0x03, 'w', 'w', 'w',
+ 0x06, 'g', 'o', 'o', 'g', 'l', 'e',
+ 0x03, 'c', 'o', 'm',
+ 0x00,
+ 0x00, 0x01, // type A
+ 0x00, 0x01, // class IN
+ // Answer
+ 0x03, 'w', 'w', 'w',
+ 0x06, 'g', 'o', 'o', 'g', 'l', 'e',
+ 0x03, 'c', 'o', 'm',
+ 0x00,
+ 0x00, 0x01, // type A
+ 0x00, 0x01, // class IN
+ 0x00, 0x00, 0x01, 0x00, // TTL
+ 0x00, 0x04, // rdata length
+ 0x01, 0x02, 0x03, 0x04
+ };
+
+ ON_CALL(server_, OnRequest("www.google.com", T_A))
+ .WillByDefault(SetReplyData(&server_, reply));
+
+ HostResult result;
+ ares_gethostbyname(channel_, "www.google.com.", AF_INET, HostCallback, &result);
+ Process();
+ EXPECT_TRUE(result.done_);
+ std::stringstream ss;
+ ss << result.host_;
+ EXPECT_EQ("{'www.google.com' aliases=[] addrs=[1.2.3.4]}", ss.str());
+}
+
+// UDP only so mock server doesn't get confused by concatenated requests
+TEST_P(MockUDPChannelTest, GetHostByNameParallelLookups) {
+ DNSPacket rsp1;
+ rsp1.set_response().set_aa()
+ .add_question(new DNSQuestion("www.google.com", T_A))
+ .add_answer(new DNSARR("www.google.com", 100, {2, 3, 4, 5}));
+ ON_CALL(server_, OnRequest("www.google.com", T_A))
+ .WillByDefault(SetReply(&server_, &rsp1));
+ DNSPacket rsp2;
+ rsp2.set_response().set_aa()
+ .add_question(new DNSQuestion("www.example.com", T_A))
+ .add_answer(new DNSARR("www.example.com", 100, {1, 2, 3, 4}));
+ ON_CALL(server_, OnRequest("www.example.com", T_A))
+ .WillByDefault(SetReply(&server_, &rsp2));
+
+ HostResult result1;
+ ares_gethostbyname(channel_, "www.google.com.", AF_INET, HostCallback, &result1);
+ HostResult result2;
+ ares_gethostbyname(channel_, "www.example.com.", AF_INET, HostCallback, &result2);
+ HostResult result3;
+ ares_gethostbyname(channel_, "www.google.com.", AF_INET, HostCallback, &result3);
+ Process();
+ EXPECT_TRUE(result1.done_);
+ EXPECT_TRUE(result2.done_);
+ EXPECT_TRUE(result3.done_);
+ std::stringstream ss1;
+ ss1 << result1.host_;
+ EXPECT_EQ("{'www.google.com' aliases=[] addrs=[2.3.4.5]}", ss1.str());
+ std::stringstream ss2;
+ ss2 << result2.host_;
+ EXPECT_EQ("{'www.example.com' aliases=[] addrs=[1.2.3.4]}", ss2.str());
+ std::stringstream ss3;
+ ss3 << result3.host_;
+ EXPECT_EQ("{'www.google.com' aliases=[] addrs=[2.3.4.5]}", ss3.str());
+}
+
+// UDP to TCP specific test
+TEST_P(MockUDPChannelTest, TruncationRetry) {
+ DNSPacket rsptruncated;
+ rsptruncated.set_response().set_aa().set_tc()
+ .add_question(new DNSQuestion("www.google.com", T_A));
+ DNSPacket rspok;
+ rspok.set_response()
+ .add_question(new DNSQuestion("www.google.com", T_A))
+ .add_answer(new DNSARR("www.google.com", 100, {1, 2, 3, 4}));
+ EXPECT_CALL(server_, OnRequest("www.google.com", T_A))
+ .WillOnce(SetReply(&server_, &rsptruncated))
+ .WillOnce(SetReply(&server_, &rspok));
+ HostResult result;
+ ares_gethostbyname(channel_, "www.google.com.", AF_INET, HostCallback, &result);
+ Process();
+ EXPECT_TRUE(result.done_);
+ std::stringstream ss;
+ ss << result.host_;
+ EXPECT_EQ("{'www.google.com' aliases=[] addrs=[1.2.3.4]}", ss.str());
+}
+
+static int sock_cb_count = 0;
+static int SocketConnectCallback(ares_socket_t fd, int type, void *data) {
+ int rc = *(int*)data;
+ if (verbose) std::cerr << "SocketConnectCallback(" << fd << ") invoked" << std::endl;
+ sock_cb_count++;
+ return rc;
+}
+
+TEST_P(MockChannelTest, SockCallback) {
+ DNSPacket rsp;
+ rsp.set_response().set_aa()
+ .add_question(new DNSQuestion("www.google.com", T_A))
+ .add_answer(new DNSARR("www.google.com", 100, {2, 3, 4, 5}));
+ EXPECT_CALL(server_, OnRequest("www.google.com", T_A))
+ .WillOnce(SetReply(&server_, &rsp));
+
+ // Get notified of new sockets
+ int rc = ARES_SUCCESS;
+ ares_set_socket_callback(channel_, SocketConnectCallback, &rc);
+
+ HostResult result;
+ sock_cb_count = 0;
+ ares_gethostbyname(channel_, "www.google.com.", AF_INET, HostCallback, &result);
+ Process();
+ EXPECT_EQ(1, sock_cb_count);
+ EXPECT_TRUE(result.done_);
+ std::stringstream ss;
+ ss << result.host_;
+ EXPECT_EQ("{'www.google.com' aliases=[] addrs=[2.3.4.5]}", ss.str());
+}
+
+TEST_P(MockChannelTest, SockFailCallback) {
+ // Notification of new sockets gives an error.
+ int rc = -1;
+ ares_set_socket_callback(channel_, SocketConnectCallback, &rc);
+
+ HostResult result;
+ sock_cb_count = 0;
+ ares_gethostbyname(channel_, "www.google.com.", AF_INET, HostCallback, &result);
+ Process();
+ EXPECT_LT(1, sock_cb_count);
+ EXPECT_TRUE(result.done_);
+ EXPECT_EQ(ARES_ECONNREFUSED, result.status_);
+}
+
+static int sock_config_cb_count = 0;
+static int SocketConfigureCallback(ares_socket_t fd, int type, void *data) {
+ int rc = *(int*)data;
+ if (verbose) std::cerr << "SocketConfigureCallback(" << fd << ") invoked" << std::endl;
+ sock_config_cb_count++;
+ return rc;
+}
+
+TEST_P(MockChannelTest, SockConfigureCallback) {
+ DNSPacket rsp;
+ rsp.set_response().set_aa()
+ .add_question(new DNSQuestion("www.google.com", T_A))
+ .add_answer(new DNSARR("www.google.com", 100, {2, 3, 4, 5}));
+ EXPECT_CALL(server_, OnRequest("www.google.com", T_A))
+ .WillOnce(SetReply(&server_, &rsp));
+
+ // Get notified of new sockets
+ int rc = ARES_SUCCESS;
+ ares_set_socket_configure_callback(channel_, SocketConfigureCallback, &rc);
+
+ HostResult result;
+ sock_config_cb_count = 0;
+ ares_gethostbyname(channel_, "www.google.com.", AF_INET, HostCallback, &result);
+ Process();
+ EXPECT_EQ(1, sock_config_cb_count);
+ EXPECT_TRUE(result.done_);
+ std::stringstream ss;
+ ss << result.host_;
+ EXPECT_EQ("{'www.google.com' aliases=[] addrs=[2.3.4.5]}", ss.str());
+}
+
+TEST_P(MockChannelTest, SockConfigureFailCallback) {
+ // Notification of new sockets gives an error.
+ int rc = -1;
+ ares_set_socket_configure_callback(channel_, SocketConfigureCallback, &rc);
+
+ HostResult result;
+ sock_config_cb_count = 0;
+ ares_gethostbyname(channel_, "www.google.com.", AF_INET, HostCallback, &result);
+ Process();
+ EXPECT_LT(1, sock_config_cb_count);
+ EXPECT_TRUE(result.done_);
+ EXPECT_EQ(ARES_ECONNREFUSED, result.status_);
+}
+
+TEST_P(MockChannelTest, ReInit) {
+ DNSPacket rsp;
+ rsp.set_response().set_aa()
+ .add_question(new DNSQuestion("www.google.com", T_A))
+ .add_answer(new DNSARR("www.google.com", 100, {2, 3, 4, 5}));
+ EXPECT_CALL(server_, OnRequest("www.google.com", T_A))
+ .WillOnce(SetReply(&server_, &rsp));
+
+ HostResult result;
+ ares_gethostbyname(channel_, "www.google.com.", AF_INET, HostCallback, &result);
+ EXPECT_EQ(ARES_SUCCESS, ares_reinit(channel_));
+ Process();
+ EXPECT_TRUE(result.done_);
+ std::stringstream ss;
+ ss << result.host_;
+ EXPECT_EQ("{'www.google.com' aliases=[] addrs=[2.3.4.5]}", ss.str());
+}
+
+#define MAXUDPQUERIES_TOTAL 32
+#define MAXUDPQUERIES_LIMIT 8
+
+class MockUDPMaxQueriesTest
+ : public MockChannelOptsTest,
+ public ::testing::WithParamInterface<int> {
+ public:
+ MockUDPMaxQueriesTest()
+ : MockChannelOptsTest(1, GetParam(), false,
+ FillOptions(&opts_),
+ ARES_OPT_UDP_MAX_QUERIES) {}
+ static struct ares_options* FillOptions(struct ares_options * opts) {
+ memset(opts, 0, sizeof(struct ares_options));
+ opts->udp_max_queries = MAXUDPQUERIES_LIMIT;
+ return opts;
+ }
+ private:
+ struct ares_options opts_;
+};
+
+TEST_P(MockUDPMaxQueriesTest, GetHostByNameParallelLookups) {
+ DNSPacket rsp;
+ rsp.set_response().set_aa()
+ .add_question(new DNSQuestion("www.google.com", T_A))
+ .add_answer(new DNSARR("www.google.com", 100, {2, 3, 4, 5}));
+ ON_CALL(server_, OnRequest("www.google.com", T_A))
+ .WillByDefault(SetReply(&server_, &rsp));
+
+ // Get notified of new sockets so we can validate how many are created
+ int rc = ARES_SUCCESS;
+ ares_set_socket_callback(channel_, SocketConnectCallback, &rc);
+ sock_cb_count = 0;
+
+ HostResult result[MAXUDPQUERIES_TOTAL];
+ for (size_t i=0; i<MAXUDPQUERIES_TOTAL; i++) {
+ ares_gethostbyname(channel_, "www.google.com.", AF_INET, HostCallback, &result[i]);
+ }
+
+ Process();
+
+ EXPECT_EQ(MAXUDPQUERIES_TOTAL / MAXUDPQUERIES_LIMIT, sock_cb_count);
+
+ for (size_t i=0; i<MAXUDPQUERIES_TOTAL; i++) {
+ std::stringstream ss;
+ EXPECT_TRUE(result[i].done_);
+ ss << result[i].host_;
+ EXPECT_EQ("{'www.google.com' aliases=[] addrs=[2.3.4.5]}", ss.str());
+ }
+}
+
+class CacheQueriesTest
+ : public MockChannelOptsTest,
+ public ::testing::WithParamInterface<int> {
+ public:
+ CacheQueriesTest()
+ : MockChannelOptsTest(1, GetParam(), false,
+ FillOptions(&opts_),
+ ARES_OPT_QUERY_CACHE) {}
+ static struct ares_options* FillOptions(struct ares_options * opts) {
+ memset(opts, 0, sizeof(struct ares_options));
+ opts->qcache_max_ttl = 3600;
+ return opts;
+ }
+ private:
+ struct ares_options opts_;
+};
+
+TEST_P(CacheQueriesTest, GetHostByNameCache) {
+ DNSPacket rsp;
+ rsp.set_response().set_aa()
+ .add_question(new DNSQuestion("www.google.com", T_A))
+ .add_answer(new DNSARR("www.google.com", 100, {2, 3, 4, 5}));
+ ON_CALL(server_, OnRequest("www.google.com", T_A))
+ .WillByDefault(SetReply(&server_, &rsp));
+
+ // Get notified of new sockets so we can validate how many are created
+ int rc = ARES_SUCCESS;
+ ares_set_socket_callback(channel_, SocketConnectCallback, &rc);
+ sock_cb_count = 0;
+
+ HostResult result1;
+ ares_gethostbyname(channel_, "www.google.com.", AF_INET, HostCallback, &result1);
+ Process();
+
+ std::stringstream ss1;
+ EXPECT_TRUE(result1.done_);
+ ss1 << result1.host_;
+ EXPECT_EQ("{'www.google.com' aliases=[] addrs=[2.3.4.5]}", ss1.str());
+
+ /* Run again, should return cached result */
+ HostResult result2;
+ ares_gethostbyname(channel_, "www.google.com.", AF_INET, HostCallback, &result2);
+ Process();
+
+ std::stringstream ss2;
+ EXPECT_TRUE(result2.done_);
+ ss2 << result2.host_;
+ EXPECT_EQ("{'www.google.com' aliases=[] addrs=[2.3.4.5]}", ss2.str());
+
+ EXPECT_EQ(1, sock_cb_count);
+}
+
+#define TCPPARALLELLOOKUPS 32
+TEST_P(MockTCPChannelTest, GetHostByNameParallelLookups) {
+ DNSPacket rsp;
+ rsp.set_response().set_aa()
+ .add_question(new DNSQuestion("www.google.com", T_A))
+ .add_answer(new DNSARR("www.google.com", 100, {2, 3, 4, 5}));
+ ON_CALL(server_, OnRequest("www.google.com", T_A))
+ .WillByDefault(SetReply(&server_, &rsp));
+
+ // Get notified of new sockets so we can validate how many are created
+ int rc = ARES_SUCCESS;
+ ares_set_socket_callback(channel_, SocketConnectCallback, &rc);
+ sock_cb_count = 0;
+
+ HostResult result[TCPPARALLELLOOKUPS];
+ for (size_t i=0; i<TCPPARALLELLOOKUPS; i++) {
+ ares_gethostbyname(channel_, "www.google.com.", AF_INET, HostCallback, &result[i]);
+ }
+
+ Process();
+
+ EXPECT_EQ(1, sock_cb_count);
+
+ for (size_t i=0; i<TCPPARALLELLOOKUPS; i++) {
+ std::stringstream ss;
+ EXPECT_TRUE(result[i].done_);
+ ss << result[i].host_;
+ EXPECT_EQ("{'www.google.com' aliases=[] addrs=[2.3.4.5]}", ss.str());
+ }
+}
+
+TEST_P(MockTCPChannelTest, MalformedResponse) {
+ std::vector<byte> one = {0x00};
+ ON_CALL(server_, OnRequest("www.google.com", T_A))
+ .WillByDefault(SetReplyData(&server_, one));
+
+ HostResult result;
+ ares_gethostbyname(channel_, "www.google.com.", AF_INET, HostCallback, &result);
+ Process();
+ EXPECT_TRUE(result.done_);
+ EXPECT_EQ(ARES_ETIMEOUT, result.status_);
+}
+
+TEST_P(MockTCPChannelTest, FormErrResponse) {
+ DNSPacket rsp;
+ rsp.set_response().set_aa()
+ .add_question(new DNSQuestion("www.google.com", T_A));
+ rsp.set_rcode(FORMERR);
+ EXPECT_CALL(server_, OnRequest("www.google.com", T_A))
+ .WillOnce(SetReply(&server_, &rsp));
+ HostResult result;
+ ares_gethostbyname(channel_, "www.google.com.", AF_INET, HostCallback, &result);
+ Process();
+ EXPECT_TRUE(result.done_);
+ EXPECT_EQ(ARES_EFORMERR, result.status_);
+}
+
+TEST_P(MockTCPChannelTest, ServFailResponse) {
+ DNSPacket rsp;
+ rsp.set_response().set_aa()
+ .add_question(new DNSQuestion("www.google.com", T_A));
+ rsp.set_rcode(SERVFAIL);
+ ON_CALL(server_, OnRequest("www.google.com", T_A))
+ .WillByDefault(SetReply(&server_, &rsp));
+ HostResult result;
+ ares_gethostbyname(channel_, "www.google.com.", AF_INET, HostCallback, &result);
+ Process();
+ EXPECT_TRUE(result.done_);
+ EXPECT_EQ(ARES_ESERVFAIL, result.status_);
+}
+
+TEST_P(MockTCPChannelTest, NotImplResponse) {
+ DNSPacket rsp;
+ rsp.set_response().set_aa()
+ .add_question(new DNSQuestion("www.google.com", T_A));
+ rsp.set_rcode(NOTIMP);
+ ON_CALL(server_, OnRequest("www.google.com", T_A))
+ .WillByDefault(SetReply(&server_, &rsp));
+ HostResult result;
+ ares_gethostbyname(channel_, "www.google.com.", AF_INET, HostCallback, &result);
+ Process();
+ EXPECT_TRUE(result.done_);
+ EXPECT_EQ(ARES_ENOTIMP, result.status_);
+}
+
+TEST_P(MockTCPChannelTest, RefusedResponse) {
+ DNSPacket rsp;
+ rsp.set_response().set_aa()
+ .add_question(new DNSQuestion("www.google.com", T_A));
+ rsp.set_rcode(REFUSED);
+ ON_CALL(server_, OnRequest("www.google.com", T_A))
+ .WillByDefault(SetReply(&server_, &rsp));
+ HostResult result;
+ ares_gethostbyname(channel_, "www.google.com.", AF_INET, HostCallback, &result);
+ Process();
+ EXPECT_TRUE(result.done_);
+ EXPECT_EQ(ARES_EREFUSED, result.status_);
+}
+
+TEST_P(MockTCPChannelTest, YXDomainResponse) {
+ DNSPacket rsp;
+ rsp.set_response().set_aa()
+ .add_question(new DNSQuestion("www.google.com", T_A));
+ rsp.set_rcode(YXDOMAIN);
+ EXPECT_CALL(server_, OnRequest("www.google.com", T_A))
+ .WillOnce(SetReply(&server_, &rsp));
+ HostResult result;
+ ares_gethostbyname(channel_, "www.google.com.", AF_INET, HostCallback, &result);
+ Process();
+ EXPECT_TRUE(result.done_);
+ EXPECT_EQ(ARES_ENODATA, result.status_);
+}
+
+class MockExtraOptsTest
+ : public MockChannelOptsTest,
+ public ::testing::WithParamInterface< std::pair<int, bool> > {
+ public:
+ MockExtraOptsTest()
+ : MockChannelOptsTest(1, GetParam().first, GetParam().second,
+ FillOptions(&opts_),
+ ARES_OPT_SOCK_SNDBUF|ARES_OPT_SOCK_RCVBUF) {}
+ static struct ares_options* FillOptions(struct ares_options * opts) {
+ memset(opts, 0, sizeof(struct ares_options));
+ // Set a few options that affect socket communications
+ opts->socket_send_buffer_size = 514;
+ opts->socket_receive_buffer_size = 514;
+ return opts;
+ }
+ private:
+ struct ares_options opts_;
+};
+
+TEST_P(MockExtraOptsTest, SimpleQuery) {
+ ares_set_local_ip4(channel_, 0x7F000001);
+ byte addr6[16] = {0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00,
+ 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x01};
+ ares_set_local_ip6(channel_, addr6);
+ ares_set_local_dev(channel_, "dummy");
+
+ DNSPacket rsp;
+ rsp.set_response().set_aa()
+ .add_question(new DNSQuestion("www.google.com", T_A))
+ .add_answer(new DNSARR("www.google.com", 100, {2, 3, 4, 5}));
+ ON_CALL(server_, OnRequest("www.google.com", T_A))
+ .WillByDefault(SetReply(&server_, &rsp));
+
+ HostResult result;
+ ares_gethostbyname(channel_, "www.google.com.", AF_INET, HostCallback, &result);
+ Process();
+ EXPECT_TRUE(result.done_);
+ std::stringstream ss;
+ ss << result.host_;
+ EXPECT_EQ("{'www.google.com' aliases=[] addrs=[2.3.4.5]}", ss.str());
+}
+
+class MockFlagsChannelOptsTest
+ : public MockChannelOptsTest,
+ public ::testing::WithParamInterface< std::pair<int, bool> > {
+ public:
+ MockFlagsChannelOptsTest(int flags)
+ : MockChannelOptsTest(1, GetParam().first, GetParam().second,
+ FillOptions(&opts_, flags), ARES_OPT_FLAGS) {}
+ static struct ares_options* FillOptions(struct ares_options * opts, int flags) {
+ memset(opts, 0, sizeof(struct ares_options));
+ opts->flags = flags;
+ return opts;
+ }
+ private:
+ struct ares_options opts_;
+};
+
+class MockNoCheckRespChannelTest : public MockFlagsChannelOptsTest {
+ public:
+ MockNoCheckRespChannelTest() : MockFlagsChannelOptsTest(ARES_FLAG_NOCHECKRESP) {}
+};
+
+TEST_P(MockNoCheckRespChannelTest, ServFailResponse) {
+ DNSPacket rsp;
+ rsp.set_response().set_aa()
+ .add_question(new DNSQuestion("www.google.com", T_A));
+ rsp.set_rcode(SERVFAIL);
+ ON_CALL(server_, OnRequest("www.google.com", T_A))
+ .WillByDefault(SetReply(&server_, &rsp));
+ HostResult result;
+ ares_gethostbyname(channel_, "www.google.com.", AF_INET, HostCallback, &result);
+ Process();
+ EXPECT_TRUE(result.done_);
+ EXPECT_EQ(ARES_ESERVFAIL, result.status_);
+}
+
+TEST_P(MockNoCheckRespChannelTest, NotImplResponse) {
+ DNSPacket rsp;
+ rsp.set_response().set_aa()
+ .add_question(new DNSQuestion("www.google.com", T_A));
+ rsp.set_rcode(NOTIMP);
+ ON_CALL(server_, OnRequest("www.google.com", T_A))
+ .WillByDefault(SetReply(&server_, &rsp));
+ HostResult result;
+ ares_gethostbyname(channel_, "www.google.com.", AF_INET, HostCallback, &result);
+ Process();
+ EXPECT_TRUE(result.done_);
+ EXPECT_EQ(ARES_ENOTIMP, result.status_);
+}
+
+TEST_P(MockNoCheckRespChannelTest, RefusedResponse) {
+ DNSPacket rsp;
+ rsp.set_response().set_aa()
+ .add_question(new DNSQuestion("www.google.com", T_A));
+ rsp.set_rcode(REFUSED);
+ ON_CALL(server_, OnRequest("www.google.com", T_A))
+ .WillByDefault(SetReply(&server_, &rsp));
+ HostResult result;
+ ares_gethostbyname(channel_, "www.google.com.", AF_INET, HostCallback, &result);
+ Process();
+ EXPECT_TRUE(result.done_);
+ EXPECT_EQ(ARES_EREFUSED, result.status_);
+}
+
+class MockEDNSChannelTest : public MockFlagsChannelOptsTest {
+ public:
+ MockEDNSChannelTest() : MockFlagsChannelOptsTest(ARES_FLAG_EDNS) {}
+};
+
+TEST_P(MockEDNSChannelTest, RetryWithoutEDNS) {
+ DNSPacket rspfail;
+ rspfail.set_response().set_aa().set_rcode(FORMERR)
+ .add_question(new DNSQuestion("www.google.com", T_A));
+ DNSPacket rspok;
+ rspok.set_response()
+ .add_question(new DNSQuestion("www.google.com", T_A))
+ .add_answer(new DNSARR("www.google.com", 100, {1, 2, 3, 4}));
+ EXPECT_CALL(server_, OnRequest("www.google.com", T_A))
+ .WillOnce(SetReply(&server_, &rspfail))
+ .WillOnce(SetReply(&server_, &rspok));
+ HostResult result;
+ ares_gethostbyname(channel_, "www.google.com.", AF_INET, HostCallback, &result);
+ Process();
+ EXPECT_TRUE(result.done_);
+ std::stringstream ss;
+ ss << result.host_;
+ EXPECT_EQ("{'www.google.com' aliases=[] addrs=[1.2.3.4]}", ss.str());
+}
+
+TEST_P(MockChannelTest, SearchDomains) {
+ DNSPacket nofirst;
+ nofirst.set_response().set_aa().set_rcode(NXDOMAIN)
+ .add_question(new DNSQuestion("www.first.com", T_A));
+ ON_CALL(server_, OnRequest("www.first.com", T_A))
+ .WillByDefault(SetReply(&server_, &nofirst));
+ DNSPacket nosecond;
+ nosecond.set_response().set_aa().set_rcode(NXDOMAIN)
+ .add_question(new DNSQuestion("www.second.org", T_A));
+ ON_CALL(server_, OnRequest("www.second.org", T_A))
+ .WillByDefault(SetReply(&server_, &nosecond));
+ DNSPacket yesthird;
+ yesthird.set_response().set_aa()
+ .add_question(new DNSQuestion("www.third.gov", T_A))
+ .add_answer(new DNSARR("www.third.gov", 0x0200, {2, 3, 4, 5}));
+ ON_CALL(server_, OnRequest("www.third.gov", T_A))
+ .WillByDefault(SetReply(&server_, &yesthird));
+
+ HostResult result;
+ ares_gethostbyname(channel_, "www", AF_INET, HostCallback, &result);
+ Process();
+ EXPECT_TRUE(result.done_);
+ std::stringstream ss;
+ ss << result.host_;
+ EXPECT_EQ("{'www.third.gov' aliases=[] addrs=[2.3.4.5]}", ss.str());
+}
+
+// Relies on retries so is UDP-only
+TEST_P(MockUDPChannelTest, SearchDomainsWithResentReply) {
+ DNSPacket nofirst;
+ nofirst.set_response().set_aa().set_rcode(NXDOMAIN)
+ .add_question(new DNSQuestion("www.first.com", T_A));
+ EXPECT_CALL(server_, OnRequest("www.first.com", T_A))
+ .WillOnce(SetReply(&server_, &nofirst));
+ DNSPacket nosecond;
+ nosecond.set_response().set_aa().set_rcode(NXDOMAIN)
+ .add_question(new DNSQuestion("www.second.org", T_A));
+ EXPECT_CALL(server_, OnRequest("www.second.org", T_A))
+ .WillOnce(SetReply(&server_, &nosecond));
+ DNSPacket yesthird;
+ yesthird.set_response().set_aa()
+ .add_question(new DNSQuestion("www.third.gov", T_A))
+ .add_answer(new DNSARR("www.third.gov", 0x0200, {2, 3, 4, 5}));
+ // Before sending the real answer, resend an earlier reply
+ EXPECT_CALL(server_, OnRequest("www.third.gov", T_A))
+ .WillOnce(DoAll(SetReply(&server_, &nofirst),
+ SetReplyQID(&server_, 123)))
+ .WillOnce(DoAll(SetReply(&server_, &yesthird),
+ SetReplyQID(&server_, -1)));
+
+ HostResult result;
+ ares_gethostbyname(channel_, "www", AF_INET, HostCallback, &result);
+ Process();
+ EXPECT_TRUE(result.done_);
+ std::stringstream ss;
+ ss << result.host_;
+ EXPECT_EQ("{'www.third.gov' aliases=[] addrs=[2.3.4.5]}", ss.str());
+}
+
+TEST_P(MockChannelTest, SearchDomainsBare) {
+ DNSPacket nofirst;
+ nofirst.set_response().set_aa().set_rcode(NXDOMAIN)
+ .add_question(new DNSQuestion("www.first.com", T_A));
+ ON_CALL(server_, OnRequest("www.first.com", T_A))
+ .WillByDefault(SetReply(&server_, &nofirst));
+ DNSPacket nosecond;
+ nosecond.set_response().set_aa().set_rcode(NXDOMAIN)
+ .add_question(new DNSQuestion("www.second.org", T_A));
+ ON_CALL(server_, OnRequest("www.second.org", T_A))
+ .WillByDefault(SetReply(&server_, &nosecond));
+ DNSPacket nothird;
+ nothird.set_response().set_aa().set_rcode(NXDOMAIN)
+ .add_question(new DNSQuestion("www.third.gov", T_A));
+ ON_CALL(server_, OnRequest("www.third.gov", T_A))
+ .WillByDefault(SetReply(&server_, ¬hird));
+ DNSPacket yesbare;
+ yesbare.set_response().set_aa()
+ .add_question(new DNSQuestion("www", T_A))
+ .add_answer(new DNSARR("www", 0x0200, {2, 3, 4, 5}));
+ ON_CALL(server_, OnRequest("www", T_A))
+ .WillByDefault(SetReply(&server_, &yesbare));
+
+ HostResult result;
+ ares_gethostbyname(channel_, "www", AF_INET, HostCallback, &result);
+ Process();
+ EXPECT_TRUE(result.done_);
+ std::stringstream ss;
+ ss << result.host_;
+ EXPECT_EQ("{'www' aliases=[] addrs=[2.3.4.5]}", ss.str());
+}
+
+TEST_P(MockChannelTest, SearchNoDataThenSuccess) {
+ // First two search domains recognize the name but have no A records.
+ DNSPacket nofirst;
+ nofirst.set_response().set_aa()
+ .add_question(new DNSQuestion("www.first.com", T_A));
+ ON_CALL(server_, OnRequest("www.first.com", T_A))
+ .WillByDefault(SetReply(&server_, &nofirst));
+ DNSPacket nosecond;
+ nosecond.set_response().set_aa()
+ .add_question(new DNSQuestion("www.second.org", T_A));
+ ON_CALL(server_, OnRequest("www.second.org", T_A))
+ .WillByDefault(SetReply(&server_, &nosecond));
+ DNSPacket yesthird;
+ yesthird.set_response().set_aa()
+ .add_question(new DNSQuestion("www.third.gov", T_A))
+ .add_answer(new DNSARR("www.third.gov", 0x0200, {2, 3, 4, 5}));
+ ON_CALL(server_, OnRequest("www.third.gov", T_A))
+ .WillByDefault(SetReply(&server_, &yesthird));
+
+ HostResult result;
+ ares_gethostbyname(channel_, "www", AF_INET, HostCallback, &result);
+ Process();
+ EXPECT_TRUE(result.done_);
+ std::stringstream ss;
+ ss << result.host_;
+ EXPECT_EQ("{'www.third.gov' aliases=[] addrs=[2.3.4.5]}", ss.str());
+}
+
+TEST_P(MockChannelTest, SearchNoDataThenNoDataBare) {
+ // First two search domains recognize the name but have no A records.
+ DNSPacket nofirst;
+ nofirst.set_response().set_aa()
+ .add_question(new DNSQuestion("www.first.com", T_A));
+ ON_CALL(server_, OnRequest("www.first.com", T_A))
+ .WillByDefault(SetReply(&server_, &nofirst));
+ DNSPacket nosecond;
+ nosecond.set_response().set_aa()
+ .add_question(new DNSQuestion("www.second.org", T_A));
+ ON_CALL(server_, OnRequest("www.second.org", T_A))
+ .WillByDefault(SetReply(&server_, &nosecond));
+ DNSPacket nothird;
+ nothird.set_response().set_aa()
+ .add_question(new DNSQuestion("www.third.gov", T_A));
+ ON_CALL(server_, OnRequest("www.third.gov", T_A))
+ .WillByDefault(SetReply(&server_, ¬hird));
+ DNSPacket nobare;
+ nobare.set_response().set_aa()
+ .add_question(new DNSQuestion("www", T_A));
+ ON_CALL(server_, OnRequest("www", T_A))
+ .WillByDefault(SetReply(&server_, &nobare));
+
+ HostResult result;
+ ares_gethostbyname(channel_, "www", AF_INET, HostCallback, &result);
+ Process();
+ EXPECT_TRUE(result.done_);
+ EXPECT_EQ(ARES_ENODATA, result.status_);
+}
+
+TEST_P(MockChannelTest, SearchNoDataThenFail) {
+ // First two search domains recognize the name but have no A records.
+ DNSPacket nofirst;
+ nofirst.set_response().set_aa()
+ .add_question(new DNSQuestion("www.first.com", T_A));
+ ON_CALL(server_, OnRequest("www.first.com", T_A))
+ .WillByDefault(SetReply(&server_, &nofirst));
+ DNSPacket nosecond;
+ nosecond.set_response().set_aa()
+ .add_question(new DNSQuestion("www.second.org", T_A));
+ ON_CALL(server_, OnRequest("www.second.org", T_A))
+ .WillByDefault(SetReply(&server_, &nosecond));
+ DNSPacket nothird;
+ nothird.set_response().set_aa()
+ .add_question(new DNSQuestion("www.third.gov", T_A));
+ ON_CALL(server_, OnRequest("www.third.gov", T_A))
+ .WillByDefault(SetReply(&server_, ¬hird));
+ DNSPacket nobare;
+ nobare.set_response().set_aa().set_rcode(NXDOMAIN)
+ .add_question(new DNSQuestion("www", T_A));
+ ON_CALL(server_, OnRequest("www", T_A))
+ .WillByDefault(SetReply(&server_, &nobare));
+
+ HostResult result;
+ ares_gethostbyname(channel_, "www", AF_INET, HostCallback, &result);
+ Process();
+ EXPECT_TRUE(result.done_);
+ EXPECT_EQ(ARES_ENODATA, result.status_);
+}
+
+TEST_P(MockChannelTest, SearchAllocFailure) {
+ SearchResult result;
+ SetAllocFail(1);
+ ares_search(channel_, "fully.qualified.", C_IN, T_A, SearchCallback, &result);
+ /* Already done */
+ EXPECT_TRUE(result.done_);
+ EXPECT_EQ(ARES_ENOMEM, result.status_);
+}
+
+TEST_P(MockChannelTest, SearchHighNdots) {
+ DNSPacket nobare;
+ nobare.set_response().set_aa().set_rcode(NXDOMAIN)
+ .add_question(new DNSQuestion("a.b.c.w.w.w", T_A));
+ ON_CALL(server_, OnRequest("a.b.c.w.w.w", T_A))
+ .WillByDefault(SetReply(&server_, &nobare));
+ DNSPacket yesfirst;
+ yesfirst.set_response().set_aa()
+ .add_question(new DNSQuestion("a.b.c.w.w.w.first.com", T_A))
+ .add_answer(new DNSARR("a.b.c.w.w.w.first.com", 0x0200, {2, 3, 4, 5}));
+ ON_CALL(server_, OnRequest("a.b.c.w.w.w.first.com", T_A))
+ .WillByDefault(SetReply(&server_, &yesfirst));
+
+ SearchResult result;
+ ares_search(channel_, "a.b.c.w.w.w", C_IN, T_A, SearchCallback, &result);
+ Process();
+ EXPECT_TRUE(result.done_);
+ EXPECT_EQ(ARES_SUCCESS, result.status_);
+ std::stringstream ss;
+ ss << PacketToString(result.data_);
+ EXPECT_EQ("RSP QRY AA NOERROR Q:{'a.b.c.w.w.w.first.com' IN A} "
+ "A:{'a.b.c.w.w.w.first.com' IN A TTL=512 2.3.4.5}",
+ ss.str());
+}
+
+TEST_P(MockChannelTest, V4WorksV6Timeout) {
+ std::vector<byte> nothing;
+ DNSPacket reply;
+ reply.set_response().set_aa()
+ .add_question(new DNSQuestion("www.google.com", T_A))
+ .add_answer(new DNSARR("www.google.com", 0x0100, {0x01, 0x02, 0x03, 0x04}));
+
+ ON_CALL(server_, OnRequest("www.google.com", T_A))
+ .WillByDefault(SetReply(&server_, &reply));
+
+ ON_CALL(server_, OnRequest("www.google.com", T_AAAA))
+ .WillByDefault(SetReplyData(&server_, nothing));
+
+ HostResult result;
+ ares_gethostbyname(channel_, "www.google.com.", AF_UNSPEC, HostCallback, &result);
+ Process();
+ EXPECT_TRUE(result.done_);
+ EXPECT_EQ(1, result.timeouts_);
+ std::stringstream ss;
+ ss << result.host_;
+ EXPECT_EQ("{'www.google.com' aliases=[] addrs=[1.2.3.4]}", ss.str());
+}
+
+#ifndef CARES_SYMBOL_HIDING
+// Test case for Issue #662
+TEST_P(MockChannelTest, PartialQueryCancel) {
+ std::vector<byte> nothing;
+ DNSPacket reply;
+ reply.set_response().set_aa()
+ .add_question(new DNSQuestion("www.google.com", T_A))
+ .add_answer(new DNSARR("www.google.com", 0x0100, {0x01, 0x02, 0x03, 0x04}));
+
+ ON_CALL(server_, OnRequest("www.google.com", T_A))
+ .WillByDefault(SetReply(&server_, &reply));
+
+ ON_CALL(server_, OnRequest("www.google.com", T_AAAA))
+ .WillByDefault(SetReplyData(&server_, nothing));
+
+ HostResult result;
+ ares_gethostbyname(channel_, "www.google.com.", AF_UNSPEC, HostCallback, &result);
+ // After 100ms, issues ares_cancel(), this should be enough time for the A
+ // record reply, but before the timeout on the AAAA record.
+ Process(100);
+ EXPECT_TRUE(result.done_);
+ EXPECT_EQ(ARES_ECANCELLED, result.status_);
+}
+#endif
+
+TEST_P(MockChannelTest, UnspecifiedFamilyV6) {
+ DNSPacket rsp6;
+ rsp6.set_response().set_aa()
+ .add_question(new DNSQuestion("example.com", T_AAAA))
+ .add_answer(new DNSAaaaRR("example.com", 100,
+ {0x21, 0x21, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00,
+ 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x03, 0x03}));
+ ON_CALL(server_, OnRequest("example.com", T_AAAA))
+ .WillByDefault(SetReply(&server_, &rsp6));
+
+ DNSPacket rsp4;
+ rsp4.set_response().set_aa()
+ .add_question(new DNSQuestion("example.com", T_A));
+ ON_CALL(server_, OnRequest("example.com", T_A))
+ .WillByDefault(SetReply(&server_, &rsp4));
+
+ HostResult result;
+ ares_gethostbyname(channel_, "example.com.", AF_UNSPEC, HostCallback, &result);
+ Process();
+ EXPECT_TRUE(result.done_);
+ std::stringstream ss;
+ ss << result.host_;
+ // Default to IPv6 when both are available.
+ EXPECT_EQ("{'example.com' aliases=[] addrs=[2121:0000:0000:0000:0000:0000:0000:0303]}", ss.str());
+}
+
+TEST_P(MockChannelTest, UnspecifiedFamilyV4) {
+ DNSPacket rsp6;
+ rsp6.set_response().set_aa()
+ .add_question(new DNSQuestion("example.com", T_AAAA));
+ ON_CALL(server_, OnRequest("example.com", T_AAAA))
+ .WillByDefault(SetReply(&server_, &rsp6));
+ DNSPacket rsp4;
+ rsp4.set_response().set_aa()
+ .add_question(new DNSQuestion("example.com", T_A))
+ .add_answer(new DNSARR("example.com", 100, {2, 3, 4, 5}));
+ ON_CALL(server_, OnRequest("example.com", T_A))
+ .WillByDefault(SetReply(&server_, &rsp4));
+
+ HostResult result;
+ ares_gethostbyname(channel_, "example.com.", AF_UNSPEC, HostCallback, &result);
+ Process();
+ EXPECT_TRUE(result.done_);
+ std::stringstream ss;
+ ss << result.host_;
+ EXPECT_EQ("{'example.com' aliases=[] addrs=[2.3.4.5]}", ss.str());
+}
+
+TEST_P(MockChannelTest, UnspecifiedFamilyNoData) {
+ DNSPacket rsp6;
+ rsp6.set_response().set_aa()
+ .add_question(new DNSQuestion("example.com", T_AAAA))
+ .add_answer(new DNSCnameRR("example.com", 100, "elsewhere.com"));
+ ON_CALL(server_, OnRequest("example.com", T_AAAA))
+ .WillByDefault(SetReply(&server_, &rsp6));
+ DNSPacket rsp4;
+ rsp4.set_response().set_aa()
+ .add_question(new DNSQuestion("example.com", T_A));
+ ON_CALL(server_, OnRequest("example.com", T_A))
+ .WillByDefault(SetReply(&server_, &rsp4));
+
+ HostResult result;
+ ares_gethostbyname(channel_, "example.com.", AF_UNSPEC, HostCallback, &result);
+ Process();
+ EXPECT_TRUE(result.done_);
+ std::stringstream ss;
+ ss << result.host_;
+ EXPECT_EQ("{'' aliases=[] addrs=[]}", ss.str());
+}
+
+TEST_P(MockChannelTest, UnspecifiedFamilyCname6A4) {
+ DNSPacket rsp6;
+ rsp6.set_response().set_aa()
+ .add_question(new DNSQuestion("example.com", T_AAAA))
+ .add_answer(new DNSCnameRR("example.com", 100, "elsewhere.com"));
+ ON_CALL(server_, OnRequest("example.com", T_AAAA))
+ .WillByDefault(SetReply(&server_, &rsp6));
+ DNSPacket rsp4;
+ rsp4.set_response().set_aa()
+ .add_question(new DNSQuestion("example.com", T_A))
+ .add_answer(new DNSARR("example.com", 100, {1, 2, 3, 4}));
+ ON_CALL(server_, OnRequest("example.com", T_A))
+ .WillByDefault(SetReply(&server_, &rsp4));
+
+ HostResult result;
+ ares_gethostbyname(channel_, "example.com.", AF_UNSPEC, HostCallback, &result);
+ Process();
+ EXPECT_TRUE(result.done_);
+ std::stringstream ss;
+ ss << result.host_;
+ EXPECT_EQ("{'example.com' aliases=[] addrs=[1.2.3.4]}", ss.str());
+}
+
+TEST_P(MockChannelTest, ExplicitIP) {
+ HostResult result;
+ ares_gethostbyname(channel_, "1.2.3.4", AF_INET, HostCallback, &result);
+ EXPECT_TRUE(result.done_); // Immediate return
+ EXPECT_EQ(ARES_SUCCESS, result.status_);
+ std::stringstream ss;
+ ss << result.host_;
+ EXPECT_EQ("{'1.2.3.4' aliases=[] addrs=[1.2.3.4]}", ss.str());
+}
+
+TEST_P(MockChannelTest, ExplicitIPAllocFail) {
+ HostResult result;
+ SetAllocSizeFail(strlen("1.2.3.4") + 1);
+ ares_gethostbyname(channel_, "1.2.3.4", AF_INET, HostCallback, &result);
+ EXPECT_TRUE(result.done_); // Immediate return
+ EXPECT_EQ(ARES_ENOMEM, result.status_);
+}
+
+TEST_P(MockChannelTest, SortListV4) {
+ DNSPacket rsp;
+ rsp.set_response().set_aa()
+ .add_question(new DNSQuestion("example.com", T_A))
+ .add_answer(new DNSARR("example.com", 100, {22, 23, 24, 25}))
+ .add_answer(new DNSARR("example.com", 100, {12, 13, 14, 15}))
+ .add_answer(new DNSARR("example.com", 100, {2, 3, 4, 5}));
+ ON_CALL(server_, OnRequest("example.com", T_A))
+ .WillByDefault(SetReply(&server_, &rsp));
+
+ {
+ EXPECT_EQ(ARES_SUCCESS, ares_set_sortlist(channel_, "12.13.0.0/255.255.0.0 1234::5678"));
+ HostResult result;
+ ares_gethostbyname(channel_, "example.com.", AF_INET, HostCallback, &result);
+ Process();
+ EXPECT_TRUE(result.done_);
+ std::stringstream ss;
+ ss << result.host_;
+ EXPECT_EQ("{'example.com' aliases=[] addrs=[12.13.14.15, 22.23.24.25, 2.3.4.5]}", ss.str());
+ }
+ {
+ EXPECT_EQ(ARES_SUCCESS, ares_set_sortlist(channel_, "2.3.0.0/16 130.140.150.160/26"));
+ HostResult result;
+ ares_gethostbyname(channel_, "example.com.", AF_INET, HostCallback, &result);
+ Process();
+ EXPECT_TRUE(result.done_);
+ std::stringstream ss;
+ ss << result.host_;
+ EXPECT_EQ("{'example.com' aliases=[] addrs=[2.3.4.5, 22.23.24.25, 12.13.14.15]}", ss.str());
+ }
+ struct ares_options options;
+ memset(&options, 0, sizeof(options));
+ int optmask = 0;
+ EXPECT_EQ(ARES_SUCCESS, ares_save_options(channel_, &options, &optmask));
+ EXPECT_TRUE((optmask & ARES_OPT_SORTLIST) == ARES_OPT_SORTLIST);
+ ares_destroy_options(&options);
+}
+
+TEST_P(MockChannelTest, SortListV6) {
+ DNSPacket rsp;
+ rsp.set_response().set_aa()
+ .add_question(new DNSQuestion("example.com", T_AAAA))
+ .add_answer(new DNSAaaaRR("example.com", 100,
+ {0x11, 0x11, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00,
+ 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x02, 0x02}))
+ .add_answer(new DNSAaaaRR("example.com", 100,
+ {0x21, 0x21, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00,
+ 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x03, 0x03}));
+ ON_CALL(server_, OnRequest("example.com", T_AAAA))
+ .WillByDefault(SetReply(&server_, &rsp));
+
+ {
+ ares_set_sortlist(channel_, "1111::/16 2.3.0.0/255.255.0.0");
+ HostResult result;
+ ares_gethostbyname(channel_, "example.com.", AF_INET6, HostCallback, &result);
+ Process();
+ EXPECT_TRUE(result.done_);
+ std::stringstream ss;
+ ss << result.host_;
+ EXPECT_EQ("{'example.com' aliases=[] addrs=[1111:0000:0000:0000:0000:0000:0000:0202, "
+ "2121:0000:0000:0000:0000:0000:0000:0303]}", ss.str());
+ }
+ {
+ ares_set_sortlist(channel_, "2121::/8");
+ HostResult result;
+ ares_gethostbyname(channel_, "example.com.", AF_INET6, HostCallback, &result);
+ Process();
+ EXPECT_TRUE(result.done_);
+ std::stringstream ss;
+ ss << result.host_;
+ EXPECT_EQ("{'example.com' aliases=[] addrs=[2121:0000:0000:0000:0000:0000:0000:0303, "
+ "1111:0000:0000:0000:0000:0000:0000:0202]}", ss.str());
+ }
+}
+
+// Relies on retries so is UDP-only
+TEST_P(MockUDPChannelTest, SearchDomainsAllocFail) {
+ DNSPacket nofirst;
+ nofirst.set_response().set_aa().set_rcode(NXDOMAIN)
+ .add_question(new DNSQuestion("www.first.com", T_A));
+ ON_CALL(server_, OnRequest("www.first.com", T_A))
+ .WillByDefault(SetReply(&server_, &nofirst));
+ DNSPacket nosecond;
+ nosecond.set_response().set_aa().set_rcode(NXDOMAIN)
+ .add_question(new DNSQuestion("www.second.org", T_A));
+ ON_CALL(server_, OnRequest("www.second.org", T_A))
+ .WillByDefault(SetReply(&server_, &nosecond));
+ DNSPacket yesthird;
+ yesthird.set_response().set_aa()
+ .add_question(new DNSQuestion("www.third.gov", T_A))
+ .add_answer(new DNSARR("www.third.gov", 0x0200, {2, 3, 4, 5}));
+ ON_CALL(server_, OnRequest("www.third.gov", T_A))
+ .WillByDefault(SetReply(&server_, &yesthird));
+
+ // Fail a variety of different memory allocations, and confirm
+ // that the operation either fails with ENOMEM or succeeds
+ // with the expected result.
+ const int kCount = 34;
+ HostResult results[kCount];
+ for (int ii = 1; ii <= kCount; ii++) {
+ HostResult* result = &(results[ii - 1]);
+ ClearFails();
+ SetAllocFail(ii);
+ ares_gethostbyname(channel_, "www", AF_INET, HostCallback, result);
+ Process();
+ EXPECT_TRUE(result->done_);
+ if (result->status_ == ARES_SUCCESS) {
+ std::stringstream ss;
+ ss << result->host_;
+ EXPECT_EQ("{'www.third.gov' aliases=[] addrs=[2.3.4.5]}", ss.str()) << " failed alloc #" << ii;
+ if (verbose) std::cerr << "Succeeded despite failure of alloc #" << ii << std::endl;
+ }
+ }
+
+ // Explicitly destroy the channel now, so that the HostResult objects
+ // are still valid (in case any pending work refers to them).
+ ares_destroy(channel_);
+ channel_ = nullptr;
+}
+
+// Relies on retries so is UDP-only
+TEST_P(MockUDPChannelTest, Resend) {
+ std::vector<byte> nothing;
+ DNSPacket reply;
+ reply.set_response().set_aa()
+ .add_question(new DNSQuestion("www.google.com", T_A))
+ .add_answer(new DNSARR("www.google.com", 0x0100, {0x01, 0x02, 0x03, 0x04}));
+
+ EXPECT_CALL(server_, OnRequest("www.google.com", T_A))
+ .WillOnce(SetReplyData(&server_, nothing))
+ .WillOnce(SetReplyData(&server_, nothing))
+ .WillOnce(SetReply(&server_, &reply));
+
+ HostResult result;
+ ares_gethostbyname(channel_, "www.google.com.", AF_INET, HostCallback, &result);
+ Process();
+ EXPECT_TRUE(result.done_);
+ EXPECT_EQ(2, result.timeouts_);
+ std::stringstream ss;
+ ss << result.host_;
+ EXPECT_EQ("{'www.google.com' aliases=[] addrs=[1.2.3.4]}", ss.str());
+}
+
+TEST_P(MockChannelTest, CancelImmediate) {
+ HostResult result;
+ ares_gethostbyname(channel_, "www.google.com.", AF_INET, HostCallback, &result);
+ ares_cancel(channel_);
+ EXPECT_TRUE(result.done_);
+ EXPECT_EQ(ARES_ECANCELLED, result.status_);
+ EXPECT_EQ(0, result.timeouts_);
+}
+
+TEST_P(MockChannelTest, CancelImmediateGetHostByAddr) {
+ HostResult result;
+ struct in_addr addr;
+ addr.s_addr = htonl(0x08080808);
+
+ ares_gethostbyaddr(channel_, &addr, sizeof(addr), AF_INET, HostCallback, &result);
+ ares_cancel(channel_);
+ EXPECT_TRUE(result.done_);
+ EXPECT_EQ(ARES_ECANCELLED, result.status_);
+ EXPECT_EQ(0, result.timeouts_);
+}
+
+// Relies on retries so is UDP-only
+TEST_P(MockUDPChannelTest, CancelLater) {
+ std::vector<byte> nothing;
+
+ // On second request, cancel the channel.
+ EXPECT_CALL(server_, OnRequest("www.google.com", T_A))
+ .WillOnce(SetReplyData(&server_, nothing))
+ .WillOnce(CancelChannel(&server_, channel_));
+
+ HostResult result;
+ ares_gethostbyname(channel_, "www.google.com.", AF_INET, HostCallback, &result);
+ Process();
+ EXPECT_TRUE(result.done_);
+ EXPECT_EQ(ARES_ECANCELLED, result.status_);
+ EXPECT_EQ(0, result.timeouts_);
+}
+
+TEST_P(MockChannelTest, DisconnectFirstAttempt) {
+ DNSPacket reply;
+ reply.set_response().set_aa()
+ .add_question(new DNSQuestion("www.google.com", T_A))
+ .add_answer(new DNSARR("www.google.com", 0x0100, {0x01, 0x02, 0x03, 0x04}));
+
+ // On second request, cancel the channel.
+ EXPECT_CALL(server_, OnRequest("www.google.com", T_A))
+ .WillOnce(Disconnect(&server_))
+ .WillOnce(SetReply(&server_, &reply));
+
+ HostResult result;
+ ares_gethostbyname(channel_, "www.google.com.", AF_INET, HostCallback, &result);
+ Process();
+ EXPECT_TRUE(result.done_);
+ std::stringstream ss;
+ ss << result.host_;
+ EXPECT_EQ("{'www.google.com' aliases=[] addrs=[1.2.3.4]}", ss.str());
+}
+
+TEST_P(MockChannelTest, GetHostByNameDestroyAbsolute) {
+ HostResult result;
+ ares_gethostbyname(channel_, "www.google.com.", AF_INET, HostCallback, &result);
+
+ ares_destroy(channel_);
+ channel_ = nullptr;
+
+ EXPECT_TRUE(result.done_); // Synchronous
+ EXPECT_EQ(ARES_EDESTRUCTION, result.status_);
+ EXPECT_EQ(0, result.timeouts_);
+}
+
+TEST_P(MockChannelTest, GetHostByNameDestroyRelative) {
+ HostResult result;
+ ares_gethostbyname(channel_, "www", AF_INET, HostCallback, &result);
+
+ ares_destroy(channel_);
+ channel_ = nullptr;
+
+ EXPECT_TRUE(result.done_); // Synchronous
+ EXPECT_EQ(ARES_EDESTRUCTION, result.status_);
+ EXPECT_EQ(0, result.timeouts_);
+}
+
+TEST_P(MockChannelTest, GetHostByNameCNAMENoData) {
+ DNSPacket response;
+ response.set_response().set_aa()
+ .add_question(new DNSQuestion("cname.first.com", T_A))
+ .add_answer(new DNSCnameRR("cname.first.com", 100, "a.first.com"));
+ ON_CALL(server_, OnRequest("cname.first.com", T_A))
+ .WillByDefault(SetReply(&server_, &response));
+
+ HostResult result;
+ ares_gethostbyname(channel_, "cname.first.com.", AF_INET, HostCallback, &result);
+ Process();
+ EXPECT_TRUE(result.done_);
+ EXPECT_EQ(ARES_ENODATA, result.status_);
+}
+
+TEST_P(MockChannelTest, GetHostByAddrDestroy) {
+ unsigned char gdns_addr4[4] = {0x08, 0x08, 0x08, 0x08};
+ HostResult result;
+ ares_gethostbyaddr(channel_, gdns_addr4, sizeof(gdns_addr4), AF_INET, HostCallback, &result);
+
+ ares_destroy(channel_);
+ channel_ = nullptr;
+
+ EXPECT_TRUE(result.done_); // Synchronous
+ EXPECT_EQ(ARES_EDESTRUCTION, result.status_);
+ EXPECT_EQ(0, result.timeouts_);
+}
+
+#ifndef WIN32
+TEST_P(MockChannelTest, HostAlias) {
+ DNSPacket reply;
+ reply.set_response().set_aa()
+ .add_question(new DNSQuestion("www.google.com", T_A))
+ .add_answer(new DNSARR("www.google.com", 0x0100, {0x01, 0x02, 0x03, 0x04}));
+ ON_CALL(server_, OnRequest("www.google.com", T_A))
+ .WillByDefault(SetReply(&server_, &reply));
+
+ TempFile aliases("\n\n# www commentedout\nwww www.google.com\n");
+ EnvValue with_env("HOSTALIASES", aliases.filename());
+
+ HostResult result;
+ ares_gethostbyname(channel_, "www", AF_INET, HostCallback, &result);
+ Process();
+ EXPECT_TRUE(result.done_);
+ std::stringstream ss;
+ ss << result.host_;
+ EXPECT_EQ("{'www.google.com' aliases=[] addrs=[1.2.3.4]}", ss.str());
+}
+
+TEST_P(MockChannelTest, HostAliasMissing) {
+ DNSPacket yesfirst;
+ yesfirst.set_response().set_aa()
+ .add_question(new DNSQuestion("www.first.com", T_A))
+ .add_answer(new DNSARR("www.first.com", 0x0200, {2, 3, 4, 5}));
+ ON_CALL(server_, OnRequest("www.first.com", T_A))
+ .WillByDefault(SetReply(&server_, &yesfirst));
+
+ TempFile aliases("\n\n# www commentedout\nww www.google.com\n");
+ EnvValue with_env("HOSTALIASES", aliases.filename());
+ HostResult result;
+ ares_gethostbyname(channel_, "www", AF_INET, HostCallback, &result);
+ Process();
+ EXPECT_TRUE(result.done_);
+ std::stringstream ss;
+ ss << result.host_;
+ EXPECT_EQ("{'www.first.com' aliases=[] addrs=[2.3.4.5]}", ss.str());
+}
+
+TEST_P(MockChannelTest, HostAliasMissingFile) {
+ DNSPacket yesfirst;
+ yesfirst.set_response().set_aa()
+ .add_question(new DNSQuestion("www.first.com", T_A))
+ .add_answer(new DNSARR("www.first.com", 0x0200, {2, 3, 4, 5}));
+ ON_CALL(server_, OnRequest("www.first.com", T_A))
+ .WillByDefault(SetReply(&server_, &yesfirst));
+
+ EnvValue with_env("HOSTALIASES", "bogus.mcfile");
+ HostResult result;
+ ares_gethostbyname(channel_, "www", AF_INET, HostCallback, &result);
+ Process();
+ EXPECT_TRUE(result.done_);
+ std::stringstream ss;
+ ss << result.host_;
+ EXPECT_EQ("{'www.first.com' aliases=[] addrs=[2.3.4.5]}", ss.str());
+}
+
+TEST_P(MockChannelTest, HostAliasUnreadable) {
+ TempFile aliases("www www.google.com\n");
+ EXPECT_EQ(chmod(aliases.filename(), 0), 0);
+
+ /* Perform OS sanity checks. We are observing on Debian after the chmod(fn, 0)
+ * that we are still able to fopen() the file which is unexpected. Skip the
+ * test if we observe this behavior */
+ struct stat st;
+ EXPECT_EQ(stat(aliases.filename(), &st), 0);
+ EXPECT_EQ(st.st_mode & (S_IRWXU|S_IRWXG|S_IRWXO), 0);
+ FILE *fp = fopen(aliases.filename(), "r");
+ if (fp != NULL) {
+ if (verbose) std::cerr << "Skipping Test due to OS incompatibility (open file caching)" << std::endl;
+ fclose(fp);
+ return;
+ }
+
+ EnvValue with_env("HOSTALIASES", aliases.filename());
+
+ HostResult result;
+ ares_gethostbyname(channel_, "www", AF_INET, HostCallback, &result);
+ Process();
+ EXPECT_TRUE(result.done_);
+ EXPECT_EQ(ARES_EFILE, result.status_);
+ chmod(aliases.filename(), 0777);
+}
+#endif
+
+class MockMultiServerChannelTest
+ : public MockChannelOptsTest,
+ public ::testing::WithParamInterface< std::pair<int, bool> > {
+ public:
+ MockMultiServerChannelTest(bool rotate)
+ : MockChannelOptsTest(3, GetParam().first, GetParam().second, nullptr, rotate ? ARES_OPT_ROTATE : ARES_OPT_NOROTATE) {}
+ void CheckExample() {
+ HostResult result;
+ ares_gethostbyname(channel_, "www.example.com.", AF_INET, HostCallback, &result);
+ Process();
+ EXPECT_TRUE(result.done_);
+ std::stringstream ss;
+ ss << result.host_;
+ EXPECT_EQ("{'www.example.com' aliases=[] addrs=[2.3.4.5]}", ss.str());
+ }
+};
+
+class NoRotateMultiMockTest : public MockMultiServerChannelTest {
+ public:
+ NoRotateMultiMockTest() : MockMultiServerChannelTest(false) {}
+};
+
+TEST_P(NoRotateMultiMockTest, ThirdServer) {
+ struct ares_options opts;
+ int optmask = 0;
+ memset(&opts, 0, sizeof(opts));
+ EXPECT_EQ(ARES_SUCCESS, ares_save_options(channel_, &opts, &optmask));
+ EXPECT_EQ(ARES_OPT_NOROTATE, (optmask & ARES_OPT_NOROTATE));
+ ares_destroy_options(&opts);
+
+ DNSPacket servfailrsp;
+ servfailrsp.set_response().set_aa().set_rcode(SERVFAIL)
+ .add_question(new DNSQuestion("www.example.com", T_A));
+ DNSPacket notimplrsp;
+ notimplrsp.set_response().set_aa().set_rcode(NOTIMP)
+ .add_question(new DNSQuestion("www.example.com", T_A));
+ DNSPacket okrsp;
+ okrsp.set_response().set_aa()
+ .add_question(new DNSQuestion("www.example.com", T_A))
+ .add_answer(new DNSARR("www.example.com", 100, {2,3,4,5}));
+
+ EXPECT_CALL(*servers_[0], OnRequest("www.example.com", T_A))
+ .WillOnce(SetReply(servers_[0].get(), &servfailrsp));
+ EXPECT_CALL(*servers_[1], OnRequest("www.example.com", T_A))
+ .WillOnce(SetReply(servers_[1].get(), ¬implrsp));
+ EXPECT_CALL(*servers_[2], OnRequest("www.example.com", T_A))
+ .WillOnce(SetReply(servers_[2].get(), &okrsp));
+ CheckExample();
+
+ // Second time around, still starts from server [2], as [0] and [1] both
+ // recorded failures
+ EXPECT_CALL(*servers_[2], OnRequest("www.example.com", T_A))
+ .WillOnce(SetReply(servers_[2].get(), &servfailrsp));
+ EXPECT_CALL(*servers_[0], OnRequest("www.example.com", T_A))
+ .WillOnce(SetReply(servers_[0].get(), ¬implrsp));
+ EXPECT_CALL(*servers_[1], OnRequest("www.example.com", T_A))
+ .WillOnce(SetReply(servers_[1].get(), &okrsp));
+ CheckExample();
+
+ // Third time around, server order is [1] (f0), [2] (f1), [0] (f2), which
+ // means [1] will get called twice in a row as after the first call
+ // order will be [1] (f1), [2] (f1), [0] (f2) since sort order is
+ // (failure count, index)
+ EXPECT_CALL(*servers_[1], OnRequest("www.example.com", T_A))
+ .WillOnce(SetReply(servers_[1].get(), &servfailrsp))
+ .WillOnce(SetReply(servers_[1].get(), ¬implrsp));
+ EXPECT_CALL(*servers_[2], OnRequest("www.example.com", T_A))
+ .WillOnce(SetReply(servers_[2].get(), ¬implrsp));
+ EXPECT_CALL(*servers_[0], OnRequest("www.example.com", T_A))
+ .WillOnce(SetReply(servers_[0].get(), &okrsp));
+ CheckExample();
+}
+
+TEST_P(NoRotateMultiMockTest, ServerNoResponseFailover) {
+ std::vector<byte> nothing;
+ DNSPacket okrsp;
+ okrsp.set_response().set_aa()
+ .add_question(new DNSQuestion("www.example.com", T_A))
+ .add_answer(new DNSARR("www.example.com", 100, {2,3,4,5}));
+
+ /* Server #1 works fine on first attempt, then acts like its offline on
+ * second, then backonline on the third. */
+ EXPECT_CALL(*servers_[0], OnRequest("www.example.com", T_A))
+ .WillOnce(SetReply(servers_[0].get(), &okrsp))
+ .WillOnce(SetReplyData(servers_[0].get(), nothing))
+ .WillOnce(SetReply(servers_[0].get(), &okrsp));
+
+ /* Server #2 always acts like its offline */
+ ON_CALL(*servers_[1], OnRequest("www.example.com", T_A))
+ .WillByDefault(SetReplyData(servers_[1].get(), nothing));
+
+ /* Server #3 works fine on first and second request, then no reply on 3rd */
+ EXPECT_CALL(*servers_[2], OnRequest("www.example.com", T_A))
+ .WillOnce(SetReply(servers_[2].get(), &okrsp))
+ .WillOnce(SetReply(servers_[2].get(), &okrsp))
+ .WillOnce(SetReplyData(servers_[2].get(), nothing));
+
+ HostResult result;
+
+ /* 1. First server returns a response on the first request immediately, normal
+ * operation on channel. */
+ ares_gethostbyname(channel_, "www.example.com.", AF_INET, HostCallback, &result);
+ Process();
+ EXPECT_TRUE(result.done_);
+ EXPECT_EQ(0, result.timeouts_);
+ std::stringstream ss1;
+ ss1 << result.host_;
+ EXPECT_EQ("{'www.example.com' aliases=[] addrs=[2.3.4.5]}", ss1.str());
+
+ /* 2. On the second request, simulate the first and second servers not
+ * returning a response at all, but the 3rd server works, so should have
+ * 2 timeouts. */
+ ares_gethostbyname(channel_, "www.example.com.", AF_INET, HostCallback, &result);
+ Process();
+ EXPECT_TRUE(result.done_);
+ EXPECT_EQ(2, result.timeouts_);
+ std::stringstream ss2;
+ ss2 << result.host_;
+ EXPECT_EQ("{'www.example.com' aliases=[] addrs=[2.3.4.5]}", ss2.str());
+
+ /* 3. On the third request, the active server should be #3, so should respond
+ * immediately with no timeouts */
+ ares_gethostbyname(channel_, "www.example.com.", AF_INET, HostCallback, &result);
+ Process();
+ EXPECT_TRUE(result.done_);
+ EXPECT_EQ(0, result.timeouts_);
+ std::stringstream ss3;
+ ss3 << result.host_;
+ EXPECT_EQ("{'www.example.com' aliases=[] addrs=[2.3.4.5]}", ss3.str());
+
+ /* 4. On the fourth request, the active server should be #3, but will timeout,
+ * and the first server should then respond */
+ ares_gethostbyname(channel_, "www.example.com.", AF_INET, HostCallback, &result);
+ Process();
+ EXPECT_TRUE(result.done_);
+ EXPECT_EQ(1, result.timeouts_);
+ std::stringstream ss4;
+ ss4 << result.host_;
+ EXPECT_EQ("{'www.example.com' aliases=[] addrs=[2.3.4.5]}", ss4.str());
+}
+
+INSTANTIATE_TEST_SUITE_P(AddressFamilies, MockChannelTest, ::testing::ValuesIn(ares::test::families_modes));
+
+INSTANTIATE_TEST_SUITE_P(AddressFamilies, MockUDPChannelTest, ::testing::ValuesIn(ares::test::families));
+
+INSTANTIATE_TEST_SUITE_P(AddressFamilies, MockUDPMaxQueriesTest, ::testing::ValuesIn(ares::test::families));
+
+INSTANTIATE_TEST_SUITE_P(AddressFamilies, CacheQueriesTest, ::testing::ValuesIn(ares::test::families));
+
+INSTANTIATE_TEST_SUITE_P(AddressFamilies, MockTCPChannelTest, ::testing::ValuesIn(ares::test::families));
+
+INSTANTIATE_TEST_SUITE_P(AddressFamilies, MockExtraOptsTest, ::testing::ValuesIn(ares::test::families_modes));
+
+INSTANTIATE_TEST_SUITE_P(AddressFamilies, MockNoCheckRespChannelTest, ::testing::ValuesIn(ares::test::families_modes));
+
+INSTANTIATE_TEST_SUITE_P(AddressFamilies, MockEDNSChannelTest, ::testing::ValuesIn(ares::test::families_modes));
+
+INSTANTIATE_TEST_SUITE_P(TransportModes, NoRotateMultiMockTest, ::testing::ValuesIn(ares::test::families_modes));
+
+} // namespace test
+} // namespace ares
diff --git a/subprojects/c-ares/test/ares-test-ns.cc b/subprojects/c-ares/test/ares-test-ns.cc
@@ -0,0 +1,216 @@
+/*
+ * Copyright (C) The c-ares project
+ *
+ * Permission to use, copy, modify, and distribute this
+ * software and its documentation for any purpose and without
+ * fee is hereby granted, provided that the above copyright
+ * notice appear in all copies and that both that copyright
+ * notice and this permission notice appear in supporting
+ * documentation, and that the name of M.I.T. not be used in
+ * advertising or publicity pertaining to distribution of the
+ * software without specific, written prior permission.
+ * M.I.T. makes no representations about the suitability of
+ * this software for any purpose. It is provided "as is"
+ * without express or implied warranty.
+ *
+ * SPDX-License-Identifier: MIT
+ */
+#include "ares-test.h"
+
+#ifdef HAVE_CONTAINER
+
+#include <sys/mount.h>
+#include <sys/types.h>
+#include <sys/stat.h>
+#include <fcntl.h>
+
+#include <iostream>
+#include <functional>
+#include <string>
+#include <sstream>
+#include <vector>
+
+namespace ares {
+namespace test {
+
+namespace {
+
+struct ContainerInfo {
+ ContainerFilesystem* fs_;
+ std::string hostname_;
+ std::string domainname_;
+ VoidToIntFn fn_;
+};
+
+int EnterContainer(void *data) {
+ ContainerInfo *container = (ContainerInfo*)data;
+
+ if (verbose) {
+ std::cerr << "Running function in container {chroot='"
+ << container->fs_->root() << "', hostname='" << container->hostname_
+ << "', domainname='" << container->domainname_ << "'}"
+ << std::endl;
+ }
+
+ // Ensure we are apparently root before continuing.
+ int count = 10;
+ while (getuid() != 0 && count > 0) {
+ usleep(100000);
+ count--;
+ }
+ if (getuid() != 0) {
+ std::cerr << "Child in user namespace has uid " << getuid() << std::endl;
+ return -1;
+ }
+ if (!container->fs_->mountpt().empty()) {
+ // We want to bind mount this inside the specified directory.
+ std::string innerdir = container->fs_->root() + container->fs_->mountpt();
+ if (verbose) std::cerr << " mount --bind " << container->fs_->mountpt()
+ << " " << innerdir << std::endl;
+ int rc = mount(container->fs_->mountpt().c_str(), innerdir.c_str(),
+ "none", MS_BIND, 0);
+ if (rc != 0) {
+ std::cerr << "Warning: failed to bind mount " << container->fs_->mountpt() << " at "
+ << innerdir << ", errno=" << errno << std::endl;
+ }
+ }
+
+ // Move into the specified directory.
+ if (chdir(container->fs_->root().c_str()) != 0) {
+ std::cerr << "Failed to chdir('" << container->fs_->root()
+ << "'), errno=" << errno << std::endl;
+ return -1;
+ }
+ // And make it the new root directory;
+ char buffer[PATH_MAX + 1];
+ if (getcwd(buffer, PATH_MAX) == NULL) {
+ std::cerr << "failed to retrieve cwd, errno=" << errno << std::endl;
+ return -1;
+ }
+ buffer[PATH_MAX] = '\0';
+ if (chroot(buffer) != 0) {
+ std::cerr << "chroot('" << buffer << "') failed, errno=" << errno << std::endl;
+ return -1;
+ }
+
+ // Set host/domainnames if specified
+ if (!container->hostname_.empty()) {
+ if (sethostname(container->hostname_.c_str(),
+ container->hostname_.size()) != 0) {
+ std::cerr << "Failed to sethostname('" << container->hostname_
+ << "'), errno=" << errno << std::endl;
+ return -1;
+ }
+ }
+ if (!container->domainname_.empty()) {
+ if (setdomainname(container->domainname_.c_str(),
+ container->domainname_.size()) != 0) {
+ std::cerr << "Failed to setdomainname('" << container->domainname_
+ << "'), errno=" << errno << std::endl;
+ return -1;
+ }
+ }
+
+ return container->fn_();
+}
+
+} // namespace
+
+// Run a function while:
+// - chroot()ed into a particular directory
+// - having a specified hostname/domainname
+
+int RunInContainer(ContainerFilesystem* fs, const std::string& hostname,
+ const std::string& domainname, VoidToIntFn fn) {
+ const int stack_size = 1024 * 1024;
+ std::vector<byte> stack(stack_size, 0);
+ ContainerInfo container = {fs, hostname, domainname, fn};
+
+ // Start a child process in a new user and UTS namespace
+ pid_t child = clone(EnterContainer, stack.data() + stack_size,
+ CLONE_VM|CLONE_NEWNS|CLONE_NEWUSER|CLONE_NEWUTS|SIGCHLD,
+ (void *)&container);
+ if (child < 0) {
+ std::cerr << "Failed to clone(), errno=" << errno << std::endl;
+ return -1;
+ }
+
+ // Build the UID map that makes us look like root inside the namespace.
+ std::stringstream mapfiless;
+ mapfiless << "/proc/" << child << "/uid_map";
+ std::string mapfile = mapfiless.str();
+ int fd = open(mapfile.c_str(), O_CREAT|O_WRONLY|O_TRUNC, 0644);
+ if (fd < 0) {
+ std::cerr << "Failed to create '" << mapfile << "'" << std::endl;
+ return -1;
+ }
+ std::stringstream contentss;
+ contentss << "0 " << getuid() << " 1" << std::endl;
+ std::string content = contentss.str();
+ int rc = write(fd, content.c_str(), content.size());
+ if (rc != (int)content.size()) {
+ std::cerr << "Failed to write uid map to '" << mapfile << "'" << std::endl;
+ }
+ close(fd);
+
+ // Wait for the child process and retrieve its status.
+ int status;
+ waitpid(child, &status, 0);
+ if (rc <= 0) {
+ std::cerr << "Failed to waitpid(" << child << ")" << std::endl;
+ return -1;
+ }
+ if (!WIFEXITED(status)) {
+ std::cerr << "Child " << child << " did not exit normally" << std::endl;
+ return -1;
+ }
+ return status;
+}
+
+ContainerFilesystem::ContainerFilesystem(NameContentList files, const std::string& mountpt) {
+ rootdir_ = TempNam(nullptr, "ares-chroot");
+ mkdir(rootdir_.c_str(), 0755);
+ dirs_.push_front(rootdir_);
+ for (const auto& nc : files) {
+ std::string fullpath = rootdir_ + nc.first;
+ int idx = fullpath.rfind('/');
+ std::string dir = fullpath.substr(0, idx);
+ EnsureDirExists(dir);
+ files_.push_back(std::unique_ptr<TransientFile>(
+ new TransientFile(fullpath, nc.second)));
+ }
+ if (!mountpt.empty()) {
+ char buffer[PATH_MAX + 1];
+ if (realpath(mountpt.c_str(), buffer)) {
+ mountpt_ = buffer;
+ std::string fullpath = rootdir_ + mountpt_;
+ EnsureDirExists(fullpath);
+ }
+ }
+}
+
+ContainerFilesystem::~ContainerFilesystem() {
+ files_.clear();
+ for (const std::string& dir : dirs_) {
+ rmdir(dir.c_str());
+ }
+}
+
+void ContainerFilesystem::EnsureDirExists(const std::string& dir) {
+ if (std::find(dirs_.begin(), dirs_.end(), dir) != dirs_.end()) {
+ return;
+ }
+ size_t idx = dir.rfind('/');
+ if (idx != std::string::npos) {
+ std::string prevdir = dir.substr(0, idx);
+ EnsureDirExists(prevdir);
+ }
+ // Ensure this directory is in the list before its ancestors.
+ mkdir(dir.c_str(), 0755);
+ dirs_.push_front(dir);
+}
+
+} // namespace test
+} // namespace ares
+
+#endif
diff --git a/subprojects/c-ares/test/ares-test-parse-a.cc b/subprojects/c-ares/test/ares-test-parse-a.cc
@@ -0,0 +1,395 @@
+/*
+ * Copyright (C) The c-ares project
+ *
+ * Permission to use, copy, modify, and distribute this
+ * software and its documentation for any purpose and without
+ * fee is hereby granted, provided that the above copyright
+ * notice appear in all copies and that both that copyright
+ * notice and this permission notice appear in supporting
+ * documentation, and that the name of M.I.T. not be used in
+ * advertising or publicity pertaining to distribution of the
+ * software without specific, written prior permission.
+ * M.I.T. makes no representations about the suitability of
+ * this software for any purpose. It is provided "as is"
+ * without express or implied warranty.
+ *
+ * SPDX-License-Identifier: MIT
+ */
+#include "ares-test.h"
+#include "dns-proto.h"
+
+#include <sstream>
+#include <vector>
+
+namespace ares {
+namespace test {
+
+TEST_F(LibraryTest, ParseAReplyOK) {
+ DNSPacket pkt;
+ pkt.set_qid(0x1234).set_response().set_aa()
+ .add_question(new DNSQuestion("example.com", T_A))
+ .add_answer(new DNSARR("example.com", 0x01020304, {2,3,4,5}))
+ .add_answer(new DNSAaaaRR("example.com", 0x01020304, {0,0,0,0,0,0,0,0,0,0,0,0,2,3,4,5}));
+ std::vector<byte> data = {
+ 0x12, 0x34, // qid
+ 0x84, // response + query + AA + not-TC + not-RD
+ 0x00, // not-RA + not-Z + not-AD + not-CD + rc=NoError
+ 0x00, 0x01, // num questions
+ 0x00, 0x02, // num answer RRs
+ 0x00, 0x00, // num authority RRs
+ 0x00, 0x00, // num additional RRs
+ // Question
+ 0x07, 'e', 'x', 'a', 'm', 'p', 'l', 'e',
+ 0x03, 'c', 'o', 'm',
+ 0x00,
+ 0x00, 0x01, // type A
+ 0x00, 0x01, // class IN
+ // Answer 1
+ 0x07, 'e', 'x', 'a', 'm', 'p', 'l', 'e',
+ 0x03, 'c', 'o', 'm',
+ 0x00,
+ 0x00, 0x01, // RR type
+ 0x00, 0x01, // class IN
+ 0x01, 0x02, 0x03, 0x04, // TTL
+ 0x00, 0x04, // rdata length
+ 0x02, 0x03, 0x04, 0x05,
+ // Answer 2
+ 0x07, 'e', 'x', 'a', 'm', 'p', 'l', 'e',
+ 0x03, 'c', 'o', 'm',
+ 0x00,
+ 0x00, 0x1c, // RR type
+ 0x00, 0x01, // class IN
+ 0x01, 0x02, 0x03, 0x04, // TTL
+ 0x00, 0x10, // rdata length
+ 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x02, 0x03, 0x04, 0x05,
+ };
+ EXPECT_EQ(data, pkt.data());
+ struct hostent *host = nullptr;
+ struct ares_addrttl info[5];
+ int count = 5;
+ EXPECT_EQ(ARES_SUCCESS, ares_parse_a_reply(data.data(), (int)data.size(),
+ &host, info, &count));
+ EXPECT_EQ(1, count);
+ EXPECT_EQ(0x01020304, info[0].ttl);
+ unsigned long expected_addr = htonl(0x02030405);
+ EXPECT_EQ(expected_addr, info[0].ipaddr.s_addr);
+ EXPECT_EQ("2.3.4.5", AddressToString(&(info[0].ipaddr), 4));
+ ASSERT_NE(nullptr, host);
+ std::stringstream ss;
+ ss << HostEnt(host);
+ EXPECT_EQ("{'example.com' aliases=[] addrs=[2.3.4.5]}", ss.str());
+ ares_free_hostent(host);
+
+ // Repeat without providing a hostent
+ EXPECT_EQ(ARES_SUCCESS, ares_parse_a_reply(data.data(), (int)data.size(),
+ nullptr, info, &count));
+ EXPECT_EQ(1, count);
+ EXPECT_EQ(0x01020304, info[0].ttl);
+ EXPECT_EQ(expected_addr, info[0].ipaddr.s_addr);
+ EXPECT_EQ("2.3.4.5", AddressToString(&(info[0].ipaddr), 4));
+}
+
+TEST_F(LibraryTest, ParseMalformedAReply) {
+ std::vector<byte> data = {
+ 0x12, 0x34, // [0:2) qid
+ 0x84, // [2] response + query + AA + not-TC + not-RD
+ 0x00, // [3] not-RA + not-Z + not-AD + not-CD + rc=NoError
+ 0x00, 0x01, // [4:6) num questions
+ 0x00, 0x02, // [6:8) num answer RRs
+ 0x00, 0x00, // [8:10) num authority RRs
+ 0x00, 0x00, // [10:12) num additional RRs
+ // Question
+ 0x07, 'e', 'x', 'a', 'm', 'p', 'l', 'e', // [12:20)
+ 0x03, 'c', 'o', 'm', // [20,24)
+ 0x00, // [24]
+ 0x00, 0x01, // [25:26) type A
+ 0x00, 0x01, // [27:29) class IN
+ // Answer 1
+ 0x07, 'e', 'x', 'a', 'm', 'p', 'l', 'e', // [29:37)
+ 0x03, 'c', 'o', 'm', // [37:41)
+ 0x00, // [41]
+ 0x00, 0x01, // [42:44) RR type
+ 0x00, 0x01, // [44:46) class IN
+ 0x01, 0x02, 0x03, 0x04, // [46:50) TTL
+ 0x00, 0x04, // [50:52) rdata length
+ 0x02, 0x03, 0x04, 0x05, // [52,56)
+ };
+ struct hostent *host = nullptr;
+ struct ares_addrttl info[2];
+ int count = 2;
+
+ // Invalid RR-len.
+ std::vector<byte> invalid_rrlen(data);
+ invalid_rrlen[51] = 180;
+ EXPECT_EQ(ARES_EBADRESP, ares_parse_a_reply(invalid_rrlen.data(), (int)invalid_rrlen.size(),
+ &host, info, &count));
+
+ // Truncate mid-question.
+ EXPECT_EQ(ARES_EBADRESP, ares_parse_a_reply(data.data(), 26,
+ &host, info, &count));
+
+ // Truncate mid-answer.
+ EXPECT_EQ(ARES_EBADRESP, ares_parse_a_reply(data.data(), 42,
+ &host, info, &count));
+}
+
+TEST_F(LibraryTest, ParseAReplyNoData) {
+ DNSPacket pkt;
+ pkt.set_qid(0x1234).set_response().set_aa()
+ .add_question(new DNSQuestion("example.com", T_A));
+ std::vector<byte> data = pkt.data();
+ struct hostent *host = nullptr;
+ struct ares_addrttl info[2];
+ int count = 2;
+ EXPECT_EQ(ARES_ENODATA, ares_parse_a_reply(data.data(), (int)data.size(),
+ &host, info, &count));
+ EXPECT_EQ(0, count);
+ EXPECT_EQ(nullptr, host);
+
+ // Again but with a CNAME.
+ pkt.add_answer(new DNSCnameRR("example.com", 200, "c.example.com"));
+ data = pkt.data();
+ // Expect success as per https://github.com/c-ares/c-ares/commit/2c63440127feed70ccefb148b8f938a2df6c15f8
+ EXPECT_EQ(ARES_SUCCESS, ares_parse_a_reply(data.data(), (int)data.size(),
+ &host, info, &count));
+ EXPECT_EQ(0, count);
+ EXPECT_NE(nullptr, host);
+ std::stringstream ss;
+ ss << HostEnt(host);
+ EXPECT_EQ("{'c.example.com' aliases=[example.com] addrs=[]}", ss.str());
+ ares_free_hostent(host);
+}
+
+TEST_F(LibraryTest, ParseAReplyVariantA) {
+ DNSPacket pkt;
+ pkt.set_qid(6366).set_rd().set_ra()
+ .add_question(new DNSQuestion("mit.edu", T_A))
+ .add_answer(new DNSARR("mit.edu", 52, {18,7,22,69}))
+ .add_auth(new DNSNsRR("mit.edu", 292, "W20NS.mit.edu"))
+ .add_auth(new DNSNsRR("mit.edu", 292, "BITSY.mit.edu"))
+ .add_auth(new DNSNsRR("mit.edu", 292, "STRAWB.mit.edu"))
+ .add_additional(new DNSARR("STRAWB.mit.edu", 292, {18,71,0,151}));
+ struct hostent *host = nullptr;
+ struct ares_addrttl info[2];
+ int count = 2;
+ std::vector<byte> data = pkt.data();
+ EXPECT_EQ(ARES_SUCCESS, ares_parse_a_reply(data.data(), (int)data.size(),
+ &host, info, &count));
+ EXPECT_EQ(1, count);
+ EXPECT_EQ("18.7.22.69", AddressToString(&(info[0].ipaddr), 4));
+ EXPECT_EQ(52, info[0].ttl);
+ ares_free_hostent(host);
+}
+
+TEST_F(LibraryTest, ParseAReplyJustCname) {
+ DNSPacket pkt;
+ pkt.set_qid(6366).set_rd().set_ra()
+ .add_question(new DNSQuestion("mit.edu", T_A))
+ .add_answer(new DNSCnameRR("mit.edu", 52, "other.mit.edu"));
+ struct hostent *host = nullptr;
+ struct ares_addrttl info[2];
+ int count = 2;
+ std::vector<byte> data = pkt.data();
+ EXPECT_EQ(ARES_SUCCESS, ares_parse_a_reply(data.data(), (int)data.size(),
+ &host, info, &count));
+ EXPECT_EQ(0, count);
+ ASSERT_NE(nullptr, host);
+ std::stringstream ss;
+ ss << HostEnt(host);
+ EXPECT_EQ("{'other.mit.edu' aliases=[mit.edu] addrs=[]}", ss.str());
+ ares_free_hostent(host);
+}
+
+TEST_F(LibraryTest, ParseAReplyVariantCname) {
+ DNSPacket pkt;
+ pkt.set_qid(6366).set_rd().set_ra()
+ .add_question(new DNSQuestion("query.example.com", T_A))
+ .add_answer(new DNSCnameRR("query.example.com", 200, "redirect.query.example.com"))
+ .add_answer(new DNSARR("redirect.query.example.com", 300, {129,97,123,22}))
+ .add_auth(new DNSNsRR("example.com", 218, "aa.ns1.example.com"))
+ .add_auth(new DNSNsRR("example.com", 218, "ns2.example.com"))
+ .add_auth(new DNSNsRR("example.com", 218, "ns3.example.com"))
+ .add_auth(new DNSNsRR("example.com", 218, "ns4.example.com"))
+ .add_additional(new DNSARR("aa.ns1.example.com", 218, {129,97,1,1}))
+ .add_additional(new DNSARR("ns2.example.com", 218, {129,97,1,2}))
+ .add_additional(new DNSARR("ns3.example.com", 218, {129,97,1,3}))
+ .add_additional(new DNSARR("ns4.example.com", 218, {129,97,1,4}));
+ struct hostent *host = nullptr;
+ struct ares_addrttl info[2];
+ int count = 2;
+ std::vector<byte> data = pkt.data();
+ EXPECT_EQ(ARES_SUCCESS, ares_parse_a_reply(data.data(), (int)data.size(),
+ &host, info, &count));
+ EXPECT_EQ(1, count);
+ EXPECT_EQ("129.97.123.22", AddressToString(&(info[0].ipaddr), 4));
+ // TTL is reduced to match CNAME's.
+ EXPECT_EQ(200, info[0].ttl);
+ ares_free_hostent(host);
+
+ // Repeat parsing without places to put the results.
+ count = 0;
+ EXPECT_EQ(ARES_SUCCESS, ares_parse_a_reply(data.data(), (int)data.size(),
+ nullptr, info, &count));
+}
+
+TEST_F(LibraryTest, ParseAReplyVariantCnameChain) {
+ DNSPacket pkt;
+ pkt.set_qid(6366).set_rd().set_ra()
+ .add_question(new DNSQuestion("c1.localhost", T_A))
+ .add_answer(new DNSCnameRR("c1.localhost", 604800, "c2.localhost"))
+ .add_answer(new DNSCnameRR("c2.localhost", 604800, "c3.localhost"))
+ .add_answer(new DNSCnameRR("c3.localhost", 604800, "c4.localhost"))
+ .add_answer(new DNSARR("c4.localhost", 604800, {8,8,8,8}))
+ .add_auth(new DNSNsRR("localhost", 604800, "localhost"))
+ .add_additional(new DNSARR("localhost", 604800, {127,0,0,1}))
+ .add_additional(new DNSAaaaRR("localhost", 604800,
+ {0x7F, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00,
+ 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x01}));
+ struct hostent *host = nullptr;
+ struct ares_addrttl info[2];
+ int count = 2;
+ std::vector<byte> data = pkt.data();
+ EXPECT_EQ(ARES_SUCCESS, ares_parse_a_reply(data.data(), (int)data.size(),
+ &host, info, &count));
+ EXPECT_EQ(1, count);
+ EXPECT_EQ("8.8.8.8", AddressToString(&(info[0].ipaddr), 4));
+ EXPECT_EQ(604800, info[0].ttl);
+ ares_free_hostent(host);
+}
+
+TEST_F(LibraryTest, DISABLED_ParseAReplyVariantCnameLast) {
+ DNSPacket pkt;
+ pkt.set_qid(6366).set_rd().set_ra()
+ .add_question(new DNSQuestion("query.example.com", T_A))
+ .add_answer(new DNSARR("redirect.query.example.com", 300, {129,97,123,221}))
+ .add_answer(new DNSARR("redirect.query.example.com", 300, {129,97,123,222}))
+ .add_answer(new DNSARR("redirect.query.example.com", 300, {129,97,123,223}))
+ .add_answer(new DNSARR("redirect.query.example.com", 300, {129,97,123,224}))
+ .add_answer(new DNSCnameRR("query.example.com", 60, "redirect.query.example.com"))
+ .add_additional(new DNSTxtRR("query.example.com", 60, {"text record"}));
+ struct hostent *host = nullptr;
+ struct ares_addrttl info[8];
+ int count = 8;
+ std::vector<byte> data = pkt.data();
+ EXPECT_EQ(ARES_SUCCESS, ares_parse_a_reply(data.data(), (int)data.size(),
+ &host, info, &count));
+ EXPECT_EQ(4, count);
+ EXPECT_EQ("129.97.123.221", AddressToString(&(info[0].ipaddr), 4));
+ EXPECT_EQ("129.97.123.222", AddressToString(&(info[1].ipaddr), 4));
+ EXPECT_EQ("129.97.123.223", AddressToString(&(info[2].ipaddr), 4));
+ EXPECT_EQ("129.97.123.224", AddressToString(&(info[3].ipaddr), 4));
+ EXPECT_EQ(300, info[0].ttl);
+ EXPECT_EQ(300, info[1].ttl);
+ EXPECT_EQ(300, info[2].ttl);
+ EXPECT_EQ(300, info[3].ttl);
+ ares_free_hostent(host);
+}
+
+TEST_F(LibraryTest, ParseAReplyErrors) {
+ DNSPacket pkt;
+ pkt.set_qid(0x1234).set_response().set_aa()
+ .add_question(new DNSQuestion("example.com", T_A))
+ .add_answer(new DNSARR("example.com", 100, {0x02, 0x03, 0x04, 0x05}));
+ std::vector<byte> data;
+
+ struct hostent *host = nullptr;
+ struct ares_addrttl info[2];
+ int count = 2;
+
+ // No question.
+ pkt.questions_.clear();
+ data = pkt.data();
+ EXPECT_EQ(ARES_EBADRESP, ares_parse_a_reply(data.data(), (int)data.size(),
+ &host, info, &count));
+ EXPECT_EQ(nullptr, host);
+ pkt.add_question(new DNSQuestion("example.com", T_A));
+
+ // Question != answer
+ pkt.questions_.clear();
+ pkt.add_question(new DNSQuestion("Axample.com", T_A));
+ data = pkt.data();
+ EXPECT_EQ(ARES_ENODATA, ares_parse_a_reply(data.data(), (int)data.size(),
+ &host, info, &count));
+ EXPECT_EQ(nullptr, host);
+ pkt.questions_.clear();
+ pkt.add_question(new DNSQuestion("example.com", T_A));
+
+#ifdef DISABLED
+ // Not a response.
+ pkt.set_response(false);
+ data = pkt.data();
+ EXPECT_EQ(ARES_EBADRESP, ares_parse_a_reply(data.data(), (int)data.size(),
+ &host, info, &count));
+ EXPECT_EQ(nullptr, host);
+ pkt.set_response(true);
+
+ // Bad return code.
+ pkt.set_rcode(FORMERR);
+ data = pkt.data();
+ EXPECT_EQ(ARES_ENODATA, ares_parse_a_reply(data.data(), (int)data.size(),
+ &host, info, &count));
+ EXPECT_EQ(nullptr, host);
+ pkt.set_rcode(NOERROR);
+#endif
+
+ // Two questions
+ pkt.add_question(new DNSQuestion("example.com", T_A));
+ data = pkt.data();
+ EXPECT_EQ(ARES_EBADRESP, ares_parse_a_reply(data.data(), (int)data.size(),
+ &host, info, &count));
+ EXPECT_EQ(nullptr, host);
+ pkt.questions_.clear();
+ pkt.add_question(new DNSQuestion("example.com", T_A));
+
+ // Wrong sort of answer.
+ pkt.answers_.clear();
+ pkt.add_answer(new DNSMxRR("example.com", 100, 100, "mx1.example.com"));
+ data = pkt.data();
+ EXPECT_EQ(ARES_ENODATA, ares_parse_a_reply(data.data(), (int)data.size(),
+ &host, info, &count));
+ EXPECT_EQ(nullptr, host);
+ pkt.answers_.clear();
+ pkt.add_answer(new DNSARR("example.com", 100, {0x02, 0x03, 0x04, 0x05}));
+
+ // No answer.
+ pkt.answers_.clear();
+ data = pkt.data();
+ EXPECT_EQ(ARES_ENODATA, ares_parse_a_reply(data.data(), (int)data.size(),
+ &host, info, &count));
+ EXPECT_EQ(nullptr, host);
+ pkt.add_answer(new DNSARR("example.com", 100, {0x02, 0x03, 0x04, 0x05}));
+
+ // Truncated packets.
+ data = pkt.data();
+ for (size_t len = 1; len < data.size(); len++) {
+ EXPECT_EQ(ARES_EBADRESP, ares_parse_a_reply(data.data(), (int)len,
+ &host, info, &count));
+ EXPECT_EQ(nullptr, host);
+ EXPECT_EQ(ARES_EBADRESP, ares_parse_a_reply(data.data(), (int)len,
+ nullptr, info, &count));
+ }
+}
+
+TEST_F(LibraryTest, ParseAReplyAllocFail) {
+ DNSPacket pkt;
+ pkt.set_qid(0x1234).set_response().set_aa()
+ .add_question(new DNSQuestion("example.com", T_A))
+ .add_answer(new DNSCnameRR("example.com", 300, "c.example.com"))
+ .add_answer(new DNSARR("c.example.com", 500, {0x02, 0x03, 0x04, 0x05}));
+ std::vector<byte> data = pkt.data();
+
+ struct hostent *host = nullptr;
+ struct ares_addrttl info[2];
+ int count = 2;
+
+ for (int ii = 1; ii <= 8; ii++) {
+ ClearFails();
+ SetAllocFail(ii);
+ EXPECT_EQ(ARES_ENOMEM, ares_parse_a_reply(data.data(), (int)data.size(),
+ &host, info, &count)) << ii;
+ EXPECT_EQ(nullptr, host);
+ }
+}
+
+} // namespace test
+} // namespace ares
diff --git a/subprojects/c-ares/test/ares-test-parse-aaaa.cc b/subprojects/c-ares/test/ares-test-parse-aaaa.cc
@@ -0,0 +1,209 @@
+/*
+ * Copyright (C) The c-ares project
+ *
+ * Permission to use, copy, modify, and distribute this
+ * software and its documentation for any purpose and without
+ * fee is hereby granted, provided that the above copyright
+ * notice appear in all copies and that both that copyright
+ * notice and this permission notice appear in supporting
+ * documentation, and that the name of M.I.T. not be used in
+ * advertising or publicity pertaining to distribution of the
+ * software without specific, written prior permission.
+ * M.I.T. makes no representations about the suitability of
+ * this software for any purpose. It is provided "as is"
+ * without express or implied warranty.
+ *
+ * SPDX-License-Identifier: MIT
+ */
+#include "ares-test.h"
+#include "dns-proto.h"
+
+#include <sstream>
+#include <vector>
+
+namespace ares {
+namespace test {
+
+TEST_F(LibraryTest, ParseAaaaReplyOK) {
+ DNSPacket pkt;
+ pkt.set_qid(0x1234).set_response().set_aa()
+ .add_question(new DNSQuestion("example.com", T_AAAA))
+ .add_answer(new DNSAaaaRR("example.com", 100,
+ {0x01, 0x01, 0x01, 0x01, 0x02, 0x02, 0x02, 0x02,
+ 0x03, 0x03, 0x03, 0x03, 0x04, 0x04, 0x04, 0x04}))
+ .add_answer(new DNSARR("example.com", 0x01020304, {2,3,4,5}));
+ std::vector<byte> data = pkt.data();
+ struct hostent *host = nullptr;
+ struct ares_addr6ttl info[5];
+ int count = 5;
+ EXPECT_EQ(ARES_SUCCESS, ares_parse_aaaa_reply(data.data(), (int)data.size(),
+ &host, info, &count));
+ EXPECT_EQ(1, count);
+ EXPECT_EQ(100, info[0].ttl);
+ EXPECT_EQ(0x01, info[0].ip6addr._S6_un._S6_u8[0]);
+ EXPECT_EQ(0x02, info[0].ip6addr._S6_un._S6_u8[4]);
+ ASSERT_NE(nullptr, host);
+ std::stringstream ss;
+ ss << HostEnt(host);
+ EXPECT_EQ("{'example.com' aliases=[] addrs=[0101:0101:0202:0202:0303:0303:0404:0404]}", ss.str());
+ ares_free_hostent(host);
+
+ // Repeat without providing places to put the results
+ count = 0;
+ EXPECT_EQ(ARES_SUCCESS, ares_parse_aaaa_reply(data.data(), (int)data.size(),
+ nullptr, info, &count));
+}
+
+TEST_F(LibraryTest, ParseAaaaReplyCname) {
+ DNSPacket pkt;
+ pkt.set_qid(0x1234).set_response().set_aa()
+ .add_question(new DNSQuestion("example.com", T_AAAA))
+ .add_answer(new DNSCnameRR("example.com", 50, "c.example.com"))
+ .add_answer(new DNSAaaaRR("c.example.com", 100,
+ {0x01, 0x01, 0x01, 0x01, 0x02, 0x02, 0x02, 0x02,
+ 0x03, 0x03, 0x03, 0x03, 0x04, 0x04, 0x04, 0x04}));
+ std::vector<byte> data = pkt.data();
+ struct hostent *host = nullptr;
+ struct ares_addr6ttl info[5];
+ int count = 5;
+ EXPECT_EQ(ARES_SUCCESS, ares_parse_aaaa_reply(data.data(), (int)data.size(),
+ &host, info, &count));
+ EXPECT_EQ(1, count);
+ // CNAME TTL overrides AAAA TTL.
+ EXPECT_EQ(50, info[0].ttl);
+ EXPECT_EQ(0x01, info[0].ip6addr._S6_un._S6_u8[0]);
+ EXPECT_EQ(0x02, info[0].ip6addr._S6_un._S6_u8[4]);
+ ASSERT_NE(nullptr, host);
+ std::stringstream ss;
+ ss << HostEnt(host);
+ EXPECT_EQ("{'c.example.com' aliases=[example.com] addrs=[0101:0101:0202:0202:0303:0303:0404:0404]}", ss.str());
+ ares_free_hostent(host);
+
+ // Repeat without providing a hostent
+ count = 5;
+ EXPECT_EQ(ARES_SUCCESS, ares_parse_aaaa_reply(data.data(), (int)data.size(),
+ nullptr, info, &count));
+ EXPECT_EQ(1, count);
+ EXPECT_EQ(50, info[0].ttl);
+ EXPECT_EQ(0x01, info[0].ip6addr._S6_un._S6_u8[0]);
+ EXPECT_EQ(0x02, info[0].ip6addr._S6_un._S6_u8[4]);
+}
+
+TEST_F(LibraryTest, ParseAaaaReplyNoData) {
+ DNSPacket pkt;
+ pkt.set_qid(0x1234).set_response().set_aa()
+ .add_question(new DNSQuestion("example.com", T_AAAA));
+ std::vector<byte> data = pkt.data();
+ struct hostent *host = nullptr;
+ struct ares_addr6ttl info[2];
+ int count = 2;
+ EXPECT_EQ(ARES_ENODATA, ares_parse_aaaa_reply(data.data(), (int)data.size(),
+ &host, info, &count));
+ EXPECT_EQ(0, count);
+ EXPECT_EQ(nullptr, host);
+
+ // Again but with a CNAME.
+ pkt.add_answer(new DNSCnameRR("example.com", 200, "c.example.com"));
+ EXPECT_EQ(ARES_ENODATA, ares_parse_aaaa_reply(data.data(), (int)data.size(),
+ &host, info, &count));
+ EXPECT_EQ(0, count);
+ EXPECT_EQ(nullptr, host);
+}
+
+TEST_F(LibraryTest, ParseAaaaReplyErrors) {
+ DNSPacket pkt;
+ pkt.set_qid(0x1234).set_response().set_aa()
+ .add_question(new DNSQuestion("example.com", T_AAAA))
+ .add_answer(new DNSAaaaRR("example.com", 100,
+ {0x01, 0x01, 0x01, 0x01, 0x02, 0x02, 0x02, 0x02,
+ 0x03, 0x03, 0x03, 0x03, 0x04, 0x04, 0x04, 0x04}));
+ std::vector<byte> data;
+
+ struct hostent *host = nullptr;
+ struct ares_addr6ttl info[2];
+ int count = 2;
+
+ // No question.
+ pkt.questions_.clear();
+ data = pkt.data();
+ EXPECT_EQ(ARES_EBADRESP, ares_parse_aaaa_reply(data.data(), (int)data.size(),
+ &host, info, &count));
+ EXPECT_EQ(nullptr, host);
+ pkt.add_question(new DNSQuestion("example.com", T_AAAA));
+
+ // Question != answer
+ pkt.questions_.clear();
+ pkt.add_question(new DNSQuestion("Axample.com", T_AAAA));
+ data = pkt.data();
+ EXPECT_EQ(ARES_ENODATA, ares_parse_aaaa_reply(data.data(), (int)data.size(),
+ &host, info, &count));
+ EXPECT_EQ(nullptr, host);
+ pkt.questions_.clear();
+ pkt.add_question(new DNSQuestion("example.com", T_AAAA));
+
+ // Two questions.
+ pkt.add_question(new DNSQuestion("example.com", T_AAAA));
+ data = pkt.data();
+ EXPECT_EQ(ARES_EBADRESP, ares_parse_aaaa_reply(data.data(), (int)data.size(),
+ &host, info, &count));
+ EXPECT_EQ(nullptr, host);
+ pkt.questions_.clear();
+ pkt.add_question(new DNSQuestion("example.com", T_AAAA));
+
+ // Wrong sort of answer.
+ pkt.answers_.clear();
+ pkt.add_answer(new DNSMxRR("example.com", 100, 100, "mx1.example.com"));
+ data = pkt.data();
+ EXPECT_EQ(ARES_ENODATA, ares_parse_aaaa_reply(data.data(), (int)data.size(),
+ &host, info, &count));
+ EXPECT_EQ(nullptr, host);
+ pkt.answers_.clear();
+ pkt.add_answer(new DNSAaaaRR("example.com", 100,
+ {0x01, 0x01, 0x01, 0x01, 0x02, 0x02, 0x02, 0x02,
+ 0x03, 0x03, 0x03, 0x03, 0x04, 0x04, 0x04, 0x04}));
+
+ // No answer.
+ pkt.answers_.clear();
+ data = pkt.data();
+ EXPECT_EQ(ARES_ENODATA, ares_parse_aaaa_reply(data.data(), (int)data.size(),
+ &host, info, &count));
+ EXPECT_EQ(nullptr, host);
+ pkt.add_answer(new DNSAaaaRR("example.com", 100,
+ {0x01, 0x01, 0x01, 0x01, 0x02, 0x02, 0x02, 0x02,
+ 0x03, 0x03, 0x03, 0x03, 0x04, 0x04, 0x04, 0x04}));
+
+ // Truncated packets.
+ data = pkt.data();
+ for (size_t len = 1; len < data.size(); len++) {
+ EXPECT_EQ(ARES_EBADRESP, ares_parse_aaaa_reply(data.data(), (int)len,
+ &host, info, &count));
+ EXPECT_EQ(nullptr, host);
+ EXPECT_EQ(ARES_EBADRESP, ares_parse_aaaa_reply(data.data(), (int)len,
+ nullptr, info, &count));
+ }
+}
+
+TEST_F(LibraryTest, ParseAaaaReplyAllocFail) {
+ DNSPacket pkt;
+ pkt.set_qid(0x1234).set_response().set_aa()
+ .add_question(new DNSQuestion("example.com", T_AAAA))
+ .add_answer(new DNSCnameRR("example.com", 300, "c.example.com"))
+ .add_answer(new DNSAaaaRR("c.example.com", 100,
+ {0x01, 0x01, 0x01, 0x01, 0x02, 0x02, 0x02, 0x02,
+ 0x03, 0x03, 0x03, 0x03, 0x04, 0x04, 0x04, 0x04}));
+ std::vector<byte> data = pkt.data();
+ struct hostent *host = nullptr;
+ struct ares_addr6ttl info[2];
+ int count = 2;
+
+ for (int ii = 1; ii <= 8; ii++) {
+ ClearFails();
+ SetAllocFail(ii);
+ EXPECT_EQ(ARES_ENOMEM, ares_parse_aaaa_reply(data.data(), (int)data.size(),
+ &host, info, &count)) << ii;
+ EXPECT_EQ(nullptr, host);
+ }
+}
+
+} // namespace test
+} // namespace ares
diff --git a/subprojects/c-ares/test/ares-test-parse-caa.cc b/subprojects/c-ares/test/ares-test-parse-caa.cc
@@ -0,0 +1,130 @@
+/*
+ * Copyright (C) The c-ares project
+ *
+ * Permission to use, copy, modify, and distribute this
+ * software and its documentation for any purpose and without
+ * fee is hereby granted, provided that the above copyright
+ * notice appear in all copies and that both that copyright
+ * notice and this permission notice appear in supporting
+ * documentation, and that the name of M.I.T. not be used in
+ * advertising or publicity pertaining to distribution of the
+ * software without specific, written prior permission.
+ * M.I.T. makes no representations about the suitability of
+ * this software for any purpose. It is provided "as is"
+ * without express or implied warranty.
+ *
+ * SPDX-License-Identifier: MIT
+ */
+#include "ares-test.h"
+#include "dns-proto.h"
+
+#include <sstream>
+#include <vector>
+
+namespace ares {
+namespace test {
+
+TEST_F(LibraryTest, ParseCaaReplyMultipleOK) {
+ std::vector<byte> data = {
+ 0x27, 0x86, 0x81, 0x80, 0x00, 0x01, 0x00, 0x04, 0x00, 0x00, 0x00, 0x00, 0x09, 0x77, 0x69, 0x6B, // '............wik
+ 0x69, 0x70, 0x65, 0x64, 0x69, 0x61, 0x03, 0x6F, 0x72, 0x67, 0x00, 0x01, 0x01, 0x00, 0x01, 0xC0, // ipedia.org......
+ 0x0C, 0x01, 0x01, 0x00, 0x01, 0x00, 0x00, 0x02, 0x23, 0x00, 0x15, 0x00, 0x05, 0x69, 0x73, 0x73, // ........#....iss
+ 0x75, 0x65, 0x67, 0x6C, 0x6F, 0x62, 0x61, 0x6C, 0x73, 0x69, 0x67, 0x6E, 0x2E, 0x63, 0x6F, 0x6D, // ueglobalsign.com
+ 0xC0, 0x0C, 0x01, 0x01, 0x00, 0x01, 0x00, 0x00, 0x02, 0x23, 0x00, 0x13, 0x00, 0x05, 0x69, 0x73, // .........#....is
+ 0x73, 0x75, 0x65, 0x64, 0x69, 0x67, 0x69, 0x63, 0x65, 0x72, 0x74, 0x2E, 0x63, 0x6F, 0x6D, 0xC0, // suedigicert.com.
+ 0x0C, 0x01, 0x01, 0x00, 0x01, 0x00, 0x00, 0x02, 0x23, 0x00, 0x16, 0x00, 0x05, 0x69, 0x73, 0x73, // ........#....iss
+ 0x75, 0x65, 0x6C, 0x65, 0x74, 0x73, 0x65, 0x6E, 0x63, 0x72, 0x79, 0x70, 0x74, 0x2E, 0x6F, 0x72, // ueletsencrypt.or
+ 0x67, 0xC0, 0x0C, 0x01, 0x01, 0x00, 0x01, 0x00, 0x00, 0x02, 0x23, 0x00, 0x25, 0x00, 0x05, 0x69, // g.........#.%..i
+ 0x6F, 0x64, 0x65, 0x66, 0x6D, 0x61, 0x69, 0x6C, 0x74, 0x6F, 0x3A, 0x64, 0x6E, 0x73, 0x2D, 0x61, // odefmailto:dns-a
+ 0x64, 0x6D, 0x69, 0x6E, 0x40, 0x77, 0x69, 0x6B, 0x69, 0x6D, 0x65, 0x64, 0x69, 0x61, 0x2E, 0x6F, // dmin@wikimedia.o
+ 0x72, 0x67 // rg
+ };
+
+ struct ares_caa_reply* caa = nullptr;
+ EXPECT_EQ(ARES_SUCCESS, ares_parse_caa_reply(data.data(), (int)data.size(), &caa));
+ ASSERT_NE(nullptr, caa);
+ ASSERT_NE(nullptr, caa->next);
+ ASSERT_NE(nullptr, caa->next->next);
+ ASSERT_NE(nullptr, caa->next->next->next);
+
+ ares_free_data(caa);
+}
+
+TEST_F(LibraryTest, ParseCaaReplySingleOK) {
+ std::vector<byte> data = {
+ 0x27, 0x86, 0x81, 0x80, 0x00, 0x01, 0x00, 0x01, 0x00, 0x00, 0x00, 0x00, 0x06, 0x67, 0x6F, 0x6F, // '............goo
+ 0x67, 0x6C, 0x65, 0x03, 0x63, 0x6F, 0x6D, 0x00, 0x01, 0x01, 0x00, 0x01, 0xC0, 0x0C, 0x01, 0x01, // gle.com.........
+ 0x00, 0x01, 0x00, 0x01, 0x43, 0xBE, 0x00, 0x0F, 0x00, 0x05, 0x69, 0x73, 0x73, 0x75, 0x65, 0x70, // ....C.....issuep
+ 0x6B, 0x69, 0x2E, 0x67, 0x6F, 0x6F, 0x67 // ki.goog
+ };
+
+ struct ares_caa_reply* caa = nullptr;
+ EXPECT_EQ(ARES_SUCCESS, ares_parse_caa_reply(data.data(), (int)data.size(), &caa));
+ ASSERT_NE(nullptr, caa);
+
+ EXPECT_EQ(caa->critical, (int)0);
+ EXPECT_EQ(caa->plength, (size_t)5);
+ EXPECT_STREQ((char *)caa->property, "issue");
+ EXPECT_EQ(caa->length, (size_t)8);
+ EXPECT_STREQ((char *)caa->value, "pki.goog");
+
+ ares_free_data(caa);
+}
+
+TEST_F(LibraryTest, ParseCaaBogusReply1) {
+ std::vector<byte> data = {
+ 0x27, 0x86, 0x81, 0x80, 0x00, 0x01, 0x00, 0x01, 0x00, 0x00, 0x00, 0x00, 0x06, 0x67, 0x6F, 0x6F, // '............goo
+ 0x67, 0x6C, 0x65, 0x03, 0x63, 0x6F, 0x6D, 0x00, 0x01, 0x01, 0x00, 0x01, 0xC0, 0x0C, 0x01, 0x01, // gle.com.........
+ 0x00, 0x01, 0x00, 0x01, 0x43, 0xBE, 0x00, 0x0F, 0x00, 0x00, 0x69, 0x73, 0x73, 0x75, 0x65, 0x70, // ....C.....issuep
+ 0x6B, 0x69, 0x2E, 0x67, 0x6F, 0x6F, 0x67 // ki.goog
+ };
+
+ struct ares_caa_reply* caa = nullptr;
+ EXPECT_EQ(ARES_EBADRESP, ares_parse_caa_reply(data.data(), (int)data.size(), &caa));
+ ASSERT_EQ(nullptr, caa);
+}
+
+TEST_F(LibraryTest, ParseCaaBogusReply2) {
+ std::vector<byte> data = {
+ 0x27, 0x86, 0x81, 0x80, 0x00, 0x01, 0x00, 0x01, 0x00, 0x00, 0x00, 0x00, 0x06, 0x67, 0x6F, 0x6F, // '............goo
+ 0x67, 0x6C, 0x65, 0x03, 0x63, 0x6F, 0x6D, 0x00, 0x01, 0x01, 0x00, 0x01, 0xC0, 0x0C, 0x01, 0x01, // gle.com.........
+ 0x00, 0x01, 0x00, 0x01, 0x43, 0xBE, 0x00, 0x0F, 0x00, 0x0e, 0x69, 0x73, 0x73, 0x75, 0x65, 0x70, // ....C.....issuep
+ 0x6B, 0x69, 0x2E, 0x67, 0x6F, 0x6F, 0x67 // ki.goog
+ };
+
+ struct ares_caa_reply* caa = nullptr;
+ EXPECT_EQ(ARES_EBADRESP, ares_parse_caa_reply(data.data(), (int)data.size(), &caa));
+ ASSERT_EQ(nullptr, caa);
+}
+
+TEST_F(LibraryTest, ParseCaaBogusReply3) {
+ std::vector<byte> data = {
+ 0x27, 0x86, 0x81, 0x80, 0x00, 0x01, 0x00, 0x01, 0x00, 0x00, 0x00, 0x00, 0x06, 0x67, 0x6F, 0x6F, // '............goo
+ 0x67, 0x6C, 0x65, 0x03, 0x63, 0x6F, 0x6D, 0x00, 0x01, 0x01, 0x00, 0x01, 0xC0, 0x0C, 0x01, 0x01, // gle.com.........
+ 0x00, 0x01, 0x00, 0x01, 0x43, 0xBE, 0x00, 0x10, 0x00, 0x05, 0x69, 0x73, 0x73, 0x75, 0x65, 0x70, // ....C.....issuep
+ 0x6B, 0x69, 0x2E, 0x67, 0x6F, 0x6F, 0x67 // ki.goog
+ };
+
+ struct ares_caa_reply* caa = nullptr;
+ EXPECT_EQ(ARES_EBADRESP, ares_parse_caa_reply(data.data(), (int)data.size(), &caa));
+ ASSERT_EQ(nullptr, caa);
+}
+
+TEST_F(LibraryTest, ParseCaaEmptyReply) {
+ std::vector<byte> data = {
+ 0x27, 0x86, 0x81, 0x80, 0x00, 0x01, 0x00, 0x00, 0x00, 0x01, 0x00, 0x00, 0x09, 0x77, 0x69, 0x6B, // '............wik
+ 0x69, 0x70, 0x65, 0x64, 0x69, 0x61, 0x02, 0x64, 0x65, 0x00, 0x01, 0x01, 0x00, 0x01, 0xC0, 0x0C, // ipedia.de.......
+ 0x00, 0x06, 0x00, 0x01, 0x00, 0x00, 0x02, 0x58, 0x00, 0x3B, 0x04, 0x6E, 0x73, 0x38, 0x31, 0x0D, // .......X.;.ns81.
+ 0x64, 0x6F, 0x6D, 0x61, 0x69, 0x6E, 0x63, 0x6F, 0x6E, 0x74, 0x72, 0x6F, 0x6C, 0x03, 0x63, 0x6F, // domaincontrol.co
+ 0x6D, 0x00, 0x03, 0x64, 0x6E, 0x73, 0x05, 0x6A, 0x6F, 0x6D, 0x61, 0x78, 0x03, 0x6E, 0x65, 0x74, // m..dns.jomax.net
+ 0x00, 0x78, 0x67, 0xFE, 0x34, 0x00, 0x00, 0x70, 0x80, 0x00, 0x00, 0x1C, 0x20, 0x00, 0x09, 0x3A, // .xg.4..p.... ..:
+ 0x80, 0x00, 0x00, 0x02, 0x58 // ....X
+ };
+
+ struct ares_caa_reply* caa = nullptr;
+ EXPECT_EQ(ARES_ENODATA, ares_parse_caa_reply(data.data(), (int)data.size(), &caa));
+ ASSERT_EQ(nullptr, caa);
+}
+
+} // namespace test
+} // namespace ares
diff --git a/subprojects/c-ares/test/ares-test-parse-mx.cc b/subprojects/c-ares/test/ares-test-parse-mx.cc
@@ -0,0 +1,158 @@
+/*
+ * Copyright (C) The c-ares project
+ *
+ * Permission to use, copy, modify, and distribute this
+ * software and its documentation for any purpose and without
+ * fee is hereby granted, provided that the above copyright
+ * notice appear in all copies and that both that copyright
+ * notice and this permission notice appear in supporting
+ * documentation, and that the name of M.I.T. not be used in
+ * advertising or publicity pertaining to distribution of the
+ * software without specific, written prior permission.
+ * M.I.T. makes no representations about the suitability of
+ * this software for any purpose. It is provided "as is"
+ * without express or implied warranty.
+ *
+ * SPDX-License-Identifier: MIT
+ */
+#include "ares-test.h"
+#include "dns-proto.h"
+
+#include <sstream>
+#include <vector>
+
+namespace ares {
+namespace test {
+
+TEST_F(LibraryTest, ParseMxReplyOK) {
+ DNSPacket pkt;
+ pkt.set_qid(0x1234).set_response().set_aa()
+ .add_question(new DNSQuestion("example.com", T_MX))
+ .add_answer(new DNSMxRR("example.com", 100, 100, "mx1.example.com"))
+ .add_answer(new DNSMxRR("example.com", 100, 200, "mx2.example.com"));
+ std::vector<byte> data = pkt.data();
+
+ struct ares_mx_reply* mx = nullptr;
+ EXPECT_EQ(ARES_SUCCESS, ares_parse_mx_reply(data.data(), (int)data.size(), &mx));
+ ASSERT_NE(nullptr, mx);
+ EXPECT_EQ("mx1.example.com", std::string(mx->host));
+ EXPECT_EQ(100, mx->priority);
+
+ struct ares_mx_reply* mx2 = mx->next;
+ ASSERT_NE(nullptr, mx2);
+ EXPECT_EQ("mx2.example.com", std::string(mx2->host));
+ EXPECT_EQ(200, mx2->priority);
+ EXPECT_EQ(nullptr, mx2->next);
+
+ ares_free_data(mx);
+}
+
+TEST_F(LibraryTest, ParseMxReplyMalformed) {
+ std::vector<byte> data = {
+ 0x12, 0x34, // qid
+ 0x84, // response + query + AA + not-TC + not-RD
+ 0x00, // not-RA + not-Z + not-AD + not-CD + rc=NoError
+ 0x00, 0x01, // num questions
+ 0x00, 0x01, // num answer RRs
+ 0x00, 0x00, // num authority RRs
+ 0x00, 0x00, // num additional RRs
+ // Question
+ 0x07, 'e', 'x', 'a', 'm', 'p', 'l', 'e',
+ 0x03, 'c', 'o', 'm',
+ 0x00,
+ 0x00, 0x0F, // type MX
+ 0x00, 0x01, // class IN
+ // Answer 1
+ 0x07, 'e', 'x', 'a', 'm', 'p', 'l', 'e',
+ 0x03, 'c', 'o', 'm',
+ 0x00,
+ 0x00, 0x0F, // RR type
+ 0x00, 0x01, // class IN
+ 0x01, 0x02, 0x03, 0x04, // TTL
+ 0x00, 0x01, // rdata length -- too short
+ 0x02,
+ };
+
+ struct ares_mx_reply* mx = nullptr;
+ EXPECT_EQ(ARES_EBADRESP, ares_parse_mx_reply(data.data(), (int)data.size(), &mx));
+ ASSERT_EQ(nullptr, mx);
+}
+
+
+TEST_F(LibraryTest, ParseMxReplyErrors) {
+ DNSPacket pkt;
+ pkt.set_qid(0x1234).set_response().set_aa()
+ .add_question(new DNSQuestion("example.com", T_MX))
+ .add_answer(new DNSMxRR("example.com", 100, 100, "mx1.example.com"));
+ std::vector<byte> data;
+ struct ares_mx_reply* mx = nullptr;
+
+ // No question.
+ pkt.questions_.clear();
+ data = pkt.data();
+ EXPECT_EQ(ARES_EBADRESP, ares_parse_mx_reply(data.data(), (int)data.size(), &mx));
+ EXPECT_EQ(nullptr, mx);
+ pkt.add_question(new DNSQuestion("example.com", T_MX));
+
+#ifdef DISABLED
+ // Question != answer
+ pkt.questions_.clear();
+ pkt.add_question(new DNSQuestion("Axample.com", T_MX));
+ data = pkt.data();
+ EXPECT_EQ(ARES_EBADRESP, ares_parse_mx_reply(data.data(), (int)data.size(), &mx));
+ pkt.questions_.clear();
+ pkt.add_question(new DNSQuestion("example.com", T_MX));
+#endif
+
+ // Two questions.
+ pkt.add_question(new DNSQuestion("example.com", T_MX));
+ data = pkt.data();
+ EXPECT_EQ(ARES_EBADRESP, ares_parse_mx_reply(data.data(), (int)data.size(), &mx));
+ EXPECT_EQ(nullptr, mx);
+ pkt.questions_.clear();
+ pkt.add_question(new DNSQuestion("example.com", T_MX));
+
+ // Wrong sort of answer.
+ // TODO(drysdale): check if this should be ARES_ENODATA?
+ pkt.answers_.clear();
+ pkt.add_answer(new DNSSrvRR("example.abc.def.com", 180, 0, 10, 8160, "example.abc.def.com"));
+ data = pkt.data();
+ EXPECT_EQ(ARES_SUCCESS, ares_parse_mx_reply(data.data(), (int)data.size(), &mx));
+ EXPECT_EQ(nullptr, mx);
+ pkt.answers_.clear();
+ pkt.add_answer(new DNSMxRR("example.com", 100, 100, "mx1.example.com"));
+
+ // No answer.
+ pkt.answers_.clear();
+ data = pkt.data();
+ EXPECT_EQ(ARES_ENODATA, ares_parse_mx_reply(data.data(), (int)data.size(), &mx));
+ EXPECT_EQ(nullptr, mx);
+ pkt.add_answer(new DNSMxRR("example.com", 100, 100, "mx1.example.com"));
+
+ // Truncated packets.
+ data = pkt.data();
+ for (size_t len = 1; len < data.size(); len++) {
+ int rc = ares_parse_mx_reply(data.data(), (int)len, &mx);
+ EXPECT_EQ(nullptr, mx);
+ EXPECT_TRUE(rc == ARES_EBADRESP || rc == ARES_EBADNAME);
+ }
+}
+
+TEST_F(LibraryTest, ParseMxReplyAllocFail) {
+ DNSPacket pkt;
+ pkt.set_qid(0x1234).set_response().set_aa()
+ .add_question(new DNSQuestion("example.com", T_MX))
+ .add_answer(new DNSCnameRR("example.com", 300, "c.example.com"))
+ .add_answer(new DNSMxRR("c.example.com", 100, 100, "mx1.example.com"));
+ std::vector<byte> data = pkt.data();
+ struct ares_mx_reply* mx = nullptr;
+
+ for (int ii = 1; ii <= 5; ii++) {
+ ClearFails();
+ SetAllocFail(ii);
+ EXPECT_EQ(ARES_ENOMEM, ares_parse_mx_reply(data.data(), (int)data.size(), &mx)) << ii;
+ }
+}
+
+} // namespace test
+} // namespace ares
diff --git a/subprojects/c-ares/test/ares-test-parse-naptr.cc b/subprojects/c-ares/test/ares-test-parse-naptr.cc
@@ -0,0 +1,165 @@
+/*
+ * Copyright (C) The c-ares project
+ *
+ * Permission to use, copy, modify, and distribute this
+ * software and its documentation for any purpose and without
+ * fee is hereby granted, provided that the above copyright
+ * notice appear in all copies and that both that copyright
+ * notice and this permission notice appear in supporting
+ * documentation, and that the name of M.I.T. not be used in
+ * advertising or publicity pertaining to distribution of the
+ * software without specific, written prior permission.
+ * M.I.T. makes no representations about the suitability of
+ * this software for any purpose. It is provided "as is"
+ * without express or implied warranty.
+ *
+ * SPDX-License-Identifier: MIT
+ */
+#include "ares-test.h"
+#include "dns-proto.h"
+
+#include <sstream>
+#include <vector>
+
+namespace ares {
+namespace test {
+
+TEST_F(LibraryTest, ParseNaptrReplyOK) {
+ DNSPacket pkt;
+ pkt.set_qid(0x1234).set_response().set_aa()
+ .add_question(new DNSQuestion("example.com", T_NAPTR))
+ .add_answer(new DNSNaptrRR("example.com", 100,
+ 10, 20, "SP", "service", "regexp", "replace"))
+ .add_answer(new DNSNaptrRR("example.com", 0x0010,
+ 11, 21, "SP", "service2", "regexp2", "replace2"));
+ std::vector<byte> data = pkt.data();
+
+ struct ares_naptr_reply* naptr = nullptr;
+ EXPECT_EQ(ARES_SUCCESS, ares_parse_naptr_reply(data.data(), (int)data.size(), &naptr));
+ ASSERT_NE(nullptr, naptr);
+ EXPECT_EQ("SP", std::string((char*)naptr->flags));
+ EXPECT_EQ("service", std::string((char*)naptr->service));
+ EXPECT_EQ("regexp", std::string((char*)naptr->regexp));
+ EXPECT_EQ("replace", std::string((char*)naptr->replacement));
+ EXPECT_EQ(10, naptr->order);
+ EXPECT_EQ(20, naptr->preference);
+
+ struct ares_naptr_reply* naptr2 = naptr->next;
+ ASSERT_NE(nullptr, naptr2);
+ EXPECT_EQ("SP", std::string((char*)naptr2->flags));
+ EXPECT_EQ("service2", std::string((char*)naptr2->service));
+ EXPECT_EQ("regexp2", std::string((char*)naptr2->regexp));
+ EXPECT_EQ("replace2", std::string((char*)naptr2->replacement));
+ EXPECT_EQ(11, naptr2->order);
+ EXPECT_EQ(21, naptr2->preference);
+ EXPECT_EQ(nullptr, naptr2->next);
+
+ ares_free_data(naptr);
+}
+
+TEST_F(LibraryTest, ParseNaptrReplyErrors) {
+ DNSPacket pkt;
+ pkt.set_qid(0x1234).set_response().set_aa()
+ .add_question(new DNSQuestion("example.com", T_NAPTR))
+ .add_answer(new DNSNaptrRR("example.com", 100,
+ 10, 20, "SP", "service", "regexp", "replace"));
+ std::vector<byte> data;
+ struct ares_naptr_reply* naptr = nullptr;
+
+ // No question.
+ pkt.questions_.clear();
+ data = pkt.data();
+ EXPECT_EQ(ARES_EBADRESP, ares_parse_naptr_reply(data.data(), (int)data.size(), &naptr));
+ pkt.add_question(new DNSQuestion("example.com", T_NAPTR));
+
+#ifdef DISABLED
+ // Question != answer
+ pkt.questions_.clear();
+ pkt.add_question(new DNSQuestion("Axample.com", T_NAPTR));
+ data = pkt.data();
+ EXPECT_EQ(ARES_ENODATA, ares_parse_naptr_reply(data.data(), (int)data.size(), &naptr));
+ pkt.questions_.clear();
+ pkt.add_question(new DNSQuestion("example.com", T_NAPTR));
+#endif
+
+ // Two questions
+ pkt.add_question(new DNSQuestion("example.com", T_NAPTR));
+ data = pkt.data();
+ EXPECT_EQ(ARES_EBADRESP, ares_parse_naptr_reply(data.data(), (int)data.size(), &naptr));
+ pkt.questions_.clear();
+ pkt.add_question(new DNSQuestion("example.com", T_NAPTR));
+
+ // Wrong sort of answer.
+ pkt.answers_.clear();
+ pkt.add_answer(new DNSMxRR("example.com", 100, 100, "mx1.example.com"));
+ data = pkt.data();
+ EXPECT_EQ(ARES_SUCCESS, ares_parse_naptr_reply(data.data(), (int)data.size(), &naptr));
+ EXPECT_EQ(nullptr, naptr);
+ pkt.answers_.clear();
+ pkt.add_answer(new DNSNaptrRR("example.com", 100,
+ 10, 20, "SP", "service", "regexp", "replace"));
+
+ // No answer.
+ pkt.answers_.clear();
+ data = pkt.data();
+ EXPECT_EQ(ARES_ENODATA, ares_parse_naptr_reply(data.data(), (int)data.size(), &naptr));
+ pkt.add_answer(new DNSNaptrRR("example.com", 100,
+ 10, 20, "SP", "service", "regexp", "replace"));
+
+ // Truncated packets.
+ data = pkt.data();
+ for (size_t len = 1; len < data.size(); len++) {
+ int rc = ares_parse_naptr_reply(data.data(), (int)len, &naptr);
+ EXPECT_TRUE(rc == ARES_EBADRESP || rc == ARES_EBADNAME);
+ }
+}
+
+TEST_F(LibraryTest, ParseNaptrReplyTooShort) {
+ std::vector<byte> data = {
+ 0x12, 0x34, // qid
+ 0x84, // response + query + AA + not-TC + not-RD
+ 0x00, // not-RA + not-Z + not-AD + not-CD + rc=NoError
+ 0x00, 0x01, // num questions
+ 0x00, 0x01, // num answer RRs
+ 0x00, 0x00, // num authority RRs
+ 0x00, 0x00, // num additional RRs
+ // Question
+ 0x07, 'e', 'x', 'a', 'm', 'p', 'l', 'e',
+ 0x03, 'c', 'o', 'm',
+ 0x00,
+ 0x00, 0x23, // type NAPTR
+ 0x00, 0x01, // class IN
+ // Answer 1
+ 0x07, 'e', 'x', 'a', 'm', 'p', 'l', 'e',
+ 0x03, 'c', 'o', 'm',
+ 0x00,
+ 0x00, 0x23, // RR type
+ 0x00, 0x01, // class IN
+ 0x01, 0x02, 0x03, 0x04, // TTL
+ 0x00, 0x01, // rdata length
+ 0x00, // Too short: expect 2 x int16 and 3 x name (min 1 byte each)
+ };
+ struct ares_naptr_reply* naptr = nullptr;
+ EXPECT_EQ(ARES_EBADRESP, ares_parse_naptr_reply(data.data(), (int)data.size(), &naptr));
+}
+
+TEST_F(LibraryTest, ParseNaptrReplyAllocFail) {
+ DNSPacket pkt;
+ pkt.set_qid(0x1234).set_response().set_aa()
+ .add_question(new DNSQuestion("example.com", T_NAPTR))
+ .add_answer(new DNSNaptrRR("example.com", 100,
+ 10, 20, "SP", "service", "regexp", "replace"))
+ .add_answer(new DNSNaptrRR("example.com", 0x0010,
+ 11, 21, "SP", "service2", "regexp2", "replace2"));
+ std::vector<byte> data = pkt.data();
+ struct ares_naptr_reply* naptr = nullptr;
+
+ for (int ii = 1; ii <= 13; ii++) {
+ ClearFails();
+ SetAllocFail(ii);
+ EXPECT_EQ(ARES_ENOMEM, ares_parse_naptr_reply(data.data(), (int)data.size(), &naptr));
+ }
+}
+
+} // namespace test
+} // namespace ares
diff --git a/subprojects/c-ares/test/ares-test-parse-ns.cc b/subprojects/c-ares/test/ares-test-parse-ns.cc
@@ -0,0 +1,136 @@
+/*
+ * Copyright (C) The c-ares project
+ *
+ * Permission to use, copy, modify, and distribute this
+ * software and its documentation for any purpose and without
+ * fee is hereby granted, provided that the above copyright
+ * notice appear in all copies and that both that copyright
+ * notice and this permission notice appear in supporting
+ * documentation, and that the name of M.I.T. not be used in
+ * advertising or publicity pertaining to distribution of the
+ * software without specific, written prior permission.
+ * M.I.T. makes no representations about the suitability of
+ * this software for any purpose. It is provided "as is"
+ * without express or implied warranty.
+ *
+ * SPDX-License-Identifier: MIT
+ */
+#include "ares-test.h"
+#include "dns-proto.h"
+
+#include <sstream>
+#include <vector>
+
+namespace ares {
+namespace test {
+
+TEST_F(LibraryTest, ParseNsReplyOK) {
+ DNSPacket pkt;
+ pkt.set_qid(0x1234).set_response().set_aa()
+ .add_question(new DNSQuestion("example.com", T_NS))
+ .add_answer(new DNSNsRR("example.com", 100, "ns.example.com"));
+ std::vector<byte> data = pkt.data();
+
+ struct hostent *host = nullptr;
+ EXPECT_EQ(ARES_SUCCESS, ares_parse_ns_reply(data.data(), (int)data.size(), &host));
+ ASSERT_NE(nullptr, host);
+ std::stringstream ss;
+ ss << HostEnt(host);
+ EXPECT_EQ("{'example.com' aliases=[ns.example.com] addrs=[]}", ss.str());
+ ares_free_hostent(host);
+}
+
+TEST_F(LibraryTest, ParseNsReplyMultiple) {
+ DNSPacket pkt;
+ pkt.set_qid(10501).set_response().set_rd().set_ra()
+ .add_question(new DNSQuestion("google.com", T_NS))
+ .add_answer(new DNSNsRR("google.com", 59, "ns1.google.com"))
+ .add_answer(new DNSNsRR("google.com", 59, "ns2.google.com"))
+ .add_answer(new DNSNsRR("google.com", 59, "ns3.google.com"))
+ .add_answer(new DNSNsRR("google.com", 59, "ns4.google.com"))
+ .add_additional(new DNSARR("ns4.google.com", 247, {216,239,38,10}))
+ .add_additional(new DNSARR("ns2.google.com", 247, {216,239,34,10}))
+ .add_additional(new DNSARR("ns1.google.com", 247, {216,239,32,10}))
+ .add_additional(new DNSARR("ns3.google.com", 247, {216,239,36,10}));
+ std::vector<byte> data = pkt.data();
+
+ struct hostent *host = nullptr;
+ EXPECT_EQ(ARES_SUCCESS, ares_parse_ns_reply(data.data(), (int)data.size(), &host));
+ ASSERT_NE(nullptr, host);
+ std::stringstream ss;
+ ss << HostEnt(host);
+ EXPECT_EQ("{'google.com' aliases=[ns1.google.com, ns2.google.com, ns3.google.com, ns4.google.com] addrs=[]}", ss.str());
+ ares_free_hostent(host);
+}
+
+TEST_F(LibraryTest, ParseNsReplyErrors) {
+ DNSPacket pkt;
+ pkt.set_qid(0x1234).set_response().set_aa()
+ .add_question(new DNSQuestion("example.com", T_NS))
+ .add_answer(new DNSNsRR("example.com", 100, "ns.example.com"));
+ std::vector<byte> data;
+ struct hostent *host = nullptr;
+
+ // No question.
+ pkt.questions_.clear();
+ data = pkt.data();
+ EXPECT_EQ(ARES_EBADRESP, ares_parse_ns_reply(data.data(), (int)data.size(), &host));
+ pkt.add_question(new DNSQuestion("example.com", T_NS));
+
+#ifdef DISABLED
+ // Question != answer
+ pkt.questions_.clear();
+ pkt.add_question(new DNSQuestion("Axample.com", T_NS));
+ data = pkt.data();
+ EXPECT_EQ(ARES_ENODATA, ares_parse_ns_reply(data.data(), (int)data.size(), &host));
+ pkt.questions_.clear();
+ pkt.add_question(new DNSQuestion("example.com", T_NS));
+#endif
+
+ // Two questions.
+ pkt.add_question(new DNSQuestion("example.com", T_NS));
+ data = pkt.data();
+ EXPECT_EQ(ARES_EBADRESP, ares_parse_ns_reply(data.data(), (int)data.size(), &host));
+ pkt.questions_.clear();
+ pkt.add_question(new DNSQuestion("example.com", T_NS));
+
+ // Wrong sort of answer.
+ pkt.answers_.clear();
+ pkt.add_answer(new DNSMxRR("example.com", 100, 100, "mx1.example.com"));
+ data = pkt.data();
+ EXPECT_EQ(ARES_ENODATA, ares_parse_ns_reply(data.data(), (int)data.size(), &host));
+ pkt.answers_.clear();
+ pkt.add_answer(new DNSNsRR("example.com", 100, "ns.example.com"));
+
+ // No answer.
+ pkt.answers_.clear();
+ data = pkt.data();
+ EXPECT_EQ(ARES_ENODATA, ares_parse_ns_reply(data.data(), (int)data.size(), &host));
+ pkt.add_answer(new DNSNsRR("example.com", 100, "ns.example.com"));
+
+ // Truncated packets.
+ data = pkt.data();
+ for (size_t len = 1; len < data.size(); len++) {
+ EXPECT_EQ(ARES_EBADRESP, ares_parse_ns_reply(data.data(), (int)len, &host));
+ }
+}
+
+TEST_F(LibraryTest, ParseNsReplyAllocFail) {
+ DNSPacket pkt;
+ pkt.set_qid(0x1234).set_response().set_aa()
+ .add_question(new DNSQuestion("example.com", T_NS))
+ .add_answer(new DNSCnameRR("example.com", 300, "c.example.com"))
+ .add_answer(new DNSNsRR("c.example.com", 100, "ns.example.com"));
+ std::vector<byte> data = pkt.data();
+ struct hostent *host = nullptr;
+
+ for (int ii = 1; ii <= 8; ii++) {
+ ClearFails();
+ SetAllocFail(ii);
+ EXPECT_EQ(ARES_ENOMEM, ares_parse_ns_reply(data.data(), (int)data.size(), &host)) << ii;
+ }
+}
+
+
+} // namespace test
+} // namespace ares
diff --git a/subprojects/c-ares/test/ares-test-parse-ptr.cc b/subprojects/c-ares/test/ares-test-parse-ptr.cc
@@ -0,0 +1,266 @@
+/*
+ * Copyright (C) The c-ares project
+ *
+ * Permission to use, copy, modify, and distribute this
+ * software and its documentation for any purpose and without
+ * fee is hereby granted, provided that the above copyright
+ * notice appear in all copies and that both that copyright
+ * notice and this permission notice appear in supporting
+ * documentation, and that the name of M.I.T. not be used in
+ * advertising or publicity pertaining to distribution of the
+ * software without specific, written prior permission.
+ * M.I.T. makes no representations about the suitability of
+ * this software for any purpose. It is provided "as is"
+ * without express or implied warranty.
+ *
+ * SPDX-License-Identifier: MIT
+ */
+#include "ares-test.h"
+#include "dns-proto.h"
+
+#include <sstream>
+#include <vector>
+
+namespace ares {
+namespace test {
+
+TEST_F(LibraryTest, ParsePtrReplyOK) {
+ byte addrv4[4] = {0x10, 0x20, 0x30, 0x40};
+ DNSPacket pkt;
+ pkt.set_qid(0x1234).set_response().set_aa()
+ .add_question(new DNSQuestion("64.48.32.16.in-addr.arpa", T_PTR))
+ .add_answer(new DNSPtrRR("64.48.32.16.in-addr.arpa", 100, "other.com"));
+ std::vector<byte> data = pkt.data();
+
+ struct hostent *host = nullptr;
+ EXPECT_EQ(ARES_SUCCESS, ares_parse_ptr_reply(data.data(), (int)data.size(),
+ addrv4, sizeof(addrv4), AF_INET, &host));
+ ASSERT_NE(nullptr, host);
+ std::stringstream ss;
+ ss << HostEnt(host);
+ EXPECT_EQ("{'other.com' aliases=[other.com] addrs=[16.32.48.64]}", ss.str());
+ ares_free_hostent(host);
+}
+
+TEST_F(LibraryTest, ParsePtrReplyCname) {
+ byte addrv4[4] = {0x10, 0x20, 0x30, 0x40};
+ DNSPacket pkt;
+ pkt.set_qid(0x1234).set_response().set_aa()
+ .add_question(new DNSQuestion("64.48.32.16.in-addr.arpa", T_PTR))
+ .add_answer(new DNSCnameRR("64.48.32.16.in-addr.arpa", 50, "64.48.32.8.in-addr.arpa"))
+ .add_answer(new DNSPtrRR("64.48.32.8.in-addr.arpa", 100, "other.com"));
+ std::vector<byte> data = pkt.data();
+
+ struct hostent *host = nullptr;
+ EXPECT_EQ(ARES_SUCCESS, ares_parse_ptr_reply(data.data(), (int)data.size(),
+ addrv4, sizeof(addrv4), AF_INET, &host));
+ ASSERT_NE(nullptr, host);
+ std::stringstream ss;
+ ss << HostEnt(host);
+ EXPECT_EQ("{'other.com' aliases=[other.com] addrs=[16.32.48.64]}", ss.str());
+ ares_free_hostent(host);
+}
+
+
+struct DNSMalformedCnameRR : public DNSCnameRR {
+ DNSMalformedCnameRR(const std::string& name, int ttl, const std::string& other)
+ : DNSCnameRR(name, ttl, other) {}
+ std::vector<byte> data() const {
+ std::vector<byte> data = DNSRR::data();
+ std::vector<byte> encname = EncodeString(other_);
+ encname[0] = encname[0] + 63; // invalid label length
+ int len = (int)encname.size();
+ PushInt16(&data, len);
+ data.insert(data.end(), encname.begin(), encname.end());
+ return data;
+ }
+};
+
+TEST_F(LibraryTest, ParsePtrReplyMalformedCname) {
+ byte addrv4[4] = {0x10, 0x20, 0x30, 0x40};
+ DNSPacket pkt;
+ pkt.set_qid(0x1234).set_response().set_aa()
+ .add_question(new DNSQuestion("64.48.32.16.in-addr.arpa", T_PTR))
+ .add_answer(new DNSMalformedCnameRR("64.48.32.16.in-addr.arpa", 50, "64.48.32.8.in-addr.arpa"))
+ .add_answer(new DNSPtrRR("64.48.32.8.in-addr.arpa", 100, "other.com"));
+ std::vector<byte> data = pkt.data();
+
+ struct hostent *host = nullptr;
+ EXPECT_EQ(ARES_EBADRESP, ares_parse_ptr_reply(data.data(), (int)data.size(),
+ addrv4, sizeof(addrv4), AF_INET, &host));
+ ASSERT_EQ(nullptr, host);
+}
+
+TEST_F(LibraryTest, ParseManyPtrReply) {
+ byte addrv4[4] = {0x10, 0x20, 0x30, 0x40};
+ DNSPacket pkt;
+ pkt.set_qid(0x1234).set_response().set_aa()
+ .add_question(new DNSQuestion("64.48.32.16.in-addr.arpa", T_PTR))
+ .add_answer(new DNSPtrRR("64.48.32.16.in-addr.arpa", 100, "main.com"))
+ .add_answer(new DNSPtrRR("64.48.32.16.in-addr.arpa", 100, "other1.com"))
+ .add_answer(new DNSPtrRR("64.48.32.16.in-addr.arpa", 100, "other2.com"))
+ .add_answer(new DNSPtrRR("64.48.32.16.in-addr.arpa", 100, "other3.com"))
+ .add_answer(new DNSPtrRR("64.48.32.16.in-addr.arpa", 100, "other4.com"))
+ .add_answer(new DNSPtrRR("64.48.32.16.in-addr.arpa", 100, "other5.com"))
+ .add_answer(new DNSPtrRR("64.48.32.16.in-addr.arpa", 100, "other6.com"))
+ .add_answer(new DNSPtrRR("64.48.32.16.in-addr.arpa", 100, "other7.com"))
+ .add_answer(new DNSPtrRR("64.48.32.16.in-addr.arpa", 100, "other8.com"))
+ .add_answer(new DNSPtrRR("64.48.32.16.in-addr.arpa", 100, "other9.com"));
+ std::vector<byte> data = pkt.data();
+
+ struct hostent *host = nullptr;
+ EXPECT_EQ(ARES_SUCCESS, ares_parse_ptr_reply(data.data(), (int)data.size(),
+ addrv4, sizeof(addrv4), AF_INET, &host));
+ ASSERT_NE(nullptr, host);
+ ares_free_hostent(host);
+}
+
+TEST_F(LibraryTest, ParsePtrReplyAdditional) {
+ byte addrv4[4] = {0x10, 0x20, 0x30, 0x40};
+ DNSPacket pkt;
+ pkt.set_qid(0x1234).set_response().set_aa()
+ .add_question(new DNSQuestion("64.48.32.16.in-addr.arpa", T_PTR))
+ .add_answer(new DNSPtrRR("64.48.32.16.in-addr.arpa", 55, "other.com"))
+ .add_auth(new DNSNsRR("16.in-addr.arpa", 234, "ns1.other.com"))
+ .add_auth(new DNSNsRR("16.in-addr.arpa", 234, "bb.ns2.other.com"))
+ .add_auth(new DNSNsRR("16.in-addr.arpa", 234, "ns3.other.com"))
+ .add_additional(new DNSARR("ns1.other.com", 229, {10,20,30,41}))
+ .add_additional(new DNSARR("bb.ns2.other.com", 229, {10,20,30,42}))
+ .add_additional(new DNSARR("ns3.other.com", 229, {10,20,30,43}));
+ std::vector<byte> data = pkt.data();
+
+ struct hostent *host = nullptr;
+ EXPECT_EQ(ARES_SUCCESS, ares_parse_ptr_reply(data.data(), (int)data.size(),
+ addrv4, sizeof(addrv4), AF_INET, &host));
+ ASSERT_NE(nullptr, host);
+ std::stringstream ss;
+ ss << HostEnt(host);
+ EXPECT_EQ("{'other.com' aliases=[other.com] addrs=[16.32.48.64]}", ss.str());
+ ares_free_hostent(host);
+}
+
+TEST_F(LibraryTest, ParsePtrReplyErrors) {
+ byte addrv4[4] = {0x10, 0x20, 0x30, 0x40};
+ DNSPacket pkt;
+ pkt.set_qid(0x1234).set_response().set_aa()
+ .add_question(new DNSQuestion("64.48.32.16.in-addr.arpa", T_PTR))
+ .add_answer(new DNSPtrRR("64.48.32.16.in-addr.arpa", 100, "other.com"));
+ std::vector<byte> data;
+ struct hostent *host = nullptr;
+
+ // No question.
+ pkt.questions_.clear();
+ data = pkt.data();
+ EXPECT_EQ(ARES_EBADRESP, ares_parse_ptr_reply(data.data(), (int)data.size(),
+ addrv4, sizeof(addrv4), AF_INET, &host));
+ pkt.add_question(new DNSQuestion("64.48.32.16.in-addr.arpa", T_PTR));
+
+ // Question != answer
+ pkt.questions_.clear();
+ pkt.add_question(new DNSQuestion("99.48.32.16.in-addr.arpa", T_PTR));
+ data = pkt.data();
+ EXPECT_EQ(ARES_ENODATA, ares_parse_ptr_reply(data.data(), (int)data.size(),
+ addrv4, sizeof(addrv4), AF_INET, &host));
+ EXPECT_EQ(nullptr, host);
+ pkt.questions_.clear();
+ pkt.add_question(new DNSQuestion("64.48.32.16.in-addr.arpa", T_PTR));
+
+ // Two questions.
+ pkt.add_question(new DNSQuestion("64.48.32.16.in-addr.arpa", T_PTR));
+ data = pkt.data();
+ EXPECT_EQ(ARES_EBADRESP, ares_parse_ptr_reply(data.data(), (int)data.size(),
+ addrv4, sizeof(addrv4), AF_INET, &host));
+ EXPECT_EQ(nullptr, host);
+ pkt.questions_.clear();
+ pkt.add_question(new DNSQuestion("64.48.32.16.in-addr.arpa", T_PTR));
+
+ // Wrong sort of answer.
+ pkt.answers_.clear();
+ pkt.add_answer(new DNSMxRR("example.com", 100, 100, "mx1.example.com"));
+ data = pkt.data();
+ EXPECT_EQ(ARES_ENODATA, ares_parse_ptr_reply(data.data(), (int)data.size(),
+ addrv4, sizeof(addrv4), AF_INET, &host));
+ EXPECT_EQ(nullptr, host);
+ pkt.answers_.clear();
+ pkt.add_answer(new DNSPtrRR("64.48.32.16.in-addr.arpa", 100, "other.com"));
+
+ // No answer.
+ pkt.answers_.clear();
+ data = pkt.data();
+ EXPECT_EQ(ARES_ENODATA, ares_parse_ptr_reply(data.data(), (int)data.size(),
+ addrv4, sizeof(addrv4), AF_INET, &host));
+ EXPECT_EQ(nullptr, host);
+ pkt.add_answer(new DNSPtrRR("64.48.32.16.in-addr.arpa", 100, "other.com"));
+
+ // Truncated packets.
+ data = pkt.data();
+ for (size_t len = 1; len < data.size(); len++) {
+ EXPECT_EQ(ARES_EBADRESP, ares_parse_ptr_reply(data.data(), (int)len,
+ addrv4, sizeof(addrv4), AF_INET, &host));
+ EXPECT_EQ(nullptr, host);
+ }
+
+ // Truncated packets with CNAME.
+ pkt.add_answer(new DNSCnameRR("64.48.32.16.in-addr.arpa", 50, "64.48.32.8.in-addr.arpa"));
+ data = pkt.data();
+ for (size_t len = 1; len < data.size(); len++) {
+ EXPECT_EQ(ARES_EBADRESP, ares_parse_ptr_reply(data.data(), (int)len,
+ addrv4, sizeof(addrv4), AF_INET, &host));
+ EXPECT_EQ(nullptr, host);
+ }
+}
+
+TEST_F(LibraryTest, ParsePtrReplyAllocFailSome) {
+ byte addrv4[4] = {0x10, 0x20, 0x30, 0x40};
+ DNSPacket pkt;
+ pkt.set_qid(0x1234).set_response().set_aa()
+ .add_question(new DNSQuestion("64.48.32.16.in-addr.arpa", T_PTR))
+ .add_answer(new DNSPtrRR("64.48.32.16.in-addr.arpa", 100, "main.com"))
+ .add_answer(new DNSPtrRR("64.48.32.16.in-addr.arpa", 100, "other1.com"))
+ .add_answer(new DNSPtrRR("64.48.32.16.in-addr.arpa", 100, "other2.com"))
+ .add_answer(new DNSPtrRR("64.48.32.16.in-addr.arpa", 100, "other3.com"));
+ std::vector<byte> data = pkt.data();
+ struct hostent *host = nullptr;
+
+ for (int ii = 1; ii <= 18; ii++) {
+ ClearFails();
+ SetAllocFail(ii);
+ EXPECT_EQ(ARES_ENOMEM, ares_parse_ptr_reply(data.data(), (int)data.size(),
+ addrv4, sizeof(addrv4), AF_INET, &host)) << ii;
+ }
+}
+
+TEST_F(LibraryTest, ParsePtrReplyAllocFailMany) {
+ byte addrv4[4] = {0x10, 0x20, 0x30, 0x40};
+ DNSPacket pkt;
+ pkt.set_qid(0x1234).set_response().set_aa()
+ .add_question(new DNSQuestion("64.48.32.16.in-addr.arpa", T_PTR))
+ .add_answer(new DNSPtrRR("64.48.32.16.in-addr.arpa", 100, "main.com"))
+ .add_answer(new DNSPtrRR("64.48.32.16.in-addr.arpa", 100, "other1.com"))
+ .add_answer(new DNSPtrRR("64.48.32.16.in-addr.arpa", 100, "other2.com"))
+ .add_answer(new DNSPtrRR("64.48.32.16.in-addr.arpa", 100, "other3.com"))
+ .add_answer(new DNSPtrRR("64.48.32.16.in-addr.arpa", 100, "other4.com"))
+ .add_answer(new DNSPtrRR("64.48.32.16.in-addr.arpa", 100, "other5.com"))
+ .add_answer(new DNSPtrRR("64.48.32.16.in-addr.arpa", 100, "other6.com"))
+ .add_answer(new DNSPtrRR("64.48.32.16.in-addr.arpa", 100, "other7.com"))
+ .add_answer(new DNSPtrRR("64.48.32.16.in-addr.arpa", 100, "other8.com"))
+ .add_answer(new DNSPtrRR("64.48.32.16.in-addr.arpa", 100, "other9.com"));
+ std::vector<byte> data = pkt.data();
+ struct hostent *host = nullptr;
+
+ for (int ii = 1; ii <= 63; ii++) {
+ ClearFails();
+ SetAllocFail(ii);
+ int rc = ares_parse_ptr_reply(data.data(), (int)data.size(),
+ addrv4, sizeof(addrv4), AF_INET, &host);
+ if (rc != ARES_ENOMEM) {
+ EXPECT_EQ(ARES_SUCCESS, rc);
+ ares_free_hostent(host);
+ host = nullptr;
+ }
+ }
+}
+
+
+} // namespace test
+} // namespace ares
diff --git a/subprojects/c-ares/test/ares-test-parse-soa-any.cc b/subprojects/c-ares/test/ares-test-parse-soa-any.cc
@@ -0,0 +1,128 @@
+/*
+ * Copyright (C) The c-ares project
+ *
+ * Permission to use, copy, modify, and distribute this
+ * software and its documentation for any purpose and without
+ * fee is hereby granted, provided that the above copyright
+ * notice appear in all copies and that both that copyright
+ * notice and this permission notice appear in supporting
+ * documentation, and that the name of M.I.T. not be used in
+ * advertising or publicity pertaining to distribution of the
+ * software without specific, written prior permission.
+ * M.I.T. makes no representations about the suitability of
+ * this software for any purpose. It is provided "as is"
+ * without express or implied warranty.
+ *
+ * SPDX-License-Identifier: MIT
+ */
+#include "ares-test.h"
+#include "dns-proto.h"
+
+#include <sstream>
+#include <vector>
+
+namespace ares {
+namespace test {
+
+TEST_F(LibraryTest, ParseSoaAnyReplyOK) {
+ DNSPacket pkt;
+ pkt.set_qid(0x1234).set_response().set_aa()
+ .add_question(new DNSQuestion("example.com", T_ANY))\
+ .add_answer(new DNSARR("example.com", 0x01020304, {2,3,4,5}))
+ .add_answer(new DNSMxRR("example.com", 100, 100, "mx1.example.com"))
+ .add_answer(new DNSMxRR("example.com", 100, 200, "mx2.example.com"))
+ .add_answer(new DNSSoaRR("example.com", 100,
+ "soa1.example.com", "fred.example.com",
+ 1, 2, 3, 4, 5));
+ std::vector<byte> data = pkt.data();
+
+ struct ares_soa_reply* soa = nullptr;
+ EXPECT_EQ(ARES_SUCCESS, ares_parse_soa_reply(data.data(), (int)data.size(), &soa));
+ ASSERT_NE(nullptr, soa);
+ EXPECT_EQ("soa1.example.com", std::string(soa->nsname));
+ EXPECT_EQ("fred.example.com", std::string(soa->hostmaster));
+ EXPECT_EQ((unsigned int)1, soa->serial);
+ EXPECT_EQ((unsigned int)2, soa->refresh);
+ EXPECT_EQ((unsigned int)3, soa->retry);
+ EXPECT_EQ((unsigned int)4, soa->expire);
+ EXPECT_EQ((unsigned int)5, soa->minttl);
+ ares_free_data(soa);
+}
+
+TEST_F(LibraryTest, ParseSoaAnyReplyErrors) {
+ DNSPacket pkt;
+ pkt.set_qid(0x1234).set_response().set_aa()
+ .add_question(new DNSQuestion("example.com", T_ANY))
+ .add_answer(new DNSSoaRR("example.com", 100,
+ "soa1.example.com", "fred.example.com",
+ 1, 2, 3, 4, 5));
+ std::vector<byte> data;
+ struct ares_soa_reply* soa = nullptr;
+
+ // No question.
+ pkt.questions_.clear();
+ data = pkt.data();
+ EXPECT_EQ(ARES_EBADRESP, ares_parse_soa_reply(data.data(), (int)data.size(), &soa));
+ pkt.add_question(new DNSQuestion("example.com", T_ANY));
+
+#ifdef DISABLED
+ // Question != answer
+ pkt.questions_.clear();
+ pkt.add_question(new DNSQuestion("Axample.com", T_ANY));
+ data = pkt.data();
+ EXPECT_EQ(ARES_EBADRESP, ares_parse_soa_reply(data.data(), (int)data.size(), &soa));
+ pkt.questions_.clear();
+ pkt.add_question(new DNSQuestion("example.com", T_ANY));
+#endif
+
+ // Two questions
+ pkt.add_question(new DNSQuestion("example.com", T_ANY));
+ data = pkt.data();
+ EXPECT_EQ(ARES_EBADRESP, ares_parse_soa_reply(data.data(), (int)data.size(), &soa));
+ pkt.questions_.clear();
+ pkt.add_question(new DNSQuestion("example.com", T_ANY));
+
+ // Wrong sort of answer.
+ pkt.answers_.clear();
+ pkt.add_answer(new DNSMxRR("example.com", 100, 100, "mx1.example.com"));
+ data = pkt.data();
+ EXPECT_EQ(ARES_EBADRESP, ares_parse_soa_reply(data.data(), (int)data.size(), &soa));
+ pkt.answers_.clear();
+ pkt.add_answer(new DNSSoaRR("example.com", 100,
+ "soa1.example.com", "fred.example.com",
+ 1, 2, 3, 4, 5));
+
+ // No answer.
+ pkt.answers_.clear();
+ data = pkt.data();
+ EXPECT_EQ(ARES_EBADRESP, ares_parse_soa_reply(data.data(), (int)data.size(), &soa));
+ pkt.add_answer(new DNSSoaRR("example.com", 100,
+ "soa1.example.com", "fred.example.com",
+ 1, 2, 3, 4, 5));
+
+ // Truncated packets.
+ data = pkt.data();
+ for (size_t len = 1; len < data.size(); len++) {
+ EXPECT_EQ(ARES_EBADRESP, ares_parse_soa_reply(data.data(), (int)len, &soa));
+ }
+}
+
+TEST_F(LibraryTest, ParseSoaAnyReplyAllocFail) {
+ DNSPacket pkt;
+ pkt.set_qid(0x1234).set_response().set_aa()
+ .add_question(new DNSQuestion("example.com", T_ANY))
+ .add_answer(new DNSSoaRR("example.com", 100,
+ "soa1.example.com", "fred.example.com",
+ 1, 2, 3, 4, 5));
+ std::vector<byte> data = pkt.data();
+ struct ares_soa_reply* soa = nullptr;
+
+ for (int ii = 1; ii <= 5; ii++) {
+ ClearFails();
+ SetAllocFail(ii);
+ EXPECT_EQ(ARES_ENOMEM, ares_parse_soa_reply(data.data(), (int)data.size(), &soa)) << ii;
+ }
+}
+
+} // namespace test
+} // namespace ares
diff --git a/subprojects/c-ares/test/ares-test-parse-soa.cc b/subprojects/c-ares/test/ares-test-parse-soa.cc
@@ -0,0 +1,125 @@
+/*
+ * Copyright (C) The c-ares project
+ *
+ * Permission to use, copy, modify, and distribute this
+ * software and its documentation for any purpose and without
+ * fee is hereby granted, provided that the above copyright
+ * notice appear in all copies and that both that copyright
+ * notice and this permission notice appear in supporting
+ * documentation, and that the name of M.I.T. not be used in
+ * advertising or publicity pertaining to distribution of the
+ * software without specific, written prior permission.
+ * M.I.T. makes no representations about the suitability of
+ * this software for any purpose. It is provided "as is"
+ * without express or implied warranty.
+ *
+ * SPDX-License-Identifier: MIT
+ */
+#include "ares-test.h"
+#include "dns-proto.h"
+
+#include <sstream>
+#include <vector>
+
+namespace ares {
+namespace test {
+
+TEST_F(LibraryTest, ParseSoaReplyOK) {
+ DNSPacket pkt;
+ pkt.set_qid(0x1234).set_response().set_aa()
+ .add_question(new DNSQuestion("example.com", T_SOA))
+ .add_answer(new DNSSoaRR("example.com", 100,
+ "soa1.example.com", "fred.example.com",
+ 1, 2, 3, 4, 5));
+ std::vector<byte> data = pkt.data();
+
+ struct ares_soa_reply* soa = nullptr;
+ EXPECT_EQ(ARES_SUCCESS, ares_parse_soa_reply(data.data(), (int)data.size(), &soa));
+ ASSERT_NE(nullptr, soa);
+ EXPECT_EQ("soa1.example.com", std::string(soa->nsname));
+ EXPECT_EQ("fred.example.com", std::string(soa->hostmaster));
+ EXPECT_EQ((unsigned int)1, soa->serial);
+ EXPECT_EQ((unsigned int)2, soa->refresh);
+ EXPECT_EQ((unsigned int)3, soa->retry);
+ EXPECT_EQ((unsigned int)4, soa->expire);
+ EXPECT_EQ((unsigned int)5, soa->minttl);
+ ares_free_data(soa);
+}
+
+TEST_F(LibraryTest, ParseSoaReplyErrors) {
+ DNSPacket pkt;
+ pkt.set_qid(0x1234).set_response().set_aa()
+ .add_question(new DNSQuestion("example.com", T_SOA))
+ .add_answer(new DNSSoaRR("example.com", 100,
+ "soa1.example.com", "fred.example.com",
+ 1, 2, 3, 4, 5));
+ std::vector<byte> data;
+ struct ares_soa_reply* soa = nullptr;
+
+ // No question.
+ pkt.questions_.clear();
+ data = pkt.data();
+ EXPECT_EQ(ARES_EBADRESP, ares_parse_soa_reply(data.data(), (int)data.size(), &soa));
+ pkt.add_question(new DNSQuestion("example.com", T_SOA));
+
+#ifdef DISABLED
+ // Question != answer
+ pkt.questions_.clear();
+ pkt.add_question(new DNSQuestion("Axample.com", T_SOA));
+ data = pkt.data();
+ EXPECT_EQ(ARES_EBADRESP, ares_parse_soa_reply(data.data(), (int)data.size(), &soa));
+ pkt.questions_.clear();
+ pkt.add_question(new DNSQuestion("example.com", T_SOA));
+#endif
+
+ // Two questions
+ pkt.add_question(new DNSQuestion("example.com", T_SOA));
+ data = pkt.data();
+ EXPECT_EQ(ARES_EBADRESP, ares_parse_soa_reply(data.data(), (int)data.size(), &soa));
+ pkt.questions_.clear();
+ pkt.add_question(new DNSQuestion("example.com", T_SOA));
+
+ // Wrong sort of answer.
+ pkt.answers_.clear();
+ pkt.add_answer(new DNSMxRR("example.com", 100, 100, "mx1.example.com"));
+ data = pkt.data();
+ EXPECT_EQ(ARES_EBADRESP, ares_parse_soa_reply(data.data(), (int)data.size(), &soa));
+ pkt.answers_.clear();
+ pkt.add_answer(new DNSSoaRR("example.com", 100,
+ "soa1.example.com", "fred.example.com",
+ 1, 2, 3, 4, 5));
+
+ // No answer.
+ pkt.answers_.clear();
+ data = pkt.data();
+ EXPECT_EQ(ARES_EBADRESP, ares_parse_soa_reply(data.data(), (int)data.size(), &soa));
+ pkt.add_answer(new DNSSoaRR("example.com", 100,
+ "soa1.example.com", "fred.example.com",
+ 1, 2, 3, 4, 5));
+
+ // Truncated packets.
+ data = pkt.data();
+ for (size_t len = 1; len < data.size(); len++) {
+ EXPECT_EQ(ARES_EBADRESP, ares_parse_soa_reply(data.data(), (int)len, &soa));
+ }
+}
+
+TEST_F(LibraryTest, ParseSoaReplyAllocFail) {
+ DNSPacket pkt;
+ pkt.set_qid(0x1234).set_response().set_aa()
+ .add_question(new DNSQuestion("example.com", T_SOA))
+ .add_answer(new DNSSoaRR("example.com", 100,
+ "soa1.example.com", "fred.example.com",
+ 1, 2, 3, 4, 5));
+ std::vector<byte> data = pkt.data();
+ struct ares_soa_reply* soa = nullptr;
+
+ for (int ii = 1; ii <= 5; ii++) {
+ ClearFails();
+ SetAllocFail(ii);
+ EXPECT_EQ(ARES_ENOMEM, ares_parse_soa_reply(data.data(), (int)data.size(), &soa)) << ii;
+ }
+}
+
+} // namespace test
+} // namespace ares
diff --git a/subprojects/c-ares/test/ares-test-parse-srv.cc b/subprojects/c-ares/test/ares-test-parse-srv.cc
@@ -0,0 +1,305 @@
+/*
+ * Copyright (C) The c-ares project
+ *
+ * Permission to use, copy, modify, and distribute this
+ * software and its documentation for any purpose and without
+ * fee is hereby granted, provided that the above copyright
+ * notice appear in all copies and that both that copyright
+ * notice and this permission notice appear in supporting
+ * documentation, and that the name of M.I.T. not be used in
+ * advertising or publicity pertaining to distribution of the
+ * software without specific, written prior permission.
+ * M.I.T. makes no representations about the suitability of
+ * this software for any purpose. It is provided "as is"
+ * without express or implied warranty.
+ *
+ * SPDX-License-Identifier: MIT
+ */
+#include "ares-test.h"
+#include "dns-proto.h"
+
+#include <sstream>
+#include <vector>
+
+namespace ares {
+namespace test {
+
+TEST_F(LibraryTest, ParseSrvReplyOK) {
+ DNSPacket pkt;
+ pkt.set_qid(0x1234).set_response().set_aa()
+ .add_question(new DNSQuestion("example.com", T_SRV))
+ .add_answer(new DNSSrvRR("example.com", 100, 10, 20, 30, "srv.example.com"))
+ .add_answer(new DNSSrvRR("example.com", 100, 11, 21, 31, "srv2.example.com"));
+ std::vector<byte> data = pkt.data();
+
+ struct ares_srv_reply* srv = nullptr;
+ EXPECT_EQ(ARES_SUCCESS, ares_parse_srv_reply(data.data(), (int)data.size(), &srv));
+ ASSERT_NE(nullptr, srv);
+
+ EXPECT_EQ("srv.example.com", std::string(srv->host));
+ EXPECT_EQ(10, srv->priority);
+ EXPECT_EQ(20, srv->weight);
+ EXPECT_EQ(30, srv->port);
+
+ struct ares_srv_reply* srv2 = srv->next;
+ ASSERT_NE(nullptr, srv2);
+ EXPECT_EQ("srv2.example.com", std::string(srv2->host));
+ EXPECT_EQ(11, srv2->priority);
+ EXPECT_EQ(21, srv2->weight);
+ EXPECT_EQ(31, srv2->port);
+ EXPECT_EQ(nullptr, srv2->next);
+
+ ares_free_data(srv);
+}
+
+TEST_F(LibraryTest, ParseSrvReplySingle) {
+ DNSPacket pkt;
+ pkt.set_qid(0x1234).set_response().set_aa()
+ .add_question(new DNSQuestion("example.abc.def.com", T_SRV))
+ .add_answer(new DNSSrvRR("example.abc.def.com", 180, 0, 10, 8160, "example.abc.def.com"))
+ .add_auth(new DNSNsRR("abc.def.com", 44, "else1.where.com"))
+ .add_auth(new DNSNsRR("abc.def.com", 44, "else2.where.com"))
+ .add_auth(new DNSNsRR("abc.def.com", 44, "else3.where.com"))
+ .add_auth(new DNSNsRR("abc.def.com", 44, "else4.where.com"))
+ .add_auth(new DNSNsRR("abc.def.com", 44, "else5.where.com"))
+ .add_additional(new DNSARR("else2.where.com", 42, {172,19,0,1}))
+ .add_additional(new DNSARR("else5.where.com", 42, {172,19,0,2}));
+ std::vector<byte> data = pkt.data();
+
+ struct ares_srv_reply* srv = nullptr;
+ EXPECT_EQ(ARES_SUCCESS, ares_parse_srv_reply(data.data(), (int)data.size(), &srv));
+ ASSERT_NE(nullptr, srv);
+
+ EXPECT_EQ("example.abc.def.com", std::string(srv->host));
+ EXPECT_EQ(0, srv->priority);
+ EXPECT_EQ(10, srv->weight);
+ EXPECT_EQ(8160, srv->port);
+ EXPECT_EQ(nullptr, srv->next);
+
+ ares_free_data(srv);
+}
+
+TEST_F(LibraryTest, ParseSrvReplyMalformed) {
+ std::vector<byte> data = {
+ 0x12, 0x34, // qid
+ 0x84, // response + query + AA + not-TC + not-RD
+ 0x00, // not-RA + not-Z + not-AD + not-CD + rc=NoError
+ 0x00, 0x01, // num questions
+ 0x00, 0x01, // num answer RRs
+ 0x00, 0x00, // num authority RRs
+ 0x00, 0x00, // num additional RRs
+ // Question
+ 0x07, 'e', 'x', 'a', 'm', 'p', 'l', 'e',
+ 0x03, 'c', 'o', 'm',
+ 0x00,
+ 0x00, 0x21, // type SRV
+ 0x00, 0x01, // class IN
+ // Answer 1
+ 0x07, 'e', 'x', 'a', 'm', 'p', 'l', 'e',
+ 0x03, 'c', 'o', 'm',
+ 0x00,
+ 0x00, 0x21, // RR type
+ 0x00, 0x01, // class IN
+ 0x01, 0x02, 0x03, 0x04, // TTL
+ 0x00, 0x04, // rdata length -- too short
+ 0x02, 0x03, 0x04, 0x05,
+ };
+
+ struct ares_srv_reply* srv = nullptr;
+ EXPECT_EQ(ARES_EBADRESP, ares_parse_srv_reply(data.data(), (int)data.size(), &srv));
+ ASSERT_EQ(nullptr, srv);
+}
+
+TEST_F(LibraryTest, ParseSrvReplyMultiple) {
+ DNSPacket pkt;
+ pkt.set_qid(0x1234).set_response().set_ra().set_rd()
+ .add_question(new DNSQuestion("srv.example.com", T_SRV))
+ .add_answer(new DNSSrvRR("srv.example.com", 300, 0, 5, 6789, "a1.srv.example.com"))
+ .add_answer(new DNSSrvRR("srv.example.com", 300, 0, 5, 4567, "a2.srv.example.com"))
+ .add_answer(new DNSSrvRR("srv.example.com", 300, 0, 5, 5678, "a3.srv.example.com"))
+ .add_auth(new DNSNsRR("example.com", 300, "ns1.example.com"))
+ .add_auth(new DNSNsRR("example.com", 300, "ns2.example.com"))
+ .add_auth(new DNSNsRR("example.com", 300, "ns3.example.com"))
+ .add_additional(new DNSARR("a1.srv.example.com", 300, {172,19,1,1}))
+ .add_additional(new DNSARR("a2.srv.example.com", 300, {172,19,1,2}))
+ .add_additional(new DNSARR("a3.srv.example.com", 300, {172,19,1,3}))
+ .add_additional(new DNSARR("n1.example.com", 300, {172,19,0,1}))
+ .add_additional(new DNSARR("n2.example.com", 300, {172,19,0,2}))
+ .add_additional(new DNSARR("n3.example.com", 300, {172,19,0,3}));
+ std::vector<byte> data = pkt.data();
+
+ struct ares_srv_reply* srv0 = nullptr;
+ EXPECT_EQ(ARES_SUCCESS, ares_parse_srv_reply(data.data(), (int)data.size(), &srv0));
+ ASSERT_NE(nullptr, srv0);
+ struct ares_srv_reply* srv = srv0;
+
+ EXPECT_EQ("a1.srv.example.com", std::string(srv->host));
+ EXPECT_EQ(0, srv->priority);
+ EXPECT_EQ(5, srv->weight);
+ EXPECT_EQ(6789, srv->port);
+ EXPECT_NE(nullptr, srv->next);
+ srv = srv->next;
+
+ EXPECT_EQ("a2.srv.example.com", std::string(srv->host));
+ EXPECT_EQ(0, srv->priority);
+ EXPECT_EQ(5, srv->weight);
+ EXPECT_EQ(4567, srv->port);
+ EXPECT_NE(nullptr, srv->next);
+ srv = srv->next;
+
+ EXPECT_EQ("a3.srv.example.com", std::string(srv->host));
+ EXPECT_EQ(0, srv->priority);
+ EXPECT_EQ(5, srv->weight);
+ EXPECT_EQ(5678, srv->port);
+ EXPECT_EQ(nullptr, srv->next);
+
+ ares_free_data(srv0);
+}
+
+TEST_F(LibraryTest, ParseSrvReplyCname) {
+ DNSPacket pkt;
+ pkt.set_qid(0x1234).set_response().set_aa()
+ .add_question(new DNSQuestion("example.abc.def.com", T_SRV))
+ .add_answer(new DNSCnameRR("example.abc.def.com", 300, "cname.abc.def.com"))
+ .add_answer(new DNSSrvRR("cname.abc.def.com", 300, 0, 10, 1234, "srv.abc.def.com"))
+ .add_auth(new DNSNsRR("abc.def.com", 44, "else1.where.com"))
+ .add_auth(new DNSNsRR("abc.def.com", 44, "else2.where.com"))
+ .add_auth(new DNSNsRR("abc.def.com", 44, "else3.where.com"))
+ .add_additional(new DNSARR("example.abc.def.com", 300, {172,19,0,1}))
+ .add_additional(new DNSARR("else1.where.com", 42, {172,19,0,1}))
+ .add_additional(new DNSARR("else2.where.com", 42, {172,19,0,2}))
+ .add_additional(new DNSARR("else3.where.com", 42, {172,19,0,3}));
+ std::vector<byte> data = pkt.data();
+
+ struct ares_srv_reply* srv = nullptr;
+ EXPECT_EQ(ARES_SUCCESS, ares_parse_srv_reply(data.data(), (int)data.size(), &srv));
+ ASSERT_NE(nullptr, srv);
+
+ EXPECT_EQ("srv.abc.def.com", std::string(srv->host));
+ EXPECT_EQ(0, srv->priority);
+ EXPECT_EQ(10, srv->weight);
+ EXPECT_EQ(1234, srv->port);
+ EXPECT_EQ(nullptr, srv->next);
+
+ ares_free_data(srv);
+}
+
+TEST_F(LibraryTest, ParseSrvReplyCnameMultiple) {
+ DNSPacket pkt;
+ pkt.set_qid(0x1234).set_response().set_ra().set_rd()
+ .add_question(new DNSQuestion("query.example.com", T_SRV))
+ .add_answer(new DNSCnameRR("query.example.com", 300, "srv.example.com"))
+ .add_answer(new DNSSrvRR("srv.example.com", 300, 0, 5, 6789, "a1.srv.example.com"))
+ .add_answer(new DNSSrvRR("srv.example.com", 300, 0, 5, 4567, "a2.srv.example.com"))
+ .add_answer(new DNSSrvRR("srv.example.com", 300, 0, 5, 5678, "a3.srv.example.com"))
+ .add_auth(new DNSNsRR("example.com", 300, "ns1.example.com"))
+ .add_auth(new DNSNsRR("example.com", 300, "ns2.example.com"))
+ .add_auth(new DNSNsRR("example.com", 300, "ns3.example.com"))
+ .add_additional(new DNSARR("a1.srv.example.com", 300, {172,19,1,1}))
+ .add_additional(new DNSARR("a2.srv.example.com", 300, {172,19,1,2}))
+ .add_additional(new DNSARR("a3.srv.example.com", 300, {172,19,1,3}))
+ .add_additional(new DNSARR("n1.example.com", 300, {172,19,0,1}))
+ .add_additional(new DNSARR("n2.example.com", 300, {172,19,0,2}))
+ .add_additional(new DNSARR("n3.example.com", 300, {172,19,0,3}));
+ std::vector<byte> data = pkt.data();
+
+ struct ares_srv_reply* srv0 = nullptr;
+ EXPECT_EQ(ARES_SUCCESS, ares_parse_srv_reply(data.data(), (int)data.size(), &srv0));
+ ASSERT_NE(nullptr, srv0);
+ struct ares_srv_reply* srv = srv0;
+
+ EXPECT_EQ("a1.srv.example.com", std::string(srv->host));
+ EXPECT_EQ(0, srv->priority);
+ EXPECT_EQ(5, srv->weight);
+ EXPECT_EQ(6789, srv->port);
+ EXPECT_NE(nullptr, srv->next);
+ srv = srv->next;
+
+ EXPECT_EQ("a2.srv.example.com", std::string(srv->host));
+ EXPECT_EQ(0, srv->priority);
+ EXPECT_EQ(5, srv->weight);
+ EXPECT_EQ(4567, srv->port);
+ EXPECT_NE(nullptr, srv->next);
+ srv = srv->next;
+
+ EXPECT_EQ("a3.srv.example.com", std::string(srv->host));
+ EXPECT_EQ(0, srv->priority);
+ EXPECT_EQ(5, srv->weight);
+ EXPECT_EQ(5678, srv->port);
+ EXPECT_EQ(nullptr, srv->next);
+
+ ares_free_data(srv0);
+}
+
+TEST_F(LibraryTest, ParseSrvReplyErrors) {
+ DNSPacket pkt;
+ pkt.set_qid(0x1234).set_response().set_aa()
+ .add_question(new DNSQuestion("example.abc.def.com", T_SRV))
+ .add_answer(new DNSSrvRR("example.abc.def.com", 180, 0, 10, 8160, "example.abc.def.com"));
+ std::vector<byte> data;
+ struct ares_srv_reply* srv = nullptr;
+
+ // No question.
+ pkt.questions_.clear();
+ data = pkt.data();
+ EXPECT_EQ(ARES_EBADRESP, ares_parse_srv_reply(data.data(), (int)data.size(), &srv));
+ pkt.add_question(new DNSQuestion("example.abc.def.com", T_SRV));
+
+#ifdef DISABLED
+ // Question != answer
+ pkt.questions_.clear();
+ pkt.add_question(new DNSQuestion("Axample.com", T_SRV));
+ data = pkt.data();
+ EXPECT_EQ(ARES_ENODATA, ares_parse_srv_reply(data.data(), (int)data.size(), &srv));
+ pkt.questions_.clear();
+ pkt.add_question(new DNSQuestion("example.com", T_SRV));
+#endif
+
+ // Two questions.
+ pkt.add_question(new DNSQuestion("example.abc.def.com", T_SRV));
+ data = pkt.data();
+ EXPECT_EQ(ARES_EBADRESP, ares_parse_srv_reply(data.data(), (int)data.size(), &srv));
+ pkt.questions_.clear();
+ pkt.add_question(new DNSQuestion("64.48.32.16.in-addr.arpa", T_PTR));
+
+ // Wrong sort of answer.
+ pkt.answers_.clear();
+ pkt.add_answer(new DNSMxRR("example.com", 100, 100, "mx1.example.com"));
+ data = pkt.data();
+ EXPECT_EQ(ARES_SUCCESS, ares_parse_srv_reply(data.data(), (int)data.size(), &srv));
+ EXPECT_EQ(nullptr, srv);
+ pkt.answers_.clear();
+ pkt.add_answer(new DNSSrvRR("example.abc.def.com", 180, 0, 10, 8160, "example.abc.def.com"));
+
+ // No answer.
+ pkt.answers_.clear();
+ data = pkt.data();
+ EXPECT_EQ(ARES_ENODATA, ares_parse_srv_reply(data.data(), (int)data.size(), &srv));
+ pkt.add_answer(new DNSSrvRR("example.abc.def.com", 180, 0, 10, 8160, "example.abc.def.com"));
+
+ // Truncated packets.
+ data = pkt.data();
+ for (size_t len = 1; len < data.size(); len++) {
+ int rc = ares_parse_srv_reply(data.data(), (int)len, &srv);
+ EXPECT_TRUE(rc == ARES_EBADRESP || rc == ARES_EBADNAME);
+ }
+}
+
+TEST_F(LibraryTest, ParseSrvReplyAllocFail) {
+ DNSPacket pkt;
+ pkt.set_qid(0x1234).set_response().set_aa()
+ .add_question(new DNSQuestion("example.abc.def.com", T_SRV))
+ .add_answer(new DNSCnameRR("example.com", 300, "c.example.com"))
+ .add_answer(new DNSSrvRR("example.abc.def.com", 180, 0, 10, 8160, "example.abc.def.com"));
+ std::vector<byte> data = pkt.data();
+ struct ares_srv_reply* srv = nullptr;
+
+ for (int ii = 1; ii <= 5; ii++) {
+ ClearFails();
+ SetAllocFail(ii);
+ EXPECT_EQ(ARES_ENOMEM, ares_parse_srv_reply(data.data(), (int)data.size(), &srv)) << ii;
+ }
+}
+
+} // namespace test
+} // namespace ares
diff --git a/subprojects/c-ares/test/ares-test-parse-txt.cc b/subprojects/c-ares/test/ares-test-parse-txt.cc
@@ -0,0 +1,274 @@
+/*
+ * Copyright (C) The c-ares project
+ *
+ * Permission to use, copy, modify, and distribute this
+ * software and its documentation for any purpose and without
+ * fee is hereby granted, provided that the above copyright
+ * notice appear in all copies and that both that copyright
+ * notice and this permission notice appear in supporting
+ * documentation, and that the name of M.I.T. not be used in
+ * advertising or publicity pertaining to distribution of the
+ * software without specific, written prior permission.
+ * M.I.T. makes no representations about the suitability of
+ * this software for any purpose. It is provided "as is"
+ * without express or implied warranty.
+ *
+ * SPDX-License-Identifier: MIT
+ */
+#include "ares-test.h"
+#include "dns-proto.h"
+
+#include <sstream>
+#include <vector>
+
+namespace ares {
+namespace test {
+
+TEST_F(LibraryTest, ParseTxtReplyOK) {
+ DNSPacket pkt;
+ std::string expected1 = "txt1.example.com";
+ std::string expected2a = "txt2a";
+ std::string expected2b("ABC\0ABC", 7);
+ pkt.set_qid(0x1234).set_response().set_aa()
+ .add_question(new DNSQuestion("example.com", T_MX))
+ .add_answer(new DNSTxtRR("example.com", 100, {expected1}))
+ .add_answer(new DNSTxtRR("example.com", 100, {expected2a, expected2b}));
+ std::vector<byte> data = pkt.data();
+
+ struct ares_txt_reply* txt = nullptr;
+ EXPECT_EQ(ARES_SUCCESS, ares_parse_txt_reply(data.data(), (int)data.size(), &txt));
+ ASSERT_NE(nullptr, txt);
+ EXPECT_EQ(std::vector<byte>(expected1.data(), expected1.data() + expected1.size()),
+ std::vector<byte>(txt->txt, txt->txt + txt->length));
+
+ struct ares_txt_reply* txt2 = txt->next;
+ ASSERT_NE(nullptr, txt2);
+ std::vector<byte> rsp = std::vector<byte>(expected2a.data(), expected2a.data() + expected2a.size());
+ rsp.insert(rsp.end(), expected2b.data(), expected2b.data() + expected2b.size());
+ EXPECT_EQ(rsp,
+ std::vector<byte>(txt2->txt, txt2->txt + txt2->length));
+
+ ares_free_data(txt);
+}
+
+TEST_F(LibraryTest, ParseTxtExtReplyOK) {
+ DNSPacket pkt;
+ std::string expected1 = "txt1.example.com";
+ std::string expected2a = "txt2a";
+ std::string expected2b("ABC\0ABC", 7);
+ pkt.set_qid(0x1234).set_response().set_aa()
+ .add_question(new DNSQuestion("example.com", T_MX))
+ .add_answer(new DNSTxtRR("example.com", 100, {expected1}))
+ .add_answer(new DNSTxtRR("example.com", 100, {expected2a, expected2b}));
+ std::vector<byte> data = pkt.data();
+
+ struct ares_txt_ext* txt = nullptr;
+ EXPECT_EQ(ARES_SUCCESS, ares_parse_txt_reply_ext(data.data(), (int)data.size(), &txt));
+ ASSERT_NE(nullptr, txt);
+ EXPECT_EQ(std::vector<byte>(expected1.data(), expected1.data() + expected1.size()),
+ std::vector<byte>(txt->txt, txt->txt + txt->length));
+ EXPECT_EQ(1, txt->record_start);
+
+ struct ares_txt_ext* txt2 = txt->next;
+ ASSERT_NE(nullptr, txt2);
+ std::vector<byte> rsp = std::vector<byte>(expected2a.data(), expected2a.data() + expected2a.size());
+ rsp.insert(rsp.end(), expected2b.data(), expected2b.data() + expected2b.size());
+ EXPECT_EQ(rsp,
+ std::vector<byte>(txt2->txt, txt2->txt + txt2->length));
+ EXPECT_EQ(1, txt2->record_start);
+
+ ares_free_data(txt);
+}
+
+TEST_F(LibraryTest, ParseTxtMalformedReply1) {
+ std::vector<byte> data = {
+ 0x12, 0x34, // qid
+ 0x84, // response + query + AA + not-TC + not-RD
+ 0x00, // not-RA + not-Z + not-AD + not-CD + rc=NoError
+ 0x00, 0x01, // num questions
+ 0x00, 0x01, // num answer RRs
+ 0x00, 0x00, // num authority RRs
+ 0x00, 0x00, // num additional RRs
+ // Question
+ 0x07, 'e', 'x', 'a', 'm', 'p', 'l', 'e',
+ 0x03, 'c', 'o', 'm',
+ 0x00,
+ 0x00, 0x10, // type TXT
+ 0x00, 0x01, // class IN
+ // Answer 1
+ 0x07, 'e', 'x', 'a', 'm', 'p', 'l', 'e',
+ 0x03, 'c', 'o', 'm',
+ 0x00,
+ 0x00, 0x10, // RR type
+ 0x00, 0x01, // class IN
+ 0x01, 0x02, 0x03, 0x04, // TTL
+ 0x00, 0x03, // rdata length
+ 0x12, 'a', 'b', // invalid length
+ };
+
+ struct ares_txt_reply* txt = nullptr;
+ EXPECT_EQ(ARES_EBADRESP, ares_parse_txt_reply(data.data(), (int)data.size(), &txt));
+ ASSERT_EQ(nullptr, txt);
+}
+
+TEST_F(LibraryTest, ParseTxtMalformedReply2) {
+ std::vector<byte> data = {
+ 0x12, 0x34, // qid
+ 0x84, // response + query + AA + not-TC + not-RD
+ 0x00, // not-RA + not-Z + not-AD + not-CD + rc=NoError
+ 0x00, 0x01, // num questions
+ 0x00, 0x01, // num answer RRs
+ 0x00, 0x00, // num authority RRs
+ 0x00, 0x00, // num additional RRs
+ // Question
+ 0x07, 'e', 'x', 'a', 'm', 'p', 'l', 'e',
+ 0x03, 'c', 'o', 'm',
+ 0x00,
+ 0x00, 0x10, // type TXT
+ 0x00, 0x01, // class IN
+ // Answer 1
+ 0x07, 'e', 'x', 'a', 'm', 'p', 'l', 'e',
+ 0x03, 'c', 'o', 'm',
+ 0x00,
+ 0x00, 0x10, // RR type
+ // truncated
+ };
+
+ struct ares_txt_reply* txt = nullptr;
+ EXPECT_EQ(ARES_EBADRESP, ares_parse_txt_reply(data.data(), (int)data.size(), &txt));
+ ASSERT_EQ(nullptr, txt);
+}
+
+TEST_F(LibraryTest, ParseTxtMalformedReply3) {
+ std::vector<byte> data = {
+ 0x12, 0x34, // qid
+ 0x84, // response + query + AA + not-TC + not-RD
+ 0x00, // not-RA + not-Z + not-AD + not-CD + rc=NoError
+ 0x00, 0x01, // num questions
+ 0x00, 0x01, // num answer RRs
+ 0x00, 0x00, // num authority RRs
+ 0x00, 0x00, // num additional RRs
+ // Question
+ 0x07, 'e', 'x', 'a', 'm', 'p', 'l', 'e',
+ 0x03, 'c', 'o', 'm',
+ 0x00,
+ 0x00, 0x10, // type TXT
+ 0x00, 0x01, // class IN
+ // Answer 1
+ 0x07, 'e', 'x', 'a', 'm', 'p', 'l', 'e',
+ 0x03, 'c', 'o', 'm',
+ 0x00,
+ 0x00, 0x10, // RR type
+ 0x00, 0x01, // class IN
+ 0x01, 0x02, 0x03, 0x04, // TTL
+ 0x00, 0x13, // rdata length INVALID
+ 0x02, 'a', 'b',
+ };
+
+ struct ares_txt_reply* txt = nullptr;
+ EXPECT_EQ(ARES_EBADRESP, ares_parse_txt_reply(data.data(), (int)data.size(), &txt));
+ ASSERT_EQ(nullptr, txt);
+}
+
+TEST_F(LibraryTest, ParseTxtMalformedReply4) {
+ std::vector<byte> data = {
+ 0x12, 0x34, // qid
+ 0x84, // response + query + AA + not-TC + not-RD
+ 0x00, // not-RA + not-Z + not-AD + not-CD + rc=NoError
+ 0x00, 0x01, // num questions
+ 0x00, 0x01, // num answer RRs
+ 0x00, 0x00, // num authority RRs
+ 0x00, 0x00, // num additional RRs
+ // Question
+ 0x07, 'e', 'x', 'a', 'm', 'p', 'l', 'e',
+ 0x03, 'c', 'o', 'm',
+ 0x00,
+ 0x00, 0x10, // type TXT
+ 0x00, // TRUNCATED
+ };
+
+ struct ares_txt_reply* txt = nullptr;
+ EXPECT_EQ(ARES_EBADRESP, ares_parse_txt_reply(data.data(), (int)data.size(), &txt));
+ ASSERT_EQ(nullptr, txt);
+}
+
+TEST_F(LibraryTest, ParseTxtReplyErrors) {
+ DNSPacket pkt;
+ std::string expected1 = "txt1.example.com";
+ std::string expected2a = "txt2a";
+ std::string expected2b = "txt2b";
+ pkt.set_qid(0x1234).set_response().set_aa()
+ .add_question(new DNSQuestion("example.com", T_MX))
+ .add_answer(new DNSTxtRR("example.com", 100, {expected1}))
+ .add_answer(new DNSTxtRR("example.com", 100, {expected1}))
+ .add_answer(new DNSTxtRR("example.com", 100, {expected2a, expected2b}));
+ std::vector<byte> data = pkt.data();
+ struct ares_txt_reply* txt = nullptr;
+
+ // No question.
+ pkt.questions_.clear();
+ data = pkt.data();
+ txt = nullptr;
+ EXPECT_EQ(ARES_EBADRESP, ares_parse_txt_reply(data.data(), (int)data.size(), &txt));
+ EXPECT_EQ(nullptr, txt);
+ pkt.add_question(new DNSQuestion("example.com", T_MX));
+
+#ifdef DISABLED
+ // Question != answer
+ pkt.questions_.clear();
+ pkt.add_question(new DNSQuestion("Axample.com", T_TXT));
+ data = pkt.data();
+ EXPECT_EQ(ARES_ENODATA, ares_parse_txt_reply(data.data(), (int)data.size(), &txt));
+ pkt.questions_.clear();
+ pkt.add_question(new DNSQuestion("example.com", T_TXT));
+#endif
+
+ // Two questions.
+ pkt.add_question(new DNSQuestion("example.com", T_MX));
+ data = pkt.data();
+ txt = nullptr;
+ EXPECT_EQ(ARES_EBADRESP, ares_parse_txt_reply(data.data(), (int)data.size(), &txt));
+ EXPECT_EQ(nullptr, txt);
+ pkt.questions_.clear();
+ pkt.add_question(new DNSQuestion("example.com", T_MX));
+
+ // No answer.
+ pkt.answers_.clear();
+ data = pkt.data();
+ txt = nullptr;
+ EXPECT_EQ(ARES_ENODATA, ares_parse_txt_reply(data.data(), (int)data.size(), &txt));
+ EXPECT_EQ(nullptr, txt);
+ pkt.add_answer(new DNSTxtRR("example.com", 100, {expected1}));
+
+ // Truncated packets.
+ for (size_t len = 1; len < data.size(); len++) {
+ txt = nullptr;
+ EXPECT_NE(ARES_SUCCESS, ares_parse_txt_reply(data.data(), (int)len, &txt));
+ EXPECT_EQ(nullptr, txt);
+ }
+}
+
+TEST_F(LibraryTest, ParseTxtReplyAllocFail) {
+ DNSPacket pkt;
+ std::string expected1 = "txt1.example.com";
+ std::string expected2a = "txt2a";
+ std::string expected2b = "txt2b";
+ pkt.set_qid(0x1234).set_response().set_aa()
+ .add_question(new DNSQuestion("example.com", T_MX))
+ .add_answer(new DNSCnameRR("example.com", 300, "c.example.com"))
+ .add_answer(new DNSTxtRR("c.example.com", 100, {expected1}))
+ .add_answer(new DNSTxtRR("c.example.com", 100, {expected1}))
+ .add_answer(new DNSTxtRR("c.example.com", 100, {expected2a, expected2b}));
+ std::vector<byte> data = pkt.data();
+ struct ares_txt_reply* txt = nullptr;
+
+ for (int ii = 1; ii <= 13; ii++) {
+ ClearFails();
+ SetAllocFail(ii);
+ EXPECT_EQ(ARES_ENOMEM, ares_parse_txt_reply(data.data(), (int)data.size(), &txt)) << ii;
+ }
+}
+
+
+} // namespace test
+} // namespace ares
diff --git a/subprojects/c-ares/test/ares-test-parse-uri.cc b/subprojects/c-ares/test/ares-test-parse-uri.cc
@@ -0,0 +1,305 @@
+/*
+ * Copyright (C) The c-ares project
+ *
+ * Permission to use, copy, modify, and distribute this
+ * software and its documentation for any purpose and without
+ * fee is hereby granted, provided that the above copyright
+ * notice appear in all copies and that both that copyright
+ * notice and this permission notice appear in supporting
+ * documentation, and that the name of M.I.T. not be used in
+ * advertising or publicity pertaining to distribution of the
+ * software without specific, written prior permission.
+ * M.I.T. makes no representations about the suitability of
+ * this software for any purpose. It is provided "as is"
+ * without express or implied warranty.
+ *
+ * SPDX-License-Identifier: MIT
+ */
+#include "ares-test.h"
+#include "dns-proto.h"
+
+#include <sstream>
+#include <vector>
+
+namespace ares {
+namespace test {
+
+TEST_F(LibraryTest, ParseUriReplyOK) {
+ DNSPacket pkt;
+ pkt.set_qid(0x1234).set_response().set_aa()
+ .add_question(new DNSQuestion("example.com", T_URI))
+ .add_answer(new DNSUriRR("example.com", 100, 10, 20, "uri.example.com"))
+ .add_answer(new DNSUriRR("example.com", 200, 11, 21, "uri2.example.com"));
+ std::vector<byte> data = pkt.data();
+
+ struct ares_uri_reply* uri = nullptr;
+ EXPECT_EQ(ARES_SUCCESS, ares_parse_uri_reply(data.data(), (int)data.size(), &uri));
+ ASSERT_NE(nullptr, uri);
+
+ EXPECT_EQ("uri.example.com", std::string(uri->uri));
+ EXPECT_EQ(10, uri->priority);
+ EXPECT_EQ(20, uri->weight);
+ EXPECT_EQ(100, uri->ttl);
+
+ struct ares_uri_reply* uri2 = uri->next;
+ ASSERT_NE(nullptr, uri2);
+ EXPECT_EQ("uri2.example.com", std::string(uri2->uri));
+ EXPECT_EQ(11, uri2->priority);
+ EXPECT_EQ(21, uri2->weight);
+ EXPECT_EQ(200, uri2->ttl);
+ EXPECT_EQ(nullptr, uri2->next);
+
+ ares_free_data(uri);
+}
+
+TEST_F(LibraryTest, ParseUriReplySingle) {
+ DNSPacket pkt;
+ pkt.set_qid(0x1234).set_response().set_aa()
+ .add_question(new DNSQuestion("example.abc.def.com", T_URI))
+ .add_answer(new DNSUriRR("example.abc.def.com", 180, 0, 10, "example.abc.def.com"))
+ .add_auth(new DNSNsRR("abc.def.com", 44, "else1.where.com"))
+ .add_auth(new DNSNsRR("abc.def.com", 44, "else2.where.com"))
+ .add_auth(new DNSNsRR("abc.def.com", 44, "else3.where.com"))
+ .add_auth(new DNSNsRR("abc.def.com", 44, "else4.where.com"))
+ .add_auth(new DNSNsRR("abc.def.com", 44, "else5.where.com"))
+ .add_additional(new DNSARR("else2.where.com", 42, {172,19,0,1}))
+ .add_additional(new DNSARR("else5.where.com", 42, {172,19,0,2}));
+ std::vector<byte> data = pkt.data();
+
+ struct ares_uri_reply* uri = nullptr;
+ EXPECT_EQ(ARES_SUCCESS, ares_parse_uri_reply(data.data(), (int)data.size(), &uri));
+ ASSERT_NE(nullptr, uri);
+
+ EXPECT_EQ("example.abc.def.com", std::string(uri->uri));
+ EXPECT_EQ(0, uri->priority);
+ EXPECT_EQ(10, uri->weight);
+ EXPECT_EQ(180, uri->ttl);
+ EXPECT_EQ(nullptr, uri->next);
+
+ ares_free_data(uri);
+}
+
+TEST_F(LibraryTest, ParseUriReplyMalformed) {
+ std::vector<byte> data = {
+ 0x12, 0x34, // qid
+ 0x84, // response + query + AA + not-TC + not-RD
+ 0x00, // not-RA + not-Z + not-AD + not-CD + rc=NoError
+ 0x00, 0x01, // num questions
+ 0x00, 0x01, // num answer RRs
+ 0x00, 0x00, // num authority RRs
+ 0x00, 0x00, // num additional RRs
+ // Question
+ 0x07, 'e', 'x', 'a', 'm', 'p', 'l', 'e',
+ 0x03, 'c', 'o', 'm',
+ 0x00,
+ 0x01, 0x00, // type URI
+ 0x00, 0x01, // class IN
+ // Answer 1
+ 0x07, 'e', 'x', 'a', 'm', 'p', 'l', 'e',
+ 0x03, 'c', 'o', 'm',
+ 0x00,
+ 0x01, 0x00, // RR type
+ 0x00, 0x01, // class IN
+ 0x01, 0x02, 0x03, 0x04, // TTL
+ 0x00, 0x04, // rdata length -- too short
+ 0x02, 0x03, 0x04, 0x05,
+ };
+
+ struct ares_uri_reply* uri = nullptr;
+ EXPECT_EQ(ARES_EBADRESP, ares_parse_uri_reply(data.data(), (int)data.size(), &uri));
+ ASSERT_EQ(nullptr, uri);
+}
+
+TEST_F(LibraryTest, ParseUriReplyMultiple) {
+ DNSPacket pkt;
+ pkt.set_qid(0x1234).set_response().set_ra().set_rd()
+ .add_question(new DNSQuestion("uri.example.com", T_URI))
+ .add_answer(new DNSUriRR("uri.example.com", 600, 0, 5, "a1.uri.example.com"))
+ .add_answer(new DNSUriRR("uri.example.com", 660, 0, 5, "a2.uri.example.com"))
+ .add_answer(new DNSUriRR("uri.example.com", 720, 0, 5, "a3.uri.example.com"))
+ .add_auth(new DNSNsRR("example.com", 300, "ns1.example.com"))
+ .add_auth(new DNSNsRR("example.com", 300, "ns2.example.com"))
+ .add_auth(new DNSNsRR("example.com", 300, "ns3.example.com"))
+ .add_additional(new DNSARR("a1.uri.example.com", 300, {172,19,1,1}))
+ .add_additional(new DNSARR("a2.uri.example.com", 300, {172,19,1,2}))
+ .add_additional(new DNSARR("a3.uri.example.com", 300, {172,19,1,3}))
+ .add_additional(new DNSARR("n1.example.com", 300, {172,19,0,1}))
+ .add_additional(new DNSARR("n2.example.com", 300, {172,19,0,2}))
+ .add_additional(new DNSARR("n3.example.com", 300, {172,19,0,3}));
+ std::vector<byte> data = pkt.data();
+
+ struct ares_uri_reply* uri0 = nullptr;
+ EXPECT_EQ(ARES_SUCCESS, ares_parse_uri_reply(data.data(), (int)data.size(), &uri0));
+ ASSERT_NE(nullptr, uri0);
+ struct ares_uri_reply* uri = uri0;
+
+ EXPECT_EQ("a1.uri.example.com", std::string(uri->uri));
+ EXPECT_EQ(0, uri->priority);
+ EXPECT_EQ(5, uri->weight);
+ EXPECT_EQ(600, uri->ttl);
+ EXPECT_NE(nullptr, uri->next);
+ uri = uri->next;
+
+ EXPECT_EQ("a2.uri.example.com", std::string(uri->uri));
+ EXPECT_EQ(0, uri->priority);
+ EXPECT_EQ(5, uri->weight);
+ EXPECT_EQ(660, uri->ttl);
+ EXPECT_NE(nullptr, uri->next);
+ uri = uri->next;
+
+ EXPECT_EQ("a3.uri.example.com", std::string(uri->uri));
+ EXPECT_EQ(0, uri->priority);
+ EXPECT_EQ(5, uri->weight);
+ EXPECT_EQ(720, uri->ttl);
+ EXPECT_EQ(nullptr, uri->next);
+
+ ares_free_data(uri0);
+}
+
+TEST_F(LibraryTest, ParseUriReplyCname) {
+ DNSPacket pkt;
+ pkt.set_qid(0x1234).set_response().set_aa()
+ .add_question(new DNSQuestion("example.abc.def.com", T_URI))
+ .add_answer(new DNSCnameRR("example.abc.def.com", 300, "cname.abc.def.com"))
+ .add_answer(new DNSUriRR("cname.abc.def.com", 600, 0, 10, "uri.abc.def.com"))
+ .add_auth(new DNSNsRR("abc.def.com", 44, "else1.where.com"))
+ .add_auth(new DNSNsRR("abc.def.com", 44, "else2.where.com"))
+ .add_auth(new DNSNsRR("abc.def.com", 44, "else3.where.com"))
+ .add_additional(new DNSARR("example.abc.def.com", 300, {172,19,0,1}))
+ .add_additional(new DNSARR("else1.where.com", 42, {172,19,0,1}))
+ .add_additional(new DNSARR("else2.where.com", 42, {172,19,0,2}))
+ .add_additional(new DNSARR("else3.where.com", 42, {172,19,0,3}));
+ std::vector<byte> data = pkt.data();
+
+ struct ares_uri_reply* uri = nullptr;
+ EXPECT_EQ(ARES_SUCCESS, ares_parse_uri_reply(data.data(), (int)data.size(), &uri));
+ ASSERT_NE(nullptr, uri);
+
+ EXPECT_EQ("uri.abc.def.com", std::string(uri->uri));
+ EXPECT_EQ(0, uri->priority);
+ EXPECT_EQ(10, uri->weight);
+ EXPECT_EQ(600, uri->ttl);
+ EXPECT_EQ(nullptr, uri->next);
+
+ ares_free_data(uri);
+}
+
+TEST_F(LibraryTest, ParseUriReplyCnameMultiple) {
+ DNSPacket pkt;
+ pkt.set_qid(0x1234).set_response().set_ra().set_rd()
+ .add_question(new DNSQuestion("query.example.com", T_URI))
+ .add_answer(new DNSCnameRR("query.example.com", 300, "uri.example.com"))
+ .add_answer(new DNSUriRR("uri.example.com", 600, 0, 5, "a1.uri.example.com"))
+ .add_answer(new DNSUriRR("uri.example.com", 660, 0, 5, "a2.uri.example.com"))
+ .add_answer(new DNSUriRR("uri.example.com", 720, 0, 5, "a3.uri.example.com"))
+ .add_auth(new DNSNsRR("example.com", 300, "ns1.example.com"))
+ .add_auth(new DNSNsRR("example.com", 300, "ns2.example.com"))
+ .add_auth(new DNSNsRR("example.com", 300, "ns3.example.com"))
+ .add_additional(new DNSARR("a1.uri.example.com", 300, {172,19,1,1}))
+ .add_additional(new DNSARR("a2.uri.example.com", 300, {172,19,1,2}))
+ .add_additional(new DNSARR("a3.uri.example.com", 300, {172,19,1,3}))
+ .add_additional(new DNSARR("n1.example.com", 300, {172,19,0,1}))
+ .add_additional(new DNSARR("n2.example.com", 300, {172,19,0,2}))
+ .add_additional(new DNSARR("n3.example.com", 300, {172,19,0,3}));
+ std::vector<byte> data = pkt.data();
+
+ struct ares_uri_reply* uri0 = nullptr;
+ EXPECT_EQ(ARES_SUCCESS, ares_parse_uri_reply(data.data(), (int)data.size(), &uri0));
+ ASSERT_NE(nullptr, uri0);
+ struct ares_uri_reply* uri = uri0;
+
+ EXPECT_EQ("a1.uri.example.com", std::string(uri->uri));
+ EXPECT_EQ(0, uri->priority);
+ EXPECT_EQ(5, uri->weight);
+ EXPECT_EQ(600, uri->ttl);
+ EXPECT_NE(nullptr, uri->next);
+ uri = uri->next;
+
+ EXPECT_EQ("a2.uri.example.com", std::string(uri->uri));
+ EXPECT_EQ(0, uri->priority);
+ EXPECT_EQ(5, uri->weight);
+ EXPECT_EQ(660, uri->ttl);
+ EXPECT_NE(nullptr, uri->next);
+ uri = uri->next;
+
+ EXPECT_EQ("a3.uri.example.com", std::string(uri->uri));
+ EXPECT_EQ(0, uri->priority);
+ EXPECT_EQ(5, uri->weight);
+ EXPECT_EQ(720, uri->ttl);
+ EXPECT_EQ(nullptr, uri->next);
+
+ ares_free_data(uri0);
+}
+
+TEST_F(LibraryTest, ParseUriReplyErrors) {
+ DNSPacket pkt;
+ pkt.set_qid(0x1234).set_response().set_aa()
+ .add_question(new DNSQuestion("example.abc.def.com", T_URI))
+ .add_answer(new DNSUriRR("example.abc.def.com", 180, 0, 10, "example.abc.def.com"));
+ std::vector<byte> data;
+ struct ares_uri_reply* uri = nullptr;
+
+ // No question.
+ pkt.questions_.clear();
+ data = pkt.data();
+ EXPECT_EQ(ARES_EBADRESP, ares_parse_uri_reply(data.data(), (int)data.size(), &uri));
+ pkt.add_question(new DNSQuestion("example.abc.def.com", T_URI));
+
+#ifdef DISABLED
+ // Question != answer
+ pkt.questions_.clear();
+ pkt.add_question(new DNSQuestion("Axample.com", T_URI));
+ data = pkt.data();
+ EXPECT_EQ(ARES_ENODATA, ares_parse_uri_reply(data.data(), (int)data.size(), &uri));
+ pkt.questions_.clear();
+ pkt.add_question(new DNSQuestion("example.com", T_URI));
+#endif
+
+ // Two questions.
+ pkt.add_question(new DNSQuestion("example.abc.def.com", T_URI));
+ data = pkt.data();
+ EXPECT_EQ(ARES_EBADRESP, ares_parse_uri_reply(data.data(), (int)data.size(), &uri));
+ pkt.questions_.clear();
+ pkt.add_question(new DNSQuestion("64.48.32.16.in-addr.arpa", T_PTR));
+
+ // Wrong sort of answer.
+ pkt.answers_.clear();
+ pkt.add_answer(new DNSMxRR("example.com", 100, 100, "mx1.example.com"));
+ data = pkt.data();
+ EXPECT_EQ(ARES_SUCCESS, ares_parse_uri_reply(data.data(), (int)data.size(), &uri));
+ EXPECT_EQ(nullptr, uri);
+ pkt.answers_.clear();
+ pkt.add_answer(new DNSUriRR("example.abc.def.com", 180, 0, 10, "example.abc.def.com"));
+
+ // No answer.
+ pkt.answers_.clear();
+ data = pkt.data();
+ EXPECT_EQ(ARES_ENODATA, ares_parse_uri_reply(data.data(), (int)data.size(), &uri));
+ pkt.add_answer(new DNSUriRR("example.abc.def.com", 180, 0, 10, "example.abc.def.com"));
+
+ // Truncated packets.
+ data = pkt.data();
+ for (size_t len = 1; len < data.size(); len++) {
+ int rc = ares_parse_uri_reply(data.data(), (int)len, &uri);
+ EXPECT_TRUE(rc == ARES_EBADRESP || rc == ARES_EBADNAME);
+ }
+}
+
+TEST_F(LibraryTest, ParseUriReplyAllocFail) {
+ DNSPacket pkt;
+ pkt.set_qid(0x1234).set_response().set_aa()
+ .add_question(new DNSQuestion("example.abc.def.com", T_URI))
+ .add_answer(new DNSCnameRR("example.com", 300, "c.example.com"))
+ .add_answer(new DNSUriRR("example.abc.def.com", 180, 0, 10, "example.abc.def.com"));
+ std::vector<byte> data = pkt.data();
+ struct ares_uri_reply* uri = nullptr;
+
+ for (int ii = 1; ii <= 5; ii++) {
+ ClearFails();
+ SetAllocFail(ii);
+ EXPECT_EQ(ARES_ENOMEM, ares_parse_uri_reply(data.data(), (int)data.size(), &uri)) << ii;
+ }
+}
+
+} // namespace test
+} // namespace ares
diff --git a/subprojects/c-ares/test/ares-test-parse.cc b/subprojects/c-ares/test/ares-test-parse.cc
@@ -0,0 +1,204 @@
+/*
+ * Copyright (C) The c-ares project
+ *
+ * Permission to use, copy, modify, and distribute this
+ * software and its documentation for any purpose and without
+ * fee is hereby granted, provided that the above copyright
+ * notice appear in all copies and that both that copyright
+ * notice and this permission notice appear in supporting
+ * documentation, and that the name of M.I.T. not be used in
+ * advertising or publicity pertaining to distribution of the
+ * software without specific, written prior permission.
+ * M.I.T. makes no representations about the suitability of
+ * this software for any purpose. It is provided "as is"
+ * without express or implied warranty.
+ *
+ * SPDX-License-Identifier: MIT
+ */
+#include "ares-test.h"
+#include "dns-proto.h"
+
+#include <sstream>
+#include <vector>
+
+namespace ares {
+namespace test {
+
+TEST_F(LibraryTest, ParseRootName) {
+ DNSPacket pkt;
+ pkt.set_qid(0x1234).set_response().set_aa()
+ .add_question(new DNSQuestion(".", T_A))
+ .add_answer(new DNSARR(".", 100, {0x02, 0x03, 0x04, 0x05}));
+ std::vector<byte> data = pkt.data();
+
+ struct hostent *host = nullptr;
+ struct ares_addrttl info[2];
+ int count = 2;
+ EXPECT_EQ(ARES_SUCCESS, ares_parse_a_reply(data.data(), (int)data.size(),
+ &host, info, &count));
+ EXPECT_EQ(1, count);
+ std::stringstream ss;
+ ss << HostEnt(host);
+ EXPECT_EQ("{'' aliases=[] addrs=[2.3.4.5]}", ss.str());
+ ares_free_hostent(host);
+}
+
+TEST_F(LibraryTest, ParseIndirectRootName) {
+ std::vector<byte> data = {
+ 0x12, 0x34, // qid
+ 0x84, // response + query + AA + not-TC + not-RD
+ 0x00, // not-RA + not-Z + not-AD + not-CD + rc=NoError
+ 0x00, 0x01, // num questions
+ 0x00, 0x01, // num answer RRs
+ 0x00, 0x00, // num authority RRs
+ 0x00, 0x00, // num additional RRs
+ // Question
+ 0xC0, 0x04, // weird: pointer to a random zero earlier in the message
+ 0x00, 0x01, // type A
+ 0x00, 0x01, // class IN
+ // Answer 1
+ 0xC0, 0x04,
+ 0x00, 0x01, // RR type
+ 0x00, 0x01, // class IN
+ 0x01, 0x02, 0x03, 0x04, // TTL
+ 0x00, 0x04, // rdata length
+ 0x02, 0x03, 0x04, 0x05,
+ };
+
+ struct hostent *host = nullptr;
+ struct ares_addrttl info[2];
+ int count = 2;
+ EXPECT_EQ(ARES_SUCCESS, ares_parse_a_reply(data.data(), (int)data.size(),
+ &host, info, &count));
+ EXPECT_EQ(1, count);
+ std::stringstream ss;
+ ss << HostEnt(host);
+ EXPECT_EQ("{'' aliases=[] addrs=[2.3.4.5]}", ss.str());
+ ares_free_hostent(host);
+}
+
+
+#if 0 /* We are validating hostnames now, its not clear how this would ever be valid */
+TEST_F(LibraryTest, ParseEscapedName) {
+ std::vector<byte> data = {
+ 0x12, 0x34, // qid
+ 0x84, // response + query + AA + not-TC + not-RD
+ 0x00, // not-RA + not-Z + not-AD + not-CD + rc=NoError
+ 0x00, 0x01, // num questions
+ 0x00, 0x01, // num answer RRs
+ 0x00, 0x00, // num authority RRs
+ 0x00, 0x00, // num additional RRs
+ // Question
+ 0x05, 'a', '\\', 'b', '.', 'c',
+ 0x03, 'c', 'o', 'm',
+ 0x00,
+ 0x00, 0x01, // type A
+ 0x00, 0x01, // class IN
+ // Answer 1
+ 0x05, 'a', '\\', 'b', '.', 'c',
+ 0x03, 'c', 'o', 'm',
+ 0x00,
+ 0x00, 0x01, // RR type
+ 0x00, 0x01, // class IN
+ 0x01, 0x02, 0x03, 0x04, // TTL
+ 0x00, 0x04, // rdata length
+ 0x02, 0x03, 0x04, 0x05,
+ };
+ struct hostent *host = nullptr;
+ struct ares_addrttl info[2];
+ int count = 2;
+ EXPECT_EQ(ARES_SUCCESS, ares_parse_a_reply(data.data(), data.size(),
+ &host, info, &count));
+ EXPECT_EQ(1, count);
+ HostEnt hent(host);
+ std::stringstream ss;
+ ss << hent;
+ // The printable name is expanded with escapes.
+ EXPECT_EQ(11, hent.name_.size());
+ EXPECT_EQ('a', hent.name_[0]);
+ EXPECT_EQ('\\', hent.name_[1]);
+ EXPECT_EQ('\\', hent.name_[2]);
+ EXPECT_EQ('b', hent.name_[3]);
+ EXPECT_EQ('\\', hent.name_[4]);
+ EXPECT_EQ('.', hent.name_[5]);
+ EXPECT_EQ('c', hent.name_[6]);
+ ares_free_hostent(host);
+}
+#endif
+
+TEST_F(LibraryTest, ParsePartialCompressedName) {
+ std::vector<byte> data = {
+ 0x12, 0x34, // qid
+ 0x84, // response + query + AA + not-TC + not-RD
+ 0x00, // not-RA + not-Z + not-AD + not-CD + rc=NoError
+ 0x00, 0x01, // num questions
+ 0x00, 0x01, // num answer RRs
+ 0x00, 0x00, // num authority RRs
+ 0x00, 0x00, // num additional RRs
+ // Question
+ 0x03, 'w', 'w', 'w',
+ 0x07, 'e', 'x', 'a', 'm', 'p', 'l', 'e',
+ 0x03, 'c', 'o', 'm',
+ 0x00,
+ 0x00, 0x01, // type A
+ 0x00, 0x01, // class IN
+ // Answer 1
+ 0x03, 'w', 'w', 'w',
+ 0xc0, 0x10, // offset 16
+ 0x00, 0x01, // RR type
+ 0x00, 0x01, // class IN
+ 0x01, 0x02, 0x03, 0x04, // TTL
+ 0x00, 0x04, // rdata length
+ 0x02, 0x03, 0x04, 0x05,
+ };
+ struct hostent *host = nullptr;
+ struct ares_addrttl info[2];
+ int count = 2;
+ EXPECT_EQ(ARES_SUCCESS, ares_parse_a_reply(data.data(), (int)data.size(),
+ &host, info, &count));
+ ASSERT_NE(nullptr, host);
+ std::stringstream ss;
+ ss << HostEnt(host);
+ EXPECT_EQ("{'www.example.com' aliases=[] addrs=[2.3.4.5]}", ss.str());
+ ares_free_hostent(host);
+}
+
+TEST_F(LibraryTest, ParseFullyCompressedName) {
+ std::vector<byte> data = {
+ 0x12, 0x34, // qid
+ 0x84, // response + query + AA + not-TC + not-RD
+ 0x00, // not-RA + not-Z + not-AD + not-CD + rc=NoError
+ 0x00, 0x01, // num questions
+ 0x00, 0x01, // num answer RRs
+ 0x00, 0x00, // num authority RRs
+ 0x00, 0x00, // num additional RRs
+ // Question
+ 0x03, 'w', 'w', 'w',
+ 0x07, 'e', 'x', 'a', 'm', 'p', 'l', 'e',
+ 0x03, 'c', 'o', 'm',
+ 0x00,
+ 0x00, 0x01, // type A
+ 0x00, 0x01, // class IN
+ // Answer 1
+ 0xc0, 0x0c, // offset 12
+ 0x00, 0x01, // RR type
+ 0x00, 0x01, // class IN
+ 0x01, 0x02, 0x03, 0x04, // TTL
+ 0x00, 0x04, // rdata length
+ 0x02, 0x03, 0x04, 0x05,
+ };
+ struct hostent *host = nullptr;
+ struct ares_addrttl info[2];
+ int count = 2;
+ EXPECT_EQ(ARES_SUCCESS, ares_parse_a_reply(data.data(), (int)data.size(),
+ &host, info, &count));
+ ASSERT_NE(nullptr, host);
+ std::stringstream ss;
+ ss << HostEnt(host);
+ EXPECT_EQ("{'www.example.com' aliases=[] addrs=[2.3.4.5]}", ss.str());
+ ares_free_hostent(host);
+}
+
+
+} // namespace test
+} // namespace ares
diff --git a/subprojects/c-ares/test/ares-test.cc b/subprojects/c-ares/test/ares-test.cc
@@ -0,0 +1,910 @@
+/* MIT License
+ *
+ * Copyright (c) The c-ares project and its contributors
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice (including the next
+ * paragraph) shall be included in all copies or substantial portions of the
+ * Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ *
+ * SPDX-License-Identifier: MIT
+ */
+#include "ares_setup.h"
+#include "ares.h"
+#include "ares_nameser.h"
+#include "ares-test.h"
+#include "ares-test-ai.h"
+#include "dns-proto.h"
+#include "ares_dns.h"
+
+extern "C" {
+// Remove command-line defines of package variables for the test project...
+#undef PACKAGE_NAME
+#undef PACKAGE_BUGREPORT
+#undef PACKAGE_STRING
+#undef PACKAGE_TARNAME
+// ... so we can include the library's config without symbol redefinitions.
+#include "ares_setup.h"
+#include "ares_inet_net_pton.h"
+#include "ares_data.h"
+#include "ares_strsplit.h"
+#include "ares_private.h"
+}
+
+
+#ifdef HAVE_NETDB_H
+#include <netdb.h>
+#endif
+#ifdef HAVE_NETINET_TCP_H
+#include <netinet/tcp.h>
+#endif
+#include <stdio.h>
+#include <stdlib.h>
+
+#include <functional>
+#include <sstream>
+
+#ifdef WIN32
+#define BYTE_CAST (char *)
+#define mkdir_(d, p) mkdir(d)
+#else
+#define BYTE_CAST
+#define mkdir_(d, p) mkdir(d, p)
+#endif
+
+namespace ares {
+namespace test {
+
+bool verbose = false;
+static constexpr unsigned short dynamic_port = 0;
+unsigned short mock_port = dynamic_port;
+
+const std::vector<int> both_families = {AF_INET, AF_INET6};
+const std::vector<int> ipv4_family = {AF_INET};
+const std::vector<int> ipv6_family = {AF_INET6};
+
+const std::vector<std::pair<int, bool>> both_families_both_modes = {
+ std::make_pair<int, bool>(AF_INET, false),
+ std::make_pair<int, bool>(AF_INET, true),
+ std::make_pair<int, bool>(AF_INET6, false),
+ std::make_pair<int, bool>(AF_INET6, true)
+};
+const std::vector<std::pair<int, bool>> ipv4_family_both_modes = {
+ std::make_pair<int, bool>(AF_INET, false),
+ std::make_pair<int, bool>(AF_INET, true)
+};
+const std::vector<std::pair<int, bool>> ipv6_family_both_modes = {
+ std::make_pair<int, bool>(AF_INET6, false),
+ std::make_pair<int, bool>(AF_INET6, true)
+};
+
+// Which parameters to use in tests
+std::vector<int> families = both_families;
+std::vector<std::pair<int, bool>> families_modes = both_families_both_modes;
+
+unsigned long long LibraryTest::fails_ = 0;
+std::map<size_t, int> LibraryTest::size_fails_;
+
+void ProcessWork(ares_channel_t *channel,
+ std::function<std::set<ares_socket_t>()> get_extrafds,
+ std::function<void(ares_socket_t)> process_extra,
+ unsigned int cancel_ms) {
+ int nfds, count;
+ fd_set readers, writers;
+
+#ifndef CARES_SYMBOL_HIDING
+ struct timeval tv_begin = ares__tvnow();
+ struct timeval tv_cancel = tv_begin;
+
+ if (cancel_ms) {
+ if (verbose) std::cerr << "ares_cancel will be called after " << cancel_ms << "ms" << std::endl;
+ tv_cancel.tv_sec += (cancel_ms / 1000);
+ tv_cancel.tv_usec += ((cancel_ms % 1000) * 1000);
+ }
+#else
+ if (cancel_ms) {
+ std::cerr << "library built with symbol hiding, can't test with cancel support" << std::endl;
+ return;
+ }
+#endif
+
+ while (true) {
+#ifndef CARES_SYMBOL_HIDING
+ struct timeval tv_now = ares__tvnow();
+ struct timeval tv_remaining;
+#endif
+ struct timeval tv;
+ struct timeval *tv_select;
+
+ // Retrieve the set of file descriptors that the library wants us to monitor.
+ FD_ZERO(&readers);
+ FD_ZERO(&writers);
+ nfds = ares_fds(channel, &readers, &writers);
+ if (nfds == 0) // no work left to do in the library
+ return;
+
+ // Add in the extra FDs if present.
+ std::set<ares_socket_t> extrafds = get_extrafds();
+ for (ares_socket_t extrafd : extrafds) {
+ FD_SET(extrafd, &readers);
+ if (extrafd >= (ares_socket_t)nfds) {
+ nfds = (int)extrafd + 1;
+ }
+ }
+
+ /* If ares_timeout returns NULL, it means there are no requests in queue,
+ * so we can break out */
+ tv_select = ares_timeout(channel, NULL, &tv);
+ if (tv_select == NULL)
+ return;
+
+#ifndef CARES_SYMBOL_HIDING
+ if (cancel_ms) {
+ unsigned int remaining_ms;
+ ares__timeval_remaining(&tv_remaining,
+ &tv_now,
+ &tv_cancel);
+ remaining_ms = (unsigned int)((tv_remaining.tv_sec * 1000) + (tv_remaining.tv_usec / 1000));
+ if (remaining_ms == 0) {
+ if (verbose) std::cerr << "Issuing ares_cancel()" << std::endl;
+ ares_cancel(channel);
+ cancel_ms = 0; /* Disable issuing cancel again */
+ } else {
+ /* Recalculate proper timeout since we also have a cancel to wait on */
+ tv_select = ares_timeout(channel, &tv_remaining, &tv);
+ }
+ }
+#endif
+
+ count = select(nfds, &readers, &writers, nullptr, tv_select);
+ if (count < 0) {
+ fprintf(stderr, "select() failed, errno %d\n", errno);
+ return;
+ }
+
+ // Let the library process any activity.
+ ares_process(channel, &readers, &writers);
+
+ // Let the provided callback process any activity on the extra FD.
+ for (ares_socket_t extrafd : extrafds) {
+ if (FD_ISSET(extrafd, &readers)) {
+ process_extra(extrafd);
+ }
+ }
+ }
+}
+
+// static
+void LibraryTest::SetAllocFail(int nth) {
+ assert(nth > 0);
+ assert(nth <= (int)(8 * sizeof(fails_)));
+ fails_ |= (1LL << (nth - 1));
+}
+
+// static
+void LibraryTest::SetAllocSizeFail(size_t size) {
+ size_fails_[size]++;
+}
+
+// static
+void LibraryTest::ClearFails() {
+ fails_ = 0;
+ size_fails_.clear();
+}
+
+
+// static
+bool LibraryTest::ShouldAllocFail(size_t size) {
+ bool fail = (fails_ & 0x01);
+ fails_ >>= 1;
+ if (size_fails_[size] > 0) {
+ size_fails_[size]--;
+ fail = true;
+ }
+ return fail;
+}
+
+// static
+void* LibraryTest::amalloc(size_t size) {
+ if (ShouldAllocFail(size) || size == 0) {
+ if (verbose) std::cerr << "Failing malloc(" << size << ") request" << std::endl;
+ return nullptr;
+ } else {
+ return malloc(size);
+ }
+}
+
+// static
+void* LibraryTest::arealloc(void *ptr, size_t size) {
+ if (ShouldAllocFail(size)) {
+ if (verbose) std::cerr << "Failing realloc(" << ptr << ", " << size << ") request" << std::endl;
+ return nullptr;
+ } else {
+ return realloc(ptr, size);
+ }
+}
+
+// static
+void LibraryTest::afree(void *ptr) {
+ free(ptr);
+}
+
+std::set<ares_socket_t> NoExtraFDs() {
+ return std::set<ares_socket_t>();
+}
+
+void DefaultChannelTest::Process(unsigned int cancel_ms) {
+ ProcessWork(channel_, NoExtraFDs, nullptr, cancel_ms);
+}
+
+void FileChannelTest::Process(unsigned int cancel_ms) {
+ ProcessWork(channel_, NoExtraFDs, nullptr, cancel_ms);
+}
+
+void DefaultChannelModeTest::Process(unsigned int cancel_ms) {
+ ProcessWork(channel_, NoExtraFDs, nullptr, cancel_ms);
+}
+
+MockServer::MockServer(int family, unsigned short port)
+ : udpport_(port), tcpport_(port), qid_(-1) {
+ // Create a TCP socket to receive data on.
+ tcp_data_ = NULL;
+ tcp_data_len_ = 0;
+ tcpfd_ = socket(family, SOCK_STREAM, 0);
+ EXPECT_NE(ARES_SOCKET_BAD, tcpfd_);
+ int optval = 1;
+ setsockopt(tcpfd_, SOL_SOCKET, SO_REUSEADDR,
+ BYTE_CAST &optval , sizeof(int));
+ // Send TCP data right away.
+ setsockopt(tcpfd_, IPPROTO_TCP, TCP_NODELAY,
+ BYTE_CAST &optval , sizeof(int));
+
+ // Create a UDP socket to receive data on.
+ udpfd_ = socket(family, SOCK_DGRAM, 0);
+ EXPECT_NE(ARES_SOCKET_BAD, udpfd_);
+
+ // Bind the sockets to the given port.
+ if (family == AF_INET) {
+ struct sockaddr_in addr;
+ memset(&addr, 0, sizeof(addr));
+ addr.sin_family = AF_INET;
+ addr.sin_addr.s_addr = htonl(INADDR_ANY);
+ addr.sin_port = htons(tcpport_);
+ int tcprc = bind(tcpfd_, (struct sockaddr*)&addr, sizeof(addr));
+ EXPECT_EQ(0, tcprc) << "Failed to bind AF_INET to TCP port " << tcpport_;
+ addr.sin_port = htons(udpport_);
+ int udprc = bind(udpfd_, (struct sockaddr*)&addr, sizeof(addr));
+ EXPECT_EQ(0, udprc) << "Failed to bind AF_INET to UDP port " << udpport_;
+ // retrieve system-assigned port
+ if (udpport_ == dynamic_port) {
+ ares_socklen_t len = sizeof(addr);
+ auto result = getsockname(udpfd_, (struct sockaddr*)&addr, &len);
+ EXPECT_EQ(0, result);
+ udpport_ = ntohs(addr.sin_port);
+ EXPECT_NE(dynamic_port, udpport_);
+ }
+ if (tcpport_ == dynamic_port) {
+ ares_socklen_t len = sizeof(addr);
+ auto result = getsockname(tcpfd_, (struct sockaddr*)&addr, &len);
+ EXPECT_EQ(0, result);
+ tcpport_ = ntohs(addr.sin_port);
+ EXPECT_NE(dynamic_port, tcpport_);
+ }
+ } else {
+ EXPECT_EQ(AF_INET6, family);
+ struct sockaddr_in6 addr;
+ memset(&addr, 0, sizeof(addr));
+ addr.sin6_family = AF_INET6;
+ memset(&addr.sin6_addr, 0, sizeof(addr.sin6_addr)); // in6addr_any
+ addr.sin6_port = htons(tcpport_);
+ int tcprc = bind(tcpfd_, (struct sockaddr*)&addr, sizeof(addr));
+ EXPECT_EQ(0, tcprc) << "Failed to bind AF_INET6 to TCP port " << tcpport_;
+ addr.sin6_port = htons(udpport_);
+ int udprc = bind(udpfd_, (struct sockaddr*)&addr, sizeof(addr));
+ EXPECT_EQ(0, udprc) << "Failed to bind AF_INET6 to UDP port " << udpport_;
+ // retrieve system-assigned port
+ if (udpport_ == dynamic_port) {
+ ares_socklen_t len = sizeof(addr);
+ auto result = getsockname(udpfd_, (struct sockaddr*)&addr, &len);
+ EXPECT_EQ(0, result);
+ udpport_ = ntohs(addr.sin6_port);
+ EXPECT_NE(dynamic_port, udpport_);
+ }
+ if (tcpport_ == dynamic_port) {
+ ares_socklen_t len = sizeof(addr);
+ auto result = getsockname(tcpfd_, (struct sockaddr*)&addr, &len);
+ EXPECT_EQ(0, result);
+ tcpport_ = ntohs(addr.sin6_port);
+ EXPECT_NE(dynamic_port, tcpport_);
+ }
+ }
+ if (verbose) std::cerr << "Configured "
+ << (family == AF_INET ? "IPv4" : "IPv6")
+ << " mock server with TCP socket " << tcpfd_
+ << " on port " << tcpport_
+ << " and UDP socket " << udpfd_
+ << " on port " << udpport_ << std::endl;
+
+ // For TCP, also need to listen for connections.
+ EXPECT_EQ(0, listen(tcpfd_, 5)) << "Failed to listen for TCP connections";
+}
+
+MockServer::~MockServer() {
+ for (ares_socket_t fd : connfds_) {
+ sclose(fd);
+ }
+ sclose(tcpfd_);
+ sclose(udpfd_);
+ free(tcp_data_);
+}
+
+void MockServer::ProcessPacket(ares_socket_t fd, struct sockaddr_storage *addr, ares_socklen_t addrlen,
+ byte *data, int len) {
+
+ // Assume the packet is a well-formed DNS request and extract the request
+ // details.
+ if (len < NS_HFIXEDSZ) {
+ std::cerr << "Packet too short (" << len << ")" << std::endl;
+ return;
+ }
+ int qid = DNS_HEADER_QID(data);
+ if (DNS_HEADER_QR(data) != 0) {
+ std::cerr << "Not a request" << std::endl;
+ return;
+ }
+ if (DNS_HEADER_OPCODE(data) != O_QUERY) {
+ std::cerr << "Not a query (opcode " << DNS_HEADER_OPCODE(data)
+ << ")" << std::endl;
+ return;
+ }
+ if (DNS_HEADER_QDCOUNT(data) != 1) {
+ std::cerr << "Unexpected question count (" << DNS_HEADER_QDCOUNT(data)
+ << ")" << std::endl;
+ return;
+ }
+ byte* question = data + NS_HFIXEDSZ;
+ int qlen = len - NS_HFIXEDSZ;
+
+ char *name = nullptr;
+ long enclen;
+ ares_expand_name(question, data, len, &name, &enclen);
+ if (!name) {
+ std::cerr << "Failed to retrieve name" << std::endl;
+ return;
+ }
+ if (enclen > qlen) {
+ std::cerr << "(error, encoded name len " << enclen << "bigger than remaining data " << qlen << " bytes)" << std::endl;
+ return;
+ }
+ qlen -= (int)enclen;
+ question += enclen;
+ std::string namestr(name);
+ ares_free_string(name);
+
+ if (qlen < 4) {
+ std::cerr << "Unexpected question size (" << qlen
+ << " bytes after name)" << std::endl;
+ return;
+ }
+ if (DNS_QUESTION_CLASS(question) != C_IN) {
+ std::cerr << "Unexpected question class (" << DNS_QUESTION_CLASS(question)
+ << ")" << std::endl;
+ return;
+ }
+ int rrtype = DNS_QUESTION_TYPE(question);
+
+ if (verbose) {
+ std::vector<byte> req(data, data + len);
+ std::cerr << "received " << (fd == udpfd_ ? "UDP" : "TCP") << " request " << PacketToString(req)
+ << " on port " << (fd == udpfd_ ? udpport_ : tcpport_) << std::endl;
+ std::cerr << "ProcessRequest(" << qid << ", '" << namestr
+ << "', " << RRTypeToString(rrtype) << ")" << std::endl;
+ }
+ ProcessRequest(fd, addr, addrlen, qid, namestr, rrtype);
+
+}
+
+void MockServer::ProcessFD(ares_socket_t fd) {
+ if (fd != tcpfd_ && fd != udpfd_ && connfds_.find(fd) == connfds_.end()) {
+ // Not one of our FDs.
+ return;
+ }
+ if (fd == tcpfd_) {
+ ares_socket_t connfd = accept(tcpfd_, NULL, NULL);
+ if (connfd < 0) {
+ std::cerr << "Error accepting connection on fd " << fd << std::endl;
+ } else {
+ connfds_.insert(connfd);
+ }
+ return;
+ }
+
+ // Activity on a data-bearing file descriptor.
+ struct sockaddr_storage addr;
+ socklen_t addrlen = sizeof(addr);
+ byte buffer[2048];
+ ares_ssize_t len = (ares_ssize_t)recvfrom(fd, BYTE_CAST buffer, sizeof(buffer), 0,
+ (struct sockaddr *)&addr, &addrlen);
+
+ if (fd != udpfd_) {
+ if (len <= 0) {
+ connfds_.erase(std::find(connfds_.begin(), connfds_.end(), fd));
+ sclose(fd);
+ free(tcp_data_);
+ tcp_data_ = NULL;
+ tcp_data_len_ = 0;
+ return;
+ }
+ tcp_data_ = (unsigned char *)realloc(tcp_data_, tcp_data_len_ + (size_t)len);
+ memcpy(tcp_data_ + tcp_data_len_, buffer, (size_t)len);
+ tcp_data_len_ += (size_t)len;
+
+ /* TCP might aggregate the various requests into a single packet, so we
+ * need to split */
+ while (tcp_data_len_ > 2) {
+ size_t tcplen = ((size_t)tcp_data_[0] << 8) + (size_t)tcp_data_[1];
+ if (tcp_data_len_ - 2 < tcplen)
+ break;
+
+ ProcessPacket(fd, &addr, addrlen, tcp_data_ + 2, (int)tcplen);
+
+ /* strip off processed data if connection not terminated */
+ if (tcp_data_ != NULL) {
+ memmove(tcp_data_, tcp_data_ + tcplen + 2, tcp_data_len_ - 2 - tcplen);
+ tcp_data_len_ -= 2 + tcplen;
+ }
+ }
+ } else {
+ /* UDP is always a single packet */
+ ProcessPacket(fd, &addr, addrlen, buffer, (int)len);
+ }
+
+}
+
+std::set<ares_socket_t> MockServer::fds() const {
+ std::set<ares_socket_t> result = connfds_;
+ result.insert(tcpfd_);
+ result.insert(udpfd_);
+ return result;
+}
+
+void MockServer::ProcessRequest(ares_socket_t fd, struct sockaddr_storage* addr, ares_socklen_t addrlen,
+ int qid, const std::string& name, int rrtype) {
+ // Before processing, let gMock know the request is happening.
+ OnRequest(name, rrtype);
+
+ if (reply_.size() == 0) {
+ return;
+ }
+
+ // Make a local copy of the current pending reply.
+ std::vector<byte> reply = reply_;
+
+ if (qid_ >= 0) {
+ // Use the explicitly specified query ID.
+ qid = qid_;
+ }
+ if (reply.size() >= 2) {
+ // Overwrite the query ID if space to do so.
+ reply[0] = (byte)((qid >> 8) & 0xff);
+ reply[1] = (byte)(qid & 0xff);
+ }
+ if (verbose) std::cerr << "sending reply " << PacketToString(reply)
+ << " on port " << ((fd == udpfd_) ? udpport_ : tcpport_) << std::endl;
+
+ // Prefix with 2-byte length if TCP.
+ if (fd != udpfd_) {
+ int len = (int)reply.size();
+ std::vector<byte> vlen = {(byte)((len & 0xFF00) >> 8), (byte)(len & 0xFF)};
+ reply.insert(reply.begin(), vlen.begin(), vlen.end());
+ // Also, don't bother with the destination address.
+ addr = nullptr;
+ addrlen = 0;
+ }
+
+ ares_ssize_t rc = (ares_ssize_t)sendto(fd, BYTE_CAST reply.data(), (SEND_TYPE_ARG3)reply.size(), 0,
+ (struct sockaddr *)addr, addrlen);
+ if (rc < static_cast<ares_ssize_t>(reply.size())) {
+ std::cerr << "Failed to send full reply, rc=" << rc << std::endl;
+ }
+}
+
+// static
+MockChannelOptsTest::NiceMockServers MockChannelOptsTest::BuildServers(int count, int family, unsigned short base_port) {
+ NiceMockServers servers;
+ assert(count > 0);
+ for (unsigned short ii = 0; ii < count; ii++) {
+ unsigned short port = base_port == dynamic_port ? dynamic_port : base_port + ii;
+ std::unique_ptr<NiceMockServer> server(new NiceMockServer(family, port));
+ servers.push_back(std::move(server));
+ }
+ return servers;
+}
+
+MockChannelOptsTest::MockChannelOptsTest(int count,
+ int family,
+ bool force_tcp,
+ struct ares_options* givenopts,
+ int optmask)
+ : servers_(BuildServers(count, family, mock_port)),
+ server_(*servers_[0].get()), channel_(nullptr) {
+ // Set up channel options.
+ struct ares_options opts;
+ if (givenopts) {
+ memcpy(&opts, givenopts, sizeof(opts));
+ } else {
+ memset(&opts, 0, sizeof(opts));
+ }
+
+ // Point the library at the first mock server by default (overridden below).
+ opts.udp_port = server_.udpport();
+ optmask |= ARES_OPT_UDP_PORT;
+ opts.tcp_port = server_.tcpport();
+ optmask |= ARES_OPT_TCP_PORT;
+
+ // If not already overridden, set short-ish timeouts.
+ if (!(optmask & (ARES_OPT_TIMEOUTMS|ARES_OPT_TIMEOUT))) {
+ opts.timeout = 1500;
+ optmask |= ARES_OPT_TIMEOUTMS;
+ }
+ // If not already overridden, set 3 retries.
+ if (!(optmask & ARES_OPT_TRIES)) {
+ opts.tries = 3;
+ optmask |= ARES_OPT_TRIES;
+ }
+ // If not already overridden, set search domains.
+ const char *domains[3] = {"first.com", "second.org", "third.gov"};
+ if (!(optmask & ARES_OPT_DOMAINS)) {
+ opts.ndomains = 3;
+ opts.domains = (char**)domains;
+ optmask |= ARES_OPT_DOMAINS;
+ }
+ if (force_tcp) {
+ opts.flags |= ARES_FLAG_USEVC;
+ optmask |= ARES_OPT_FLAGS;
+ }
+
+ EXPECT_EQ(ARES_SUCCESS, ares_init_options(&channel_, &opts, optmask));
+ EXPECT_NE(nullptr, channel_);
+
+ // Set up servers after construction so we can set individual ports
+ struct ares_addr_port_node* prev = nullptr;
+ struct ares_addr_port_node* first = nullptr;
+ for (const auto& server : servers_) {
+ struct ares_addr_port_node* node = (struct ares_addr_port_node*)malloc(sizeof(*node));
+ if (prev) {
+ prev->next = node;
+ } else {
+ first = node;
+ }
+ node->next = nullptr;
+ node->family = family;
+ node->udp_port = server->udpport();
+ node->tcp_port = server->tcpport();
+ if (family == AF_INET) {
+ node->addr.addr4.s_addr = htonl(0x7F000001);
+ } else {
+ memset(&node->addr.addr6, 0, sizeof(node->addr.addr6));
+ node->addr.addr6._S6_un._S6_u8[15] = 1;
+ }
+ prev = node;
+ }
+ EXPECT_EQ(ARES_SUCCESS, ares_set_servers_ports(channel_, first));
+
+ while (first) {
+ prev = first;
+ first = first->next;
+ free(prev);
+ }
+ if (verbose) {
+ std::cerr << "Configured library with servers:";
+ std::cerr << GetNameServers(channel_);
+ std::cerr << std::endl;
+ }
+}
+
+MockChannelOptsTest::~MockChannelOptsTest() {
+ if (channel_) {
+ ares_destroy(channel_);
+ }
+ channel_ = nullptr;
+}
+
+std::set<ares_socket_t> MockChannelOptsTest::fds() const {
+ std::set<ares_socket_t> fds;
+ for (const auto& server : servers_) {
+ std::set<ares_socket_t> serverfds = server->fds();
+ fds.insert(serverfds.begin(), serverfds.end());
+ }
+ return fds;
+}
+
+void MockChannelOptsTest::ProcessFD(ares_socket_t fd) {
+ for (auto& server : servers_) {
+ server->ProcessFD(fd);
+ }
+}
+
+void MockChannelOptsTest::Process(unsigned int cancel_ms) {
+ using namespace std::placeholders;
+ ProcessWork(channel_,
+ std::bind(&MockChannelOptsTest::fds, this),
+ std::bind(&MockChannelOptsTest::ProcessFD, this, _1),
+ cancel_ms);
+}
+
+std::ostream& operator<<(std::ostream& os, const HostResult& result) {
+ os << '{';
+ if (result.done_) {
+ os << StatusToString(result.status_);
+ if (result.host_.addrtype_ != -1) {
+ os << " " << result.host_;
+ } else {
+ os << ", (no hostent)";
+ }
+ } else {
+ os << "(incomplete)";
+ }
+ os << '}';
+ return os;
+}
+
+HostEnt::HostEnt(const struct hostent *hostent) : addrtype_(-1) {
+ if (!hostent)
+ return;
+
+ if (hostent->h_name)
+ name_ = hostent->h_name;
+
+ if (hostent->h_aliases) {
+ char** palias = hostent->h_aliases;
+ while (*palias != nullptr) {
+ aliases_.push_back(*palias);
+ palias++;
+ }
+ }
+
+ addrtype_ = hostent->h_addrtype;
+
+ if (hostent->h_addr_list) {
+ char** paddr = hostent->h_addr_list;
+ while (*paddr != nullptr) {
+ std::string addr = AddressToString(*paddr, hostent->h_length);
+ addrs_.push_back(addr);
+ paddr++;
+ }
+ }
+}
+
+std::ostream& operator<<(std::ostream& os, const HostEnt& host) {
+ os << "{'";
+ if (host.name_.length() > 0) {
+ os << host.name_;
+ }
+ os << "' aliases=[";
+ for (size_t ii = 0; ii < host.aliases_.size(); ii++) {
+ if (ii > 0) os << ", ";
+ os << host.aliases_[ii];
+ }
+ os << "] ";
+ os << "addrs=[";
+ for (size_t ii = 0; ii < host.addrs_.size(); ii++) {
+ if (ii > 0) os << ", ";
+ os << host.addrs_[ii];
+ }
+ os << "]";
+ os << '}';
+ return os;
+}
+
+void HostCallback(void *data, int status, int timeouts,
+ struct hostent *hostent) {
+ EXPECT_NE(nullptr, data);
+ if (data == nullptr)
+ return;
+
+ HostResult* result = reinterpret_cast<HostResult*>(data);
+ result->done_ = true;
+ result->status_ = status;
+ result->timeouts_ = timeouts;
+ if (hostent)
+ result->host_ = HostEnt(hostent);
+ if (verbose) std::cerr << "HostCallback(" << *result << ")" << std::endl;
+}
+
+std::ostream& operator<<(std::ostream& os, const AddrInfoResult& result) {
+ os << '{';
+ if (result.done_ && result.ai_) {
+ os << StatusToString(result.status_) << " " << result.ai_;
+ } else {
+ os << "(incomplete)";
+ }
+ os << '}';
+ return os;
+}
+
+std::ostream& operator<<(std::ostream& os, const AddrInfo& ai) {
+ os << '{';
+ if (ai == nullptr) {
+ os << "nullptr}";
+ return os;
+ }
+
+ struct ares_addrinfo_cname *next_cname = ai->cnames;
+ while(next_cname) {
+ if(next_cname->alias) {
+ os << next_cname->alias << "->";
+ }
+ if(next_cname->name) {
+ os << next_cname->name;
+ }
+ if((next_cname = next_cname->next))
+ os << ", ";
+ else
+ os << " ";
+ }
+
+ struct ares_addrinfo_node *next = ai->nodes;
+ while(next) {
+ //if(next->ai_canonname) {
+ //os << "'" << next->ai_canonname << "' ";
+ //}
+ unsigned short port = 0;
+ os << "addr=[";
+ if(next->ai_family == AF_INET) {
+ sockaddr_in* sin = (sockaddr_in *)((void *)next->ai_addr);
+ port = ntohs(sin->sin_port);
+ os << AddressToString(&sin->sin_addr, 4);
+ }
+ else if (next->ai_family == AF_INET6) {
+ sockaddr_in6* sin = (sockaddr_in6*)((void *)next->ai_addr);
+ port = ntohs(sin->sin6_port);
+ os << "[" << AddressToString(&sin->sin6_addr, 16) << "]";
+ }
+ else
+ os << "unknown family";
+ if(port) {
+ os << ":" << port;
+ }
+ os << "]";
+ if((next = next->ai_next))
+ os << ", ";
+ }
+ os << '}';
+ return os;
+}
+
+void AddrInfoCallback(void *data, int status, int timeouts,
+ struct ares_addrinfo *ai) {
+ EXPECT_NE(nullptr, data);
+ AddrInfoResult* result = reinterpret_cast<AddrInfoResult*>(data);
+ result->done_ = true;
+ result->status_ = status;
+ result->timeouts_= timeouts;
+ if (ai)
+ result->ai_ = AddrInfo(ai);
+ if (verbose) std::cerr << "AddrInfoCallback(" << *result << ")" << std::endl;
+}
+
+std::ostream& operator<<(std::ostream& os, const SearchResult& result) {
+ os << '{';
+ if (result.done_) {
+ os << StatusToString(result.status_) << " " << PacketToString(result.data_);
+ } else {
+ os << "(incomplete)";
+ }
+ os << '}';
+ return os;
+}
+
+void SearchCallback(void *data, int status, int timeouts,
+ unsigned char *abuf, int alen) {
+ EXPECT_NE(nullptr, data);
+ SearchResult* result = reinterpret_cast<SearchResult*>(data);
+ result->done_ = true;
+ result->status_ = status;
+ result->timeouts_ = timeouts;
+ result->data_.assign(abuf, abuf + alen);
+ if (verbose) std::cerr << "SearchCallback(" << *result << ")" << std::endl;
+}
+
+std::ostream& operator<<(std::ostream& os, const NameInfoResult& result) {
+ os << '{';
+ if (result.done_) {
+ os << StatusToString(result.status_) << " " << result.node_ << " " << result.service_;
+ } else {
+ os << "(incomplete)";
+ }
+ os << '}';
+ return os;
+}
+
+void NameInfoCallback(void *data, int status, int timeouts,
+ char *node, char *service) {
+ EXPECT_NE(nullptr, data);
+ NameInfoResult* result = reinterpret_cast<NameInfoResult*>(data);
+ result->done_ = true;
+ result->status_ = status;
+ result->timeouts_ = timeouts;
+ result->node_ = std::string(node ? node : "");
+ result->service_ = std::string(service ? service : "");
+ if (verbose) std::cerr << "NameInfoCallback(" << *result << ")" << std::endl;
+}
+
+std::string GetNameServers(ares_channel_t *channel) {
+ char *csv = ares_get_servers_csv(channel);
+ EXPECT_NE((char *)NULL, csv);
+
+ std::string servers(csv);
+
+ ares_free_string(csv);
+ return servers;
+}
+
+TransientDir::TransientDir(const std::string& dirname) : dirname_(dirname) {
+ if (mkdir_(dirname_.c_str(), 0755) != 0) {
+ std::cerr << "Failed to create subdirectory '" << dirname_ << "'" << std::endl;
+ }
+}
+
+TransientDir::~TransientDir() {
+ rmdir(dirname_.c_str());
+}
+
+TransientFile::TransientFile(const std::string& filename,
+ const std::string& contents)
+ : filename_(filename) {
+ FILE *f = fopen(filename.c_str(), "w");
+ if (f == nullptr) {
+ std::cerr << "Error: failed to create '" << filename << "'" << std::endl;
+ return;
+ }
+ size_t rc = (size_t)fwrite(contents.data(), 1, contents.size(), f);
+ if (rc != contents.size()) {
+ std::cerr << "Error: failed to write contents of '" << filename << "'" << std::endl;
+ }
+ fclose(f);
+}
+
+TransientFile::~TransientFile() {
+ unlink(filename_.c_str());
+}
+
+std::string TempNam(const char *dir, const char *prefix) {
+ char *p = tempnam(dir, prefix);
+ std::string result(p);
+ free(p);
+ return result;
+}
+
+TempFile::TempFile(const std::string& contents)
+ : TransientFile(TempNam(nullptr, "ares"), contents) {
+
+}
+
+VirtualizeIO::VirtualizeIO(ares_channel_t *c)
+ : channel_(c)
+{
+ ares_set_socket_functions(channel_, &default_functions, 0);
+}
+
+VirtualizeIO::~VirtualizeIO() {
+ ares_set_socket_functions(channel_, 0, 0);
+}
+
+} // namespace test
+} // namespace ares
diff --git a/subprojects/c-ares/test/ares-test.h b/subprojects/c-ares/test/ares-test.h
@@ -0,0 +1,647 @@
+/*
+ * Copyright (C) The c-ares project
+ *
+ * Permission to use, copy, modify, and distribute this
+ * software and its documentation for any purpose and without
+ * fee is hereby granted, provided that the above copyright
+ * notice appear in all copies and that both that copyright
+ * notice and this permission notice appear in supporting
+ * documentation, and that the name of M.I.T. not be used in
+ * advertising or publicity pertaining to distribution of the
+ * software without specific, written prior permission.
+ * M.I.T. makes no representations about the suitability of
+ * this software for any purpose. It is provided "as is"
+ * without express or implied warranty.
+ *
+ * SPDX-License-Identifier: MIT
+ */
+// -*- mode: c++ -*-
+#ifndef ARES_TEST_H
+#define ARES_TEST_H
+
+#include "ares_setup.h"
+#ifdef HAVE_CONFIG_H
+#include "ares_config.h"
+#endif
+
+#include "dns-proto.h"
+// Include ares internal file for DNS protocol constants
+#include "ares_nameser.h"
+
+#include "gtest/gtest.h"
+#include "gmock/gmock.h"
+
+#if defined(HAVE_USER_NAMESPACE) && defined(HAVE_UTS_NAMESPACE)
+# define HAVE_CONTAINER
+#endif
+
+#include <functional>
+#include <list>
+#include <map>
+#include <memory>
+#include <set>
+#include <string>
+#include <utility>
+#include <vector>
+
+namespace ares {
+
+typedef unsigned char byte;
+
+namespace test {
+
+extern bool verbose;
+extern unsigned short mock_port;
+extern const std::vector<int> both_families;
+extern const std::vector<int> ipv4_family;
+extern const std::vector<int> ipv6_family;
+
+extern const std::vector<std::pair<int, bool>> both_families_both_modes;
+extern const std::vector<std::pair<int, bool>> ipv4_family_both_modes;
+extern const std::vector<std::pair<int, bool>> ipv6_family_both_modes;
+
+// Which parameters to use in tests
+extern std::vector<int> families;
+extern std::vector<std::pair<int, bool>> families_modes;
+
+// Process all pending work on ares-owned file descriptors, plus
+// optionally the given set-of-FDs + work function.
+void ProcessWork(ares_channel_t *channel,
+ std::function<std::set<ares_socket_t>()> get_extrafds,
+ std::function<void(ares_socket_t)> process_extra,
+ unsigned int cancel_ms = 0);
+std::set<ares_socket_t> NoExtraFDs();
+
+// Test fixture that ensures library initialization, and allows
+// memory allocations to be failed.
+class LibraryTest : public ::testing::Test {
+public:
+ LibraryTest()
+ {
+ EXPECT_EQ(ARES_SUCCESS, ares_library_init_mem(
+ ARES_LIB_INIT_ALL, &LibraryTest::amalloc,
+ &LibraryTest::afree, &LibraryTest::arealloc));
+ }
+
+ ~LibraryTest()
+ {
+ ares_library_cleanup();
+ ClearFails();
+ }
+
+ // Set the n-th malloc call (of any size) from the library to fail.
+ // (nth == 1 means the next call)
+ static void SetAllocFail(int nth);
+ // Set the next malloc call for the given size to fail.
+ static void SetAllocSizeFail(size_t size);
+ // Remove any pending alloc failures.
+ static void ClearFails();
+
+ static void *amalloc(size_t size);
+ static void *arealloc(void *ptr, size_t size);
+ static void afree(void *ptr);
+
+private:
+ static bool ShouldAllocFail(size_t size);
+ static unsigned long long fails_;
+ static std::map<size_t, int> size_fails_;
+};
+
+// Test fixture that uses a default channel.
+class DefaultChannelTest : public LibraryTest {
+public:
+ DefaultChannelTest() : channel_(nullptr)
+ {
+ /* Enable query cache for live tests */
+ struct ares_options opts;
+ memset(&opts, 0, sizeof(opts));
+ opts.qcache_max_ttl = 300;
+ int optmask = ARES_OPT_QUERY_CACHE;
+ EXPECT_EQ(ARES_SUCCESS, ares_init_options(&channel_, &opts, optmask));
+ EXPECT_NE(nullptr, channel_);
+ }
+
+ ~DefaultChannelTest()
+ {
+ ares_destroy(channel_);
+ channel_ = nullptr;
+ }
+
+ // Process all pending work on ares-owned file descriptors.
+ void Process(unsigned int cancel_ms = 0);
+
+protected:
+ ares_channel_t *channel_;
+};
+
+// Test fixture that uses a file-only channel.
+class FileChannelTest : public LibraryTest {
+public:
+ FileChannelTest() : channel_(nullptr)
+ {
+ struct ares_options opts;
+ memset(&opts, 0, sizeof(opts));
+ opts.lookups = strdup("f");
+ int optmask = ARES_OPT_LOOKUPS;
+ EXPECT_EQ(ARES_SUCCESS, ares_init_options(&channel_, &opts, optmask));
+ EXPECT_NE(nullptr, channel_);
+ free(opts.lookups);
+ }
+
+ ~FileChannelTest()
+ {
+ ares_destroy(channel_);
+ channel_ = nullptr;
+ }
+
+ // Process all pending work on ares-owned file descriptors.
+ void Process(unsigned int cancel_ms = 0);
+
+protected:
+ ares_channel_t *channel_;
+};
+
+// Test fixture that uses a default channel with the specified lookup mode.
+class DefaultChannelModeTest
+ : public LibraryTest,
+ public ::testing::WithParamInterface<std::string> {
+public:
+ DefaultChannelModeTest() : channel_(nullptr)
+ {
+ struct ares_options opts;
+ memset(&opts, 0, sizeof(opts));
+ opts.lookups = strdup(GetParam().c_str());
+ int optmask = ARES_OPT_LOOKUPS;
+ EXPECT_EQ(ARES_SUCCESS, ares_init_options(&channel_, &opts, optmask));
+ EXPECT_NE(nullptr, channel_);
+ free(opts.lookups);
+ }
+
+ ~DefaultChannelModeTest()
+ {
+ ares_destroy(channel_);
+ channel_ = nullptr;
+ }
+
+ // Process all pending work on ares-owned file descriptors.
+ void Process(unsigned int cancel_ms = 0);
+
+protected:
+ ares_channel_t *channel_;
+};
+
+// Mock DNS server to allow responses to be scripted by tests.
+class MockServer {
+public:
+ MockServer(int family, unsigned short port);
+ ~MockServer();
+
+ // Mock method indicating the processing of a particular <name, RRtype>
+ // request.
+ MOCK_METHOD2(OnRequest, void(const std::string &name, int rrtype));
+
+ // Set the reply to be sent next; the query ID field will be overwritten
+ // with the value from the request.
+ void SetReplyData(const std::vector<byte> &reply)
+ {
+ reply_ = reply;
+ }
+
+ void SetReply(const DNSPacket *reply)
+ {
+ SetReplyData(reply->data());
+ }
+
+ void SetReplyQID(int qid)
+ {
+ qid_ = qid;
+ }
+
+ void Disconnect()
+ {
+ for (ares_socket_t fd : connfds_) {
+ sclose(fd);
+ }
+ connfds_.clear();
+ free(tcp_data_);
+ tcp_data_ = NULL;
+ tcp_data_len_ = 0;
+ }
+
+ // The set of file descriptors that the server handles.
+ std::set<ares_socket_t> fds() const;
+
+ // Process activity on a file descriptor.
+ void ProcessFD(ares_socket_t fd);
+
+ // Ports the server is responding to
+ unsigned short udpport() const
+ {
+ return udpport_;
+ }
+
+ unsigned short tcpport() const
+ {
+ return tcpport_;
+ }
+
+private:
+ void ProcessRequest(ares_socket_t fd, struct sockaddr_storage *addr,
+ ares_socklen_t addrlen, int qid, const std::string &name,
+ int rrtype);
+ void ProcessPacket(ares_socket_t fd, struct sockaddr_storage *addr,
+ ares_socklen_t addrlen, byte *data, int len);
+ unsigned short udpport_;
+ unsigned short tcpport_;
+ ares_socket_t udpfd_;
+ ares_socket_t tcpfd_;
+ std::set<ares_socket_t> connfds_;
+ std::vector<byte> reply_;
+ int qid_;
+ unsigned char *tcp_data_;
+ size_t tcp_data_len_;
+};
+
+// Test fixture that uses a mock DNS server.
+class MockChannelOptsTest : public LibraryTest {
+public:
+ MockChannelOptsTest(int count, int family, bool force_tcp,
+ struct ares_options *givenopts, int optmask);
+ ~MockChannelOptsTest();
+
+ // Process all pending work on ares-owned and mock-server-owned file
+ // descriptors.
+ void Process(unsigned int cancel_ms = 0);
+
+protected:
+ // NiceMockServer doesn't complain about uninteresting calls.
+ typedef testing::NiceMock<MockServer> NiceMockServer;
+ typedef std::vector<std::unique_ptr<NiceMockServer>> NiceMockServers;
+
+ std::set<ares_socket_t> fds() const;
+ void ProcessFD(ares_socket_t fd);
+
+ static NiceMockServers BuildServers(int count, int family,
+ unsigned short base_port);
+
+ NiceMockServers servers_;
+ // Convenience reference to first server.
+ NiceMockServer &server_;
+ ares_channel_t *channel_;
+};
+
+class MockChannelTest
+ : public MockChannelOptsTest,
+ public ::testing::WithParamInterface<std::pair<int, bool>> {
+public:
+ MockChannelTest()
+ : MockChannelOptsTest(1, GetParam().first, GetParam().second, nullptr, 0)
+ {
+ }
+};
+
+class MockUDPChannelTest : public MockChannelOptsTest,
+ public ::testing::WithParamInterface<int> {
+public:
+ MockUDPChannelTest() : MockChannelOptsTest(1, GetParam(), false, nullptr, 0)
+ {
+ }
+};
+
+class MockTCPChannelTest : public MockChannelOptsTest,
+ public ::testing::WithParamInterface<int> {
+public:
+ MockTCPChannelTest() : MockChannelOptsTest(1, GetParam(), true, nullptr, 0)
+ {
+ }
+};
+
+// gMock action to set the reply for a mock server.
+ACTION_P2(SetReplyData, mockserver, data)
+{
+ mockserver->SetReplyData(data);
+}
+
+ACTION_P2(SetReply, mockserver, reply)
+{
+ mockserver->SetReply(reply);
+}
+
+ACTION_P2(SetReplyQID, mockserver, qid)
+{
+ mockserver->SetReplyQID(qid);
+}
+
+// gMock action to cancel a channel.
+ACTION_P2(CancelChannel, mockserver, channel)
+{
+ ares_cancel(channel);
+}
+
+// gMock action to disconnect all connections.
+ACTION_P(Disconnect, mockserver)
+{
+ mockserver->Disconnect();
+}
+
+// C++ wrapper for struct hostent.
+struct HostEnt {
+ HostEnt() : addrtype_(-1)
+ {
+ }
+
+ HostEnt(const struct hostent *hostent);
+ std::string name_;
+ std::vector<std::string> aliases_;
+ int addrtype_; // AF_INET or AF_INET6
+ std::vector<std::string> addrs_;
+};
+
+std::ostream &operator<<(std::ostream &os, const HostEnt &result);
+
+// Structure that describes the result of an ares_host_callback invocation.
+struct HostResult {
+ HostResult() : done_(false), status_(0), timeouts_(0)
+ {
+ }
+
+ // Whether the callback has been invoked.
+ bool done_;
+ // Explicitly provided result information.
+ int status_;
+ int timeouts_;
+ // Contents of the hostent structure, if provided.
+ HostEnt host_;
+};
+
+std::ostream &operator<<(std::ostream &os, const HostResult &result);
+
+// Structure that describes the result of an ares_callback invocation.
+struct SearchResult {
+ // Whether the callback has been invoked.
+ bool done_;
+ // Explicitly provided result information.
+ int status_;
+ int timeouts_;
+ std::vector<byte> data_;
+};
+
+std::ostream &operator<<(std::ostream &os, const SearchResult &result);
+
+// Structure that describes the result of an ares_nameinfo_callback invocation.
+struct NameInfoResult {
+ // Whether the callback has been invoked.
+ bool done_;
+ // Explicitly provided result information.
+ int status_;
+ int timeouts_;
+ std::string node_;
+ std::string service_;
+};
+
+std::ostream &operator<<(std::ostream &os, const NameInfoResult &result);
+
+struct AddrInfoDeleter {
+ void operator()(ares_addrinfo *ptr)
+ {
+ if (ptr) {
+ ares_freeaddrinfo(ptr);
+ }
+ }
+};
+
+// C++ wrapper for struct ares_addrinfo.
+using AddrInfo = std::unique_ptr<ares_addrinfo, AddrInfoDeleter>;
+
+std::ostream &operator<<(std::ostream &os, const AddrInfo &result);
+
+// Structure that describes the result of an ares_addrinfo_callback invocation.
+struct AddrInfoResult {
+ AddrInfoResult() : done_(false), status_(-1), timeouts_(0)
+ {
+ }
+
+ // Whether the callback has been invoked.
+ bool done_;
+ // Explicitly provided result information.
+ int status_;
+ int timeouts_;
+ // Contents of the ares_addrinfo structure, if provided.
+ AddrInfo ai_;
+};
+
+std::ostream &operator<<(std::ostream &os, const AddrInfoResult &result);
+
+// Standard implementation of ares callbacks that fill out the corresponding
+// structures.
+void HostCallback(void *data, int status, int timeouts,
+ struct hostent *hostent);
+void SearchCallback(void *data, int status, int timeouts, unsigned char *abuf,
+ int alen);
+void NameInfoCallback(void *data, int status, int timeouts, char *node,
+ char *service);
+void AddrInfoCallback(void *data, int status, int timeouts,
+ struct ares_addrinfo *res);
+
+// Retrieve the name servers used by a channel.
+std::string GetNameServers(ares_channel_t *channel);
+
+// RAII class to temporarily create a directory of a given name.
+class TransientDir {
+public:
+ TransientDir(const std::string &dirname);
+ ~TransientDir();
+
+private:
+ std::string dirname_;
+};
+
+// C++ wrapper around tempnam()
+std::string TempNam(const char *dir, const char *prefix);
+
+// RAII class to temporarily create file of a given name and contents.
+class TransientFile {
+public:
+ TransientFile(const std::string &filename, const std::string &contents);
+ ~TransientFile();
+
+protected:
+ std::string filename_;
+};
+
+// RAII class for a temporary file with the given contents.
+class TempFile : public TransientFile {
+public:
+ TempFile(const std::string &contents);
+
+ const char *filename() const
+ {
+ return filename_.c_str();
+ }
+};
+
+#ifdef _WIN32
+extern "C" {
+
+static int setenv(const char *name, const char *value, int overwrite)
+{
+ char *buffer;
+ size_t buf_size;
+
+ if (name == NULL) {
+ return -1;
+ }
+
+ if (value == NULL) {
+ value = ""; /* For unset */
+ }
+
+ if (!overwrite && getenv(name) != NULL) {
+ return -1;
+ }
+
+ buf_size = strlen(name) + strlen(value) + 1 /* = */ + 1 /* NULL */;
+ buffer = (char *)malloc(buf_size);
+ _snprintf(buffer, buf_size, "%s=%s", name, value);
+ _putenv(buffer);
+ free(buffer);
+ return 0;
+}
+
+static int unsetenv(const char *name)
+{
+ return setenv(name, NULL, 1);
+}
+
+} /* extern "C" */
+#endif
+
+// RAII class for a temporary environment variable value.
+class EnvValue {
+public:
+ EnvValue(const char *name, const char *value) : name_(name), restore_(false)
+ {
+ char *original = getenv(name);
+ if (original) {
+ restore_ = true;
+ original_ = original;
+ }
+ setenv(name_.c_str(), value, 1);
+ }
+
+ ~EnvValue()
+ {
+ if (restore_) {
+ setenv(name_.c_str(), original_.c_str(), 1);
+ } else {
+ unsetenv(name_.c_str());
+ }
+ }
+
+private:
+ std::string name_;
+ bool restore_;
+ std::string original_;
+};
+
+
+#ifdef HAVE_CONTAINER
+// Linux-specific functionality for running code in a container, implemented
+// in ares-test-ns.cc
+typedef std::function<int(void)> VoidToIntFn;
+typedef std::vector<std::pair<std::string, std::string>> NameContentList;
+
+class ContainerFilesystem {
+public:
+ ContainerFilesystem(NameContentList files, const std::string &mountpt);
+ ~ContainerFilesystem();
+
+ std::string root() const
+ {
+ return rootdir_;
+ }
+
+ std::string mountpt() const
+ {
+ return mountpt_;
+ }
+
+private:
+ void EnsureDirExists(const std::string &dir);
+ std::string rootdir_;
+ std::string mountpt_;
+ std::list<std::string> dirs_;
+ std::vector<std::unique_ptr<TransientFile>> files_;
+};
+
+int RunInContainer(ContainerFilesystem *fs, const std::string &hostname,
+ const std::string &domainname, VoidToIntFn fn);
+
+# define ICLASS_NAME(casename, testname) Contained##casename##_##testname
+# define CONTAINED_TEST_F(casename, testname, hostname, domainname, files) \
+ class ICLASS_NAME(casename, testname) : public casename { \
+ public: \
+ ICLASS_NAME(casename, testname)() \
+ { \
+ } \
+ static int InnerTestBody(); \
+ }; \
+ TEST_F(ICLASS_NAME(casename, testname), _) \
+ { \
+ ContainerFilesystem chroot(files, ".."); \
+ VoidToIntFn fn(ICLASS_NAME(casename, testname)::InnerTestBody); \
+ EXPECT_EQ(0, RunInContainer(&chroot, hostname, domainname, fn)); \
+ } \
+ int ICLASS_NAME(casename, testname)::InnerTestBody()
+
+#endif
+
+/* Assigns virtual IO functions to a channel. These functions simply call
+ * the actual system functions.
+ */
+class VirtualizeIO {
+public:
+ VirtualizeIO(ares_channel);
+ ~VirtualizeIO();
+
+ static const ares_socket_functions default_functions;
+
+private:
+ ares_channel_t *channel_;
+};
+
+/*
+ * Slightly white-box macro to generate two runs for a given test case:
+ * One with no modifications, and one with all IO functions set to use
+ * the virtual io structure.
+ * Since no magic socket setup or anything is done in the latter case
+ * this should probably only be used for test with very vanilla IO
+ * requirements.
+ */
+#define VCLASS_NAME(casename, testname) Virt##casename##_##testname
+#define VIRT_NONVIRT_TEST_F(casename, testname) \
+ class VCLASS_NAME(casename, testname) : public casename { \
+ public: \
+ VCLASS_NAME(casename, testname)() \
+ { \
+ } \
+ void InnerTestBody(); \
+ }; \
+ GTEST_TEST_(casename, testname, VCLASS_NAME(casename, testname), \
+ ::testing::internal::GetTypeId<casename>()) \
+ { \
+ InnerTestBody(); \
+ } \
+ GTEST_TEST_(casename, testname##_virtualized, \
+ VCLASS_NAME(casename, testname), \
+ ::testing::internal::GetTypeId<casename>()) \
+ { \
+ VirtualizeIO vio(channel_); \
+ InnerTestBody(); \
+ } \
+ void VCLASS_NAME(casename, testname)::InnerTestBody()
+
+} // namespace test
+} // namespace ares
+
+#endif
diff --git a/subprojects/c-ares/test/dns-dump.cc b/subprojects/c-ares/test/dns-dump.cc
@@ -0,0 +1,57 @@
+/*
+ * Copyright (C) The c-ares project
+ *
+ * Permission to use, copy, modify, and distribute this
+ * software and its documentation for any purpose and without
+ * fee is hereby granted, provided that the above copyright
+ * notice appear in all copies and that both that copyright
+ * notice and this permission notice appear in supporting
+ * documentation, and that the name of M.I.T. not be used in
+ * advertising or publicity pertaining to distribution of the
+ * software without specific, written prior permission.
+ * M.I.T. makes no representations about the suitability of
+ * this software for any purpose. It is provided "as is"
+ * without express or implied warranty.
+ *
+ * SPDX-License-Identifier: MIT
+ */
+#include <sys/types.h>
+#include <fcntl.h>
+#ifdef _MSC_VER
+# include <io.h>
+#else
+# include <unistd.h>
+#endif
+
+#include <iostream>
+#include <vector>
+
+#include "dns-proto.h"
+
+namespace ares {
+
+static void ShowFile(const char* filename) {
+ int fd = open(filename, O_RDONLY);
+ if (fd < 0) {
+ std::cerr << "Failed to open '" << filename << "'" << std::endl;
+ return;
+ }
+ std::vector<unsigned char> contents;
+ while (true) {
+ unsigned char buffer[1024];
+ ares_ssize_t len = read(fd, buffer, sizeof(buffer));
+ if (len <= 0) break;
+ contents.insert(contents.end(), buffer, buffer + len);
+ }
+ std::cout << PacketToString(contents) << std::endl;
+}
+
+} // namespace ares
+
+int main(int argc, char* argv[]) {
+ for (int ii = 1; ii < argc; ++ii) {
+ ares::ShowFile(argv[ii]);
+ }
+ return 0;
+}
+
diff --git a/subprojects/c-ares/test/dns-proto-test.cc b/subprojects/c-ares/test/dns-proto-test.cc
@@ -0,0 +1,148 @@
+/*
+ * Copyright (C) The c-ares project
+ *
+ * Permission to use, copy, modify, and distribute this
+ * software and its documentation for any purpose and without
+ * fee is hereby granted, provided that the above copyright
+ * notice appear in all copies and that both that copyright
+ * notice and this permission notice appear in supporting
+ * documentation, and that the name of M.I.T. not be used in
+ * advertising or publicity pertaining to distribution of the
+ * software without specific, written prior permission.
+ * M.I.T. makes no representations about the suitability of
+ * this software for any purpose. It is provided "as is"
+ * without express or implied warranty.
+ *
+ * SPDX-License-Identifier: MIT
+ */
+#include "ares-test.h"
+#include "dns-proto.h"
+
+#include <vector>
+
+namespace ares {
+namespace test {
+
+TEST(DNSProto, EncodeQuestions) {
+ DNSPacket pkt;
+ pkt.set_qid(0x1234).set_response().set_aa()
+ .add_question(new DNSQuestion("example.com.", T_A))
+ .add_question(new DNSQuestion("www.example.com", T_AAAA, C_CHAOS));
+
+ std::vector<byte> data = {
+ 0x12, 0x34, // qid
+ 0x84, // response + query + AA + not-TC + not-RD
+ 0x00, // not-RA + not-Z + not-AD + not-CD + rc=NoError
+ 0x00, 0x02, // num questions
+ 0x00, 0x00, // num answer RRs
+ 0x00, 0x00, // num authority RRs
+ 0x00, 0x00, // num additional RRs
+ // Question 1
+ 0x07, 'e', 'x', 'a', 'm', 'p', 'l', 'e',
+ 0x03, 'c', 'o', 'm',
+ 0x00,
+ 0x00, 0x01, // type A
+ 0x00, 0x01, // class IN
+ // Question 2
+ 0x03, 'w', 'w', 'w',
+ 0x07, 'e', 'x', 'a', 'm', 'p', 'l', 'e',
+ 0x03, 'c', 'o', 'm',
+ 0x00,
+ 0x00, 0x1C, // type AAAA = 28
+ 0x00, 0x03, // class CHAOS = 3
+ };
+ EXPECT_EQ(data, pkt.data());
+}
+
+TEST(DNSProto, EncodeSingleNameAnswers) {
+ DNSPacket pkt;
+ pkt.qid_ = 0x1234;
+ pkt.response_ = true;
+ pkt.aa_ = true;
+ pkt.opcode_ = O_QUERY;
+ pkt.add_answer(new DNSCnameRR("example.com", 0x01020304, "other.com."));
+ pkt.add_auth(new DNSPtrRR("www.example.com", 0x01020304, "www.other.com"));
+
+ std::vector<byte> data = {
+ 0x12, 0x34, // qid
+ 0x84, // response + query + AA + not-TC + not-RD
+ 0x00, // not-RA + not-Z + not-AD + not-CD + rc=NoError
+ 0x00, 0x00, // num questions
+ 0x00, 0x01, // num answer RRs
+ 0x00, 0x01, // num authority RRs
+ 0x00, 0x00, // num additional RRs
+ // Answer 1
+ 0x07, 'e', 'x', 'a', 'm', 'p', 'l', 'e',
+ 0x03, 'c', 'o', 'm',
+ 0x00,
+ 0x00, 0x05, // RR type
+ 0x00, 0x01, // class IN
+ 0x01, 0x02, 0x03, 0x04, // TTL
+ 0x00, 0x0B, // rdata length
+ 0x05, 'o', 't', 'h', 'e', 'r',
+ 0x03, 'c', 'o', 'm',
+ 0x00,
+ // Authority 1
+ 0x03, 'w', 'w', 'w',
+ 0x07, 'e', 'x', 'a', 'm', 'p', 'l', 'e',
+ 0x03, 'c', 'o', 'm',
+ 0x00,
+ 0x00, 0x0c, // RR type
+ 0x00, 0x01, // class IN
+ 0x01, 0x02, 0x03, 0x04, // TTL
+ 0x00, 0x0F, // rdata length
+ 0x03, 'w', 'w', 'w',
+ 0x05, 'o', 't', 'h', 'e', 'r',
+ 0x03, 'c', 'o', 'm',
+ 0x00,
+ };
+ EXPECT_EQ(data, pkt.data());
+}
+
+TEST(DNSProto, EncodeAddressAnswers) {
+ DNSPacket pkt;
+ pkt.qid_ = 0x1234;
+ pkt.response_ = true;
+ pkt.aa_ = true;
+ pkt.opcode_ = O_QUERY;
+ std::vector<byte> addrv4 = {0x02, 0x03, 0x04, 0x05};
+ pkt.add_answer(new DNSARR("example.com", 0x01020304, addrv4));
+ byte addrv6[16] = {0x01, 0x01, 0x01, 0x01, 0x02, 0x02, 0x02, 0x02,
+ 0x03, 0x03, 0x03, 0x03, 0x04, 0x04, 0x04, 0x04};
+ pkt.add_additional(new DNSAaaaRR("www.example.com", 0x01020304, addrv6, 16));
+
+ std::vector<byte> data = {
+ 0x12, 0x34, // qid
+ 0x84, // response + query + AA + not-TC + not-RD
+ 0x00, // not-RA + not-Z + not-AD + not-CD + rc=NoError
+ 0x00, 0x00, // num questions
+ 0x00, 0x01, // num answer RRs
+ 0x00, 0x00, // num authority RRs
+ 0x00, 0x01, // num additional RRs
+ // Answer 1
+ 0x07, 'e', 'x', 'a', 'm', 'p', 'l', 'e',
+ 0x03, 'c', 'o', 'm',
+ 0x00,
+ 0x00, 0x01, // RR type
+ 0x00, 0x01, // class IN
+ 0x01, 0x02, 0x03, 0x04, // TTL
+ 0x00, 0x04, // rdata length
+ 0x02, 0x03, 0x04, 0x05,
+ // Additional 1
+ 0x03, 'w', 'w', 'w',
+ 0x07, 'e', 'x', 'a', 'm', 'p', 'l', 'e',
+ 0x03, 'c', 'o', 'm',
+ 0x00,
+ 0x00, 0x1c, // RR type
+ 0x00, 0x01, // class IN
+ 0x01, 0x02, 0x03, 0x04, // TTL
+ 0x00, 0x10, // rdata length
+ 0x01, 0x01, 0x01, 0x01, 0x02, 0x02, 0x02, 0x02,
+ 0x03, 0x03, 0x03, 0x03, 0x04, 0x04, 0x04, 0x04
+ };
+ EXPECT_EQ(data, pkt.data());
+}
+
+
+} // namespace test
+} // namespace ares
diff --git a/subprojects/c-ares/test/dns-proto.cc b/subprojects/c-ares/test/dns-proto.cc
@@ -0,0 +1,690 @@
+/* MIT License
+ *
+ * Copyright (c) The c-ares project and its contributors
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice (including the next
+ * paragraph) shall be included in all copies or substantial portions of the
+ * Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ *
+ * SPDX-License-Identifier: MIT
+ */
+
+// Include ares internal file for DNS protocol details
+#include "ares_setup.h"
+#include "ares.h"
+#include "ares_dns.h"
+#include "dns-proto.h"
+
+#include <stdio.h>
+#include <stdlib.h>
+
+#include <sstream>
+
+namespace ares {
+
+std::string HexDump(std::vector<byte> data) {
+ std::stringstream ss;
+ for (size_t ii = 0; ii < data.size(); ii++) {
+ char buffer[2 + 1];
+ snprintf(buffer, sizeof(buffer), "%02x", data[ii]);
+ ss << buffer;
+ }
+ return ss.str();
+}
+
+std::string HexDump(const byte *data, int len) {
+ return HexDump(std::vector<byte>(data, data + len));
+}
+
+std::string HexDump(const char *data, int len) {
+ return HexDump(reinterpret_cast<const byte*>(data), len);
+}
+
+std::string StatusToString(int status) {
+ switch (status) {
+ case ARES_SUCCESS: return "ARES_SUCCESS";
+ case ARES_ENODATA: return "ARES_ENODATA";
+ case ARES_EFORMERR: return "ARES_EFORMERR";
+ case ARES_ESERVFAIL: return "ARES_ESERVFAIL";
+ case ARES_ENOTFOUND: return "ARES_ENOTFOUND";
+ case ARES_ENOTIMP: return "ARES_ENOTIMP";
+ case ARES_EREFUSED: return "ARES_EREFUSED";
+ case ARES_EBADQUERY: return "ARES_EBADQUERY";
+ case ARES_EBADNAME: return "ARES_EBADNAME";
+ case ARES_EBADFAMILY: return "ARES_EBADFAMILY";
+ case ARES_EBADRESP: return "ARES_EBADRESP";
+ case ARES_ECONNREFUSED: return "ARES_ECONNREFUSED";
+ case ARES_ETIMEOUT: return "ARES_ETIMEOUT";
+ case ARES_EOF: return "ARES_EOF";
+ case ARES_EFILE: return "ARES_EFILE";
+ case ARES_ENOMEM: return "ARES_ENOMEM";
+ case ARES_EDESTRUCTION: return "ARES_EDESTRUCTION";
+ case ARES_EBADSTR: return "ARES_EBADSTR";
+ case ARES_EBADFLAGS: return "ARES_EBADFLAGS";
+ case ARES_ENONAME: return "ARES_ENONAME";
+ case ARES_EBADHINTS: return "ARES_EBADHINTS";
+ case ARES_ENOTINITIALIZED: return "ARES_ENOTINITIALIZED";
+ case ARES_ELOADIPHLPAPI: return "ARES_ELOADIPHLPAPI";
+ case ARES_EADDRGETNETWORKPARAMS: return "ARES_EADDRGETNETWORKPARAMS";
+ case ARES_ECANCELLED: return "ARES_ECANCELLED";
+ default: return "UNKNOWN";
+ }
+}
+
+std::string RcodeToString(int rcode) {
+ switch (rcode) {
+ case NOERROR: return "NOERROR";
+ case FORMERR: return "FORMERR";
+ case SERVFAIL: return "SERVFAIL";
+ case NXDOMAIN: return "NXDOMAIN";
+ case NOTIMP: return "NOTIMP";
+ case REFUSED: return "REFUSED";
+ case YXDOMAIN: return "YXDOMAIN";
+ case YXRRSET: return "YXRRSET";
+ case NXRRSET: return "NXRRSET";
+ case NOTAUTH: return "NOTAUTH";
+ case NOTZONE: return "NOTZONE";
+ case TSIG_BADSIG: return "BADSIG";
+ case TSIG_BADKEY: return "BADKEY";
+ case TSIG_BADTIME: return "BADTIME";
+ default: return "UNKNOWN";
+ }
+}
+
+std::string RRTypeToString(int rrtype) {
+ switch (rrtype) {
+ case T_A: return "A";
+ case T_NS: return "NS";
+ case T_MD: return "MD";
+ case T_MF: return "MF";
+ case T_CNAME: return "CNAME";
+ case T_SOA: return "SOA";
+ case T_MB: return "MB";
+ case T_MG: return "MG";
+ case T_MR: return "MR";
+ case T_NULL: return "NULL";
+ case T_WKS: return "WKS";
+ case T_PTR: return "PTR";
+ case T_HINFO: return "HINFO";
+ case T_MINFO: return "MINFO";
+ case T_MX: return "MX";
+ case T_TXT: return "TXT";
+ case T_RP: return "RP";
+ case T_AFSDB: return "AFSDB";
+ case T_X25: return "X25";
+ case T_ISDN: return "ISDN";
+ case T_RT: return "RT";
+ case T_NSAP: return "NSAP";
+ case T_NSAP_PTR: return "NSAP_PTR";
+ case T_SIG: return "SIG";
+ case T_KEY: return "KEY";
+ case T_PX: return "PX";
+ case T_GPOS: return "GPOS";
+ case T_AAAA: return "AAAA";
+ case T_LOC: return "LOC";
+ case T_NXT: return "NXT";
+ case T_EID: return "EID";
+ case T_NIMLOC: return "NIMLOC";
+ case T_SRV: return "SRV";
+ case T_ATMA: return "ATMA";
+ case T_NAPTR: return "NAPTR";
+ case T_KX: return "KX";
+ case T_CERT: return "CERT";
+ case T_A6: return "A6";
+ case T_DNAME: return "DNAME";
+ case T_SINK: return "SINK";
+ case T_OPT: return "OPT";
+ case T_APL: return "APL";
+ case T_DS: return "DS";
+ case T_SSHFP: return "SSHFP";
+ case T_RRSIG: return "RRSIG";
+ case T_NSEC: return "NSEC";
+ case T_DNSKEY: return "DNSKEY";
+ case T_TKEY: return "TKEY";
+ case T_TSIG: return "TSIG";
+ case T_IXFR: return "IXFR";
+ case T_AXFR: return "AXFR";
+ case T_MAILB: return "MAILB";
+ case T_MAILA: return "MAILA";
+ case T_ANY: return "ANY";
+ case T_URI: return "URI";
+ case T_MAX: return "MAX";
+ default: return "UNKNOWN";
+ }
+}
+
+std::string ClassToString(int qclass) {
+ switch (qclass) {
+ case C_IN: return "IN";
+ case C_CHAOS: return "CHAOS";
+ case C_HS: return "HESIOD";
+ case C_NONE: return "NONE";
+ case C_ANY: return "ANY";
+ default: return "UNKNOWN";
+ }
+}
+
+std::string AddressToString(const void* vaddr, int len) {
+ const byte* addr = reinterpret_cast<const byte*>(vaddr);
+ std::stringstream ss;
+ if (len == 4) {
+ char buffer[4*4 + 3 + 1];
+ snprintf(buffer, sizeof(buffer), "%u.%u.%u.%u",
+ (unsigned char)addr[0],
+ (unsigned char)addr[1],
+ (unsigned char)addr[2],
+ (unsigned char)addr[3]);
+ ss << buffer;
+ } else if (len == 16) {
+ for (int ii = 0; ii < 16; ii+=2) {
+ if (ii > 0) ss << ':';
+ char buffer[4 + 1];
+ snprintf(buffer, sizeof(buffer), "%02x%02x", (unsigned char)addr[ii], (unsigned char)addr[ii+1]);
+ ss << buffer;
+ }
+ } else {
+ ss << "!" << HexDump(addr, len) << "!";
+ }
+ return ss.str();
+}
+
+std::string PacketToString(const std::vector<byte>& packet) {
+ const byte* data = packet.data();
+ int len = (int)packet.size();
+ std::stringstream ss;
+ if (len < NS_HFIXEDSZ) {
+ ss << "(too short, len " << len << ")";
+ return ss.str();
+ }
+ ss << ((DNS_HEADER_QR(data) == 0) ? "REQ " : "RSP ");
+ switch (DNS_HEADER_OPCODE(data)) {
+ case O_QUERY: ss << "QRY "; break;
+ case O_IQUERY: ss << "IQRY "; break;
+ case O_STATUS: ss << "STATUS "; break;
+ case O_NOTIFY: ss << "NOTIFY "; break;
+ case O_UPDATE: ss << "UPDATE "; break;
+ default: ss << "UNKNOWN(" << DNS_HEADER_OPCODE(data) << ") "; break;
+ }
+ if (DNS_HEADER_AA(data)) ss << "AA ";
+ if (DNS_HEADER_TC(data)) ss << "TC ";
+ if (DNS_HEADER_RD(data)) ss << "RD ";
+ if (DNS_HEADER_RA(data)) ss << "RA ";
+ if (DNS_HEADER_Z(data)) ss << "Z ";
+ if (DNS_HEADER_QR(data) == 1) ss << RcodeToString(DNS_HEADER_RCODE(data));
+
+ int nquestions = DNS_HEADER_QDCOUNT(data);
+ int nanswers = DNS_HEADER_ANCOUNT(data);
+ int nauths = DNS_HEADER_NSCOUNT(data);
+ int nadds = DNS_HEADER_ARCOUNT(data);
+
+ const byte* pq = data + NS_HFIXEDSZ;
+ len -= NS_HFIXEDSZ;
+ for (int ii = 0; ii < nquestions; ii++) {
+ ss << " Q:" << QuestionToString(packet, &pq, &len);
+ }
+ const byte* prr = pq;
+ for (int ii = 0; ii < nanswers; ii++) {
+ ss << " A:" << RRToString(packet, &prr, &len);
+ }
+ for (int ii = 0; ii < nauths; ii++) {
+ ss << " AUTH:" << RRToString(packet, &prr, &len);
+ }
+ for (int ii = 0; ii < nadds; ii++) {
+ ss << " ADD:" << RRToString(packet, &prr, &len);
+ }
+ return ss.str();
+}
+
+std::string QuestionToString(const std::vector<byte>& packet,
+ const byte** data, int* len) {
+ std::stringstream ss;
+ ss << "{";
+ if (*len < NS_QFIXEDSZ) {
+ ss << "(too short, len " << *len << ")";
+ return ss.str();
+ }
+
+ char *name = nullptr;
+ long enclen;
+ int rc = ares_expand_name(*data, packet.data(), (int)packet.size(), &name, &enclen);
+ if (rc != ARES_SUCCESS) {
+ ss << "(error from ares_expand_name)";
+ return ss.str();
+ }
+ if (enclen > *len) {
+ ss << "(error, encoded name len " << enclen << "bigger than remaining data " << *len << " bytes)";
+ return ss.str();
+ }
+ *len -= (int)enclen;
+ *data += enclen;
+ ss << "'" << name << "' ";
+ ares_free_string(name);
+ if (*len < NS_QFIXEDSZ) {
+ ss << "(too short, len left " << *len << ")";
+ return ss.str();
+ }
+ ss << ClassToString(DNS_QUESTION_CLASS(*data)) << " ";
+ ss << RRTypeToString(DNS_QUESTION_TYPE(*data));
+ *data += NS_QFIXEDSZ;
+ *len -= NS_QFIXEDSZ;
+ ss << "}";
+ return ss.str();
+}
+
+std::string RRToString(const std::vector<byte>& packet,
+ const byte** data, int* len) {
+ std::stringstream ss;
+ ss << "{";
+ if (*len < NS_RRFIXEDSZ) {
+ ss << "too short, len " << *len << ")";
+ return ss.str();
+ }
+
+ char *name = nullptr;
+ long enclen;
+ int rc = ares_expand_name(*data, packet.data(), (int)packet.size(), &name, &enclen);
+ if (rc != ARES_SUCCESS) {
+ ss << "(error from ares_expand_name)";
+ return ss.str();
+ }
+ if (enclen > *len) {
+ ss << "(error, encoded name len " << enclen << "bigger than remaining data " << *len << " bytes)";
+ return ss.str();
+ }
+ *len -= (int)enclen;
+ *data += enclen;
+ ss << "'" << name << "' ";
+ ares_free_string(name);
+ name = nullptr;
+
+ if (*len < NS_RRFIXEDSZ) {
+ ss << "(too short, len left " << *len << ")";
+ return ss.str();
+ }
+ int rrtype = DNS_RR_TYPE(*data);
+ if (rrtype == T_OPT) {
+ ss << "MAXUDP=" << DNS_RR_CLASS(*data) << " ";
+ ss << RRTypeToString(rrtype) << " ";
+ ss << "RCODE2=" << DNS_RR_TTL(*data);
+ } else {
+ ss << ClassToString(DNS_RR_CLASS(*data)) << " ";
+ ss << RRTypeToString(rrtype) << " ";
+ ss << "TTL=" << DNS_RR_TTL(*data);
+ }
+ int rdatalen = DNS_RR_LEN(*data);
+
+ *data += NS_RRFIXEDSZ;
+ *len -= NS_RRFIXEDSZ;
+ if (*len < rdatalen) {
+ ss << "(RR too long at " << rdatalen << ", len left " << *len << ")";
+ } else {
+ switch (rrtype) {
+ case T_A:
+ case T_AAAA:
+ ss << " " << AddressToString(*data, rdatalen);
+ break;
+ case T_TXT: {
+ const byte* p = *data;
+ while (p < (*data + rdatalen)) {
+ int len = *p++;
+ if ((p + len) <= (*data + rdatalen)) {
+ std::string txt(p, p + len);
+ ss << " " << len << ":'" << txt << "'";
+ } else {
+ ss << "(string too long)";
+ }
+ p += len;
+ }
+ break;
+ }
+ case T_CNAME:
+ case T_NS:
+ case T_PTR: {
+ int rc = ares_expand_name(*data, packet.data(), (int)packet.size(), &name, &enclen);
+ if (rc != ARES_SUCCESS) {
+ ss << "(error from ares_expand_name)";
+ break;
+ }
+ ss << " '" << name << "'";
+ ares_free_string(name);
+ break;
+ }
+ case T_MX:
+ if (rdatalen > 2) {
+ int rc = ares_expand_name(*data + 2, packet.data(), (int)packet.size(), &name, &enclen);
+ if (rc != ARES_SUCCESS) {
+ ss << "(error from ares_expand_name)";
+ break;
+ }
+ ss << " " << DNS__16BIT(*data) << " '" << name << "'";
+ ares_free_string(name);
+ } else {
+ ss << "(RR too short)";
+ }
+ break;
+ case T_SRV: {
+ if (rdatalen > 6) {
+ const byte* p = *data;
+ unsigned long prio = DNS__16BIT(p);
+ unsigned long weight = DNS__16BIT(p + 2);
+ unsigned long port = DNS__16BIT(p + 4);
+ p += 6;
+ int rc = ares_expand_name(p, packet.data(), (int)packet.size(), &name, &enclen);
+ if (rc != ARES_SUCCESS) {
+ ss << "(error from ares_expand_name)";
+ break;
+ }
+ ss << prio << " " << weight << " " << port << " '" << name << "'";
+ ares_free_string(name);
+ } else {
+ ss << "(RR too short)";
+ }
+ break;
+ }
+ case T_URI: {
+ if (rdatalen > 4) {
+ const byte* p = *data;
+ unsigned long prio = DNS__16BIT(p);
+ unsigned long weight = DNS__16BIT(p + 2);
+ p += 4;
+ std::string uri(p, p + (rdatalen - 4));
+ ss << prio << " " << weight << " '" << uri << "'";
+ } else {
+ ss << "(RR too short)";
+ }
+ break;
+ }
+ case T_SOA: {
+ const byte* p = *data;
+ int rc = ares_expand_name(p, packet.data(), (int)packet.size(), &name, &enclen);
+ if (rc != ARES_SUCCESS) {
+ ss << "(error from ares_expand_name)";
+ break;
+ }
+ ss << " '" << name << "'";
+ ares_free_string(name);
+ p += enclen;
+ rc = ares_expand_name(p, packet.data(), (int)packet.size(), &name, &enclen);
+ if (rc != ARES_SUCCESS) {
+ ss << "(error from ares_expand_name)";
+ break;
+ }
+ ss << " '" << name << "'";
+ ares_free_string(name);
+ p += enclen;
+ if ((p + 20) <= (*data + rdatalen)) {
+ unsigned long serial = DNS__32BIT(p);
+ unsigned long refresh = DNS__32BIT(p + 4);
+ unsigned long retry = DNS__32BIT(p + 8);
+ unsigned long expire = DNS__32BIT(p + 12);
+ unsigned long minimum = DNS__32BIT(p + 16);
+ ss << " " << serial << " " << refresh << " " << retry << " " << expire << " " << minimum;
+ } else {
+ ss << "(RR too short)";
+ }
+ break;
+ }
+ case T_NAPTR: {
+ if (rdatalen > 7) {
+ const byte* p = *data;
+ unsigned long order = DNS__16BIT(p);
+ unsigned long pref = DNS__16BIT(p + 2);
+ p += 4;
+ ss << order << " " << pref;
+
+ int len = *p++;
+ std::string flags(p, p + len);
+ ss << " " << flags;
+ p += len;
+
+ len = *p++;
+ std::string service(p, p + len);
+ ss << " '" << service << "'";
+ p += len;
+
+ len = *p++;
+ std::string regexp(p, p + len);
+ ss << " '" << regexp << "'";
+ p += len;
+
+ int rc = ares_expand_name(p, packet.data(), (int)packet.size(), &name, &enclen);
+ if (rc != ARES_SUCCESS) {
+ ss << "(error from ares_expand_name)";
+ break;
+ }
+ ss << " '" << name << "'";
+ ares_free_string(name);
+ } else {
+ ss << "(RR too short)";
+ }
+ break;
+ }
+ default:
+ ss << " " << HexDump(*data, rdatalen);
+ break;
+ }
+ }
+ *data += rdatalen;
+ *len -= rdatalen;
+
+ ss << "}";
+ return ss.str();
+}
+
+void PushInt32(std::vector<byte>* data, int value) {
+ data->push_back((byte)(((unsigned int)value & 0xff000000) >> 24));
+ data->push_back((byte)(((unsigned int)value & 0x00ff0000) >> 16));
+ data->push_back((byte)(((unsigned int)value & 0x0000ff00) >> 8));
+ data->push_back((byte)(value & 0x000000ff));
+}
+
+void PushInt16(std::vector<byte>* data, int value) {
+ data->push_back((byte)((value & 0xff00) >> 8));
+ data->push_back((byte)value & 0x00ff);
+}
+
+std::vector<byte> EncodeString(const std::string& name) {
+ std::vector<byte> data;
+ std::stringstream ss(name);
+ std::string label;
+ // TODO: cope with escapes
+ while (std::getline(ss, label, '.')) {
+ /* Label length of 0 indicates the end, and we always push an end
+ * terminator, so don't do it twice */
+ if (label.length() == 0)
+ break;
+ data.push_back((byte)label.length());
+ data.insert(data.end(), label.begin(), label.end());
+ }
+ data.push_back(0);
+ return data;
+}
+
+std::vector<byte> DNSQuestion::data() const {
+ std::vector<byte> data;
+ std::vector<byte> encname = EncodeString(name_);
+ data.insert(data.end(), encname.begin(), encname.end());
+ PushInt16(&data, rrtype_);
+ PushInt16(&data, qclass_);
+ return data;
+}
+
+std::vector<byte> DNSRR::data() const {
+ std::vector<byte> data = DNSQuestion::data();
+ PushInt32(&data, ttl_);
+ return data;
+}
+
+std::vector<byte> DNSSingleNameRR::data() const {
+ std::vector<byte> data = DNSRR::data();
+ std::vector<byte> encname = EncodeString(other_);
+ int len = (int)encname.size();
+ PushInt16(&data, len);
+ data.insert(data.end(), encname.begin(), encname.end());
+ return data;
+}
+
+std::vector<byte> DNSTxtRR::data() const {
+ std::vector<byte> data = DNSRR::data();
+ int len = 0;
+ for (const std::string& txt : txt_) {
+ len += (1 + (int)txt.size());
+ }
+ PushInt16(&data, len);
+ for (const std::string& txt : txt_) {
+ data.push_back((byte)txt.size());
+ data.insert(data.end(), txt.begin(), txt.end());
+ }
+ return data;
+}
+
+std::vector<byte> DNSMxRR::data() const {
+ std::vector<byte> data = DNSRR::data();
+ std::vector<byte> encname = EncodeString(other_);
+ int len = 2 + (int)encname.size();
+ PushInt16(&data, len);
+ PushInt16(&data, pref_);
+ data.insert(data.end(), encname.begin(), encname.end());
+ return data;
+}
+
+std::vector<byte> DNSSrvRR::data() const {
+ std::vector<byte> data = DNSRR::data();
+ std::vector<byte> encname = EncodeString(target_);
+ int len = 6 + (int)encname.size();
+ PushInt16(&data, len);
+ PushInt16(&data, prio_);
+ PushInt16(&data, weight_);
+ PushInt16(&data, port_);
+ data.insert(data.end(), encname.begin(), encname.end());
+ return data;
+}
+
+std::vector<byte> DNSUriRR::data() const {
+ std::vector<byte> data = DNSRR::data();
+ int len = 4 + (int)target_.size();
+ PushInt16(&data, len);
+ PushInt16(&data, prio_);
+ PushInt16(&data, weight_);
+ data.insert(data.end(), target_.begin(), target_.end());
+ return data;
+}
+
+std::vector<byte> DNSAddressRR::data() const {
+ std::vector<byte> data = DNSRR::data();
+ int len = (int)addr_.size();
+ PushInt16(&data, len);
+ data.insert(data.end(), addr_.begin(), addr_.end());
+ return data;
+}
+
+std::vector<byte> DNSSoaRR::data() const {
+ std::vector<byte> data = DNSRR::data();
+ std::vector<byte> encname1 = EncodeString(nsname_);
+ std::vector<byte> encname2 = EncodeString(rname_);
+ int len = (int)encname1.size() + (int)encname2.size() + 5*4;
+ PushInt16(&data, len);
+ data.insert(data.end(), encname1.begin(), encname1.end());
+ data.insert(data.end(), encname2.begin(), encname2.end());
+ PushInt32(&data, serial_);
+ PushInt32(&data, refresh_);
+ PushInt32(&data, retry_);
+ PushInt32(&data, expire_);
+ PushInt32(&data, minimum_);
+ return data;
+}
+
+std::vector<byte> DNSOptRR::data() const {
+ std::vector<byte> data = DNSRR::data();
+ int len = 0;
+ for (const DNSOption& opt : opts_) {
+ len += (4 + (int)opt.data_.size());
+ }
+ PushInt16(&data, len);
+ for (const DNSOption& opt : opts_) {
+ PushInt16(&data, opt.code_);
+ PushInt16(&data, (int)opt.data_.size());
+ data.insert(data.end(), opt.data_.begin(), opt.data_.end());
+ }
+ return data;
+}
+
+std::vector<byte> DNSNaptrRR::data() const {
+ std::vector<byte> data = DNSRR::data();
+ std::vector<byte> encname = EncodeString(replacement_);
+ int len = (4 + 1 + (int)flags_.size() + 1 + (int)service_.size() + 1 + (int)regexp_.size() + (int)encname.size());
+ PushInt16(&data, len);
+ PushInt16(&data, order_);
+ PushInt16(&data, pref_);
+ data.push_back((byte)flags_.size());
+ data.insert(data.end(), flags_.begin(), flags_.end());
+ data.push_back((byte)service_.size());
+ data.insert(data.end(), service_.begin(), service_.end());
+ data.push_back((byte)regexp_.size());
+ data.insert(data.end(), regexp_.begin(), regexp_.end());
+ data.insert(data.end(), encname.begin(), encname.end());
+ return data;
+}
+
+std::vector<byte> DNSPacket::data() const {
+ std::vector<byte> data;
+ PushInt16(&data, qid_);
+ byte b = 0x00;
+ if (response_) b |= 0x80;
+ b |= ((opcode_ & 0x0f) << 3);
+ if (aa_) b |= 0x04;
+ if (tc_) b |= 0x02;
+ if (rd_) b |= 0x01;
+ data.push_back(b);
+ b = 0x00;
+ if (ra_) b |= 0x80;
+ if (z_) b |= 0x40;
+ if (ad_) b |= 0x20;
+ if (cd_) b |= 0x10;
+ b |= (rcode_ & 0x0f);
+ data.push_back(b);
+
+ int count = (int)questions_.size();
+ PushInt16(&data, count);
+ count = (int)answers_.size();
+ PushInt16(&data, count);
+ count = (int)auths_.size();
+ PushInt16(&data, count);
+ count = (int)adds_.size();
+ PushInt16(&data, count);
+
+ for (const std::unique_ptr<DNSQuestion>& question : questions_) {
+ std::vector<byte> qdata = question->data();
+ data.insert(data.end(), qdata.begin(), qdata.end());
+ }
+ for (const std::unique_ptr<DNSRR>& rr : answers_) {
+ std::vector<byte> rrdata = rr->data();
+ data.insert(data.end(), rrdata.begin(), rrdata.end());
+ }
+ for (const std::unique_ptr<DNSRR>& rr : auths_) {
+ std::vector<byte> rrdata = rr->data();
+ data.insert(data.end(), rrdata.begin(), rrdata.end());
+ }
+ for (const std::unique_ptr<DNSRR>& rr : adds_) {
+ std::vector<byte> rrdata = rr->data();
+ data.insert(data.end(), rrdata.begin(), rrdata.end());
+ }
+ return data;
+}
+
+} // namespace ares
diff --git a/subprojects/c-ares/test/dns-proto.h b/subprojects/c-ares/test/dns-proto.h
@@ -0,0 +1,392 @@
+// -*- mode: c++ -*-
+/*
+ * Copyright (C) The c-ares project
+ *
+ * Permission to use, copy, modify, and distribute this
+ * software and its documentation for any purpose and without
+ * fee is hereby granted, provided that the above copyright
+ * notice appear in all copies and that both that copyright
+ * notice and this permission notice appear in supporting
+ * documentation, and that the name of M.I.T. not be used in
+ * advertising or publicity pertaining to distribution of the
+ * software without specific, written prior permission.
+ * M.I.T. makes no representations about the suitability of
+ * this software for any purpose. It is provided "as is"
+ * without express or implied warranty.
+ *
+ * SPDX-License-Identifier: MIT
+ */
+#ifndef DNS_PROTO_H
+#define DNS_PROTO_H
+// Utilities for processing DNS packet contents
+
+#include "ares_setup.h"
+#include "ares.h"
+// Include ares internal file for DNS protocol constants
+#include "ares_nameser.h"
+
+#include <memory>
+#include <string>
+#include <vector>
+
+namespace ares {
+
+typedef unsigned char byte;
+
+std::string HexDump(std::vector<byte> data);
+std::string HexDump(const byte *data, int len);
+std::string HexDump(const char *data, int len);
+
+std::string StatusToString(int status);
+std::string RcodeToString(int rcode);
+std::string RRTypeToString(int rrtype);
+std::string ClassToString(int qclass);
+std::string AddressToString(const void *addr, int len);
+
+// Convert DNS protocol data to strings.
+// Note that these functions are not defensive; they assume
+// a validly formatted input, and so should not be used on
+// externally-determined inputs.
+std::string PacketToString(const std::vector<byte> &packet);
+std::string QuestionToString(const std::vector<byte> &packet, const byte **data,
+ int *len);
+std::string RRToString(const std::vector<byte> &packet, const byte **data,
+ int *len);
+
+
+// Manipulate DNS protocol data.
+void PushInt32(std::vector<byte> *data, int value);
+void PushInt16(std::vector<byte> *data, int value);
+std::vector<byte> EncodeString(const std::string &name);
+
+struct DNSQuestion {
+ DNSQuestion(const std::string &name, int rrtype, int qclass)
+ : name_(name), rrtype_(rrtype), qclass_(qclass)
+ {
+ }
+
+ DNSQuestion(const std::string &name, int rrtype)
+ : name_(name), rrtype_(rrtype), qclass_(C_IN)
+ {
+ }
+
+ virtual ~DNSQuestion()
+ {
+ }
+
+ virtual std::vector<byte> data() const;
+ std::string name_;
+ int rrtype_;
+ int qclass_;
+};
+
+struct DNSRR : public DNSQuestion {
+ DNSRR(const std::string &name, int rrtype, int qclass, int ttl)
+ : DNSQuestion(name, rrtype, qclass), ttl_(ttl)
+ {
+ }
+
+ DNSRR(const std::string &name, int rrtype, int ttl)
+ : DNSQuestion(name, rrtype), ttl_(ttl)
+ {
+ }
+
+ virtual ~DNSRR()
+ {
+ }
+
+ virtual std::vector<byte> data() const = 0;
+ int ttl_;
+};
+
+struct DNSAddressRR : public DNSRR {
+ DNSAddressRR(const std::string &name, int rrtype, int ttl, const byte *addr,
+ int addrlen)
+ : DNSRR(name, rrtype, ttl), addr_(addr, addr + addrlen)
+ {
+ }
+
+ DNSAddressRR(const std::string &name, int rrtype, int ttl,
+ const std::vector<byte> &addr)
+ : DNSRR(name, rrtype, ttl), addr_(addr)
+ {
+ }
+
+ virtual std::vector<byte> data() const;
+ std::vector<byte> addr_;
+};
+
+struct DNSARR : public DNSAddressRR {
+ DNSARR(const std::string &name, int ttl, const byte *addr, int addrlen)
+ : DNSAddressRR(name, T_A, ttl, addr, addrlen)
+ {
+ }
+
+ DNSARR(const std::string &name, int ttl, const std::vector<byte> &addr)
+ : DNSAddressRR(name, T_A, ttl, addr)
+ {
+ }
+};
+
+struct DNSAaaaRR : public DNSAddressRR {
+ DNSAaaaRR(const std::string &name, int ttl, const byte *addr, int addrlen)
+ : DNSAddressRR(name, T_AAAA, ttl, addr, addrlen)
+ {
+ }
+
+ DNSAaaaRR(const std::string &name, int ttl, const std::vector<byte> &addr)
+ : DNSAddressRR(name, T_AAAA, ttl, addr)
+ {
+ }
+};
+
+struct DNSSingleNameRR : public DNSRR {
+ DNSSingleNameRR(const std::string &name, int rrtype, int ttl,
+ const std::string &other)
+ : DNSRR(name, rrtype, ttl), other_(other)
+ {
+ }
+
+ virtual std::vector<byte> data() const;
+ std::string other_;
+};
+
+struct DNSCnameRR : public DNSSingleNameRR {
+ DNSCnameRR(const std::string &name, int ttl, const std::string &other)
+ : DNSSingleNameRR(name, T_CNAME, ttl, other)
+ {
+ }
+};
+
+struct DNSNsRR : public DNSSingleNameRR {
+ DNSNsRR(const std::string &name, int ttl, const std::string &other)
+ : DNSSingleNameRR(name, T_NS, ttl, other)
+ {
+ }
+};
+
+struct DNSPtrRR : public DNSSingleNameRR {
+ DNSPtrRR(const std::string &name, int ttl, const std::string &other)
+ : DNSSingleNameRR(name, T_PTR, ttl, other)
+ {
+ }
+};
+
+struct DNSTxtRR : public DNSRR {
+ DNSTxtRR(const std::string &name, int ttl,
+ const std::vector<std::string> &txt)
+ : DNSRR(name, T_TXT, ttl), txt_(txt)
+ {
+ }
+
+ virtual std::vector<byte> data() const;
+ std::vector<std::string> txt_;
+};
+
+struct DNSMxRR : public DNSRR {
+ DNSMxRR(const std::string &name, int ttl, int pref, const std::string &other)
+ : DNSRR(name, T_MX, ttl), pref_(pref), other_(other)
+ {
+ }
+
+ virtual std::vector<byte> data() const;
+ int pref_;
+ std::string other_;
+};
+
+struct DNSSrvRR : public DNSRR {
+ DNSSrvRR(const std::string &name, int ttl, int prio, int weight, int port,
+ const std::string &target)
+ : DNSRR(name, T_SRV, ttl), prio_(prio), weight_(weight), port_(port),
+ target_(target)
+ {
+ }
+
+ virtual std::vector<byte> data() const;
+ int prio_;
+ int weight_;
+ int port_;
+ std::string target_;
+};
+
+struct DNSUriRR : public DNSRR {
+ DNSUriRR(const std::string &name, int ttl, int prio, int weight,
+ const std::string &target)
+ : DNSRR(name, T_URI, ttl), prio_(prio), weight_(weight), target_(target)
+ {
+ }
+
+ virtual std::vector<byte> data() const;
+ int prio_;
+ int weight_;
+ std::string target_;
+};
+
+struct DNSSoaRR : public DNSRR {
+ DNSSoaRR(const std::string &name, int ttl, const std::string &nsname,
+ const std::string &rname, int serial, int refresh, int retry,
+ int expire, int minimum)
+ : DNSRR(name, T_SOA, ttl), nsname_(nsname), rname_(rname), serial_(serial),
+ refresh_(refresh), retry_(retry), expire_(expire), minimum_(minimum)
+ {
+ }
+
+ virtual std::vector<byte> data() const;
+ std::string nsname_;
+ std::string rname_;
+ int serial_;
+ int refresh_;
+ int retry_;
+ int expire_;
+ int minimum_;
+};
+
+struct DNSNaptrRR : public DNSRR {
+ DNSNaptrRR(const std::string &name, int ttl, int order, int pref,
+ const std::string &flags, const std::string &service,
+ const std::string ®exp, const std::string &replacement)
+ : DNSRR(name, T_NAPTR, ttl), order_(order), pref_(pref), flags_(flags),
+ service_(service), regexp_(regexp), replacement_(replacement)
+ {
+ }
+
+ virtual std::vector<byte> data() const;
+ int order_;
+ int pref_;
+ std::string flags_;
+ std::string service_;
+ std::string regexp_;
+ std::string replacement_;
+};
+
+struct DNSOption {
+ int code_;
+ std::vector<byte> data_;
+};
+
+struct DNSOptRR : public DNSRR {
+ DNSOptRR(int extrcode, int udpsize)
+ : DNSRR("", T_OPT, static_cast<int>(udpsize), extrcode)
+ {
+ }
+
+ virtual std::vector<byte> data() const;
+ std::vector<DNSOption> opts_;
+};
+
+struct DNSPacket {
+ DNSPacket()
+ : qid_(0), response_(false), opcode_(O_QUERY), aa_(false), tc_(false),
+ rd_(false), ra_(false), z_(false), ad_(false), cd_(false), rcode_(NOERROR)
+ {
+ }
+
+ // Convenience functions that take ownership of given pointers.
+ DNSPacket &add_question(DNSQuestion *q)
+ {
+ questions_.push_back(std::unique_ptr<DNSQuestion>(q));
+ return *this;
+ }
+
+ DNSPacket &add_answer(DNSRR *q)
+ {
+ answers_.push_back(std::unique_ptr<DNSRR>(q));
+ return *this;
+ }
+
+ DNSPacket &add_auth(DNSRR *q)
+ {
+ auths_.push_back(std::unique_ptr<DNSRR>(q));
+ return *this;
+ }
+
+ DNSPacket &add_additional(DNSRR *q)
+ {
+ adds_.push_back(std::unique_ptr<DNSRR>(q));
+ return *this;
+ }
+
+ // Chainable setters.
+ DNSPacket &set_qid(int qid)
+ {
+ qid_ = qid;
+ return *this;
+ }
+
+ DNSPacket &set_response(bool v = true)
+ {
+ response_ = v;
+ return *this;
+ }
+
+ DNSPacket &set_aa(bool v = true)
+ {
+ aa_ = v;
+ return *this;
+ }
+
+ DNSPacket &set_tc(bool v = true)
+ {
+ tc_ = v;
+ return *this;
+ }
+
+ DNSPacket &set_rd(bool v = true)
+ {
+ rd_ = v;
+ return *this;
+ }
+
+ DNSPacket &set_ra(bool v = true)
+ {
+ ra_ = v;
+ return *this;
+ }
+
+ DNSPacket &set_z(bool v = true)
+ {
+ z_ = v;
+ return *this;
+ }
+
+ DNSPacket &set_ad(bool v = true)
+ {
+ ad_ = v;
+ return *this;
+ }
+
+ DNSPacket &set_cd(bool v = true)
+ {
+ cd_ = v;
+ return *this;
+ }
+
+ DNSPacket &set_rcode(int rcode)
+ {
+ rcode_ = rcode;
+ return *this;
+ }
+
+ // Return the encoded packet.
+ std::vector<byte> data() const;
+
+ int qid_;
+ bool response_;
+ int opcode_;
+ bool aa_;
+ bool tc_;
+ bool rd_;
+ bool ra_;
+ bool z_;
+ bool ad_;
+ bool cd_;
+ int rcode_;
+ std::vector<std::unique_ptr<DNSQuestion>> questions_;
+ std::vector<std::unique_ptr<DNSRR>> answers_;
+ std::vector<std::unique_ptr<DNSRR>> auths_;
+ std::vector<std::unique_ptr<DNSRR>> adds_;
+};
+
+} // namespace ares
+
+#endif
diff --git a/subprojects/c-ares/test/fuzzcheck.sh b/subprojects/c-ares/test/fuzzcheck.sh
@@ -0,0 +1,7 @@
+#!/bin/sh
+# Copyright (C) The c-ares project and its contributors
+# SPDX-License-Identifier: MIT
+set -e
+# Check that all of the base fuzzing corpus parse without errors
+./aresfuzz fuzzinput/*
+./aresfuzzname fuzznames/*
diff --git a/subprojects/c-ares/test/fuzzinput/004a216d3cff18b0c5c6b68b807f1529 b/subprojects/c-ares/test/fuzzinput/004a216d3cff18b0c5c6b68b807f1529
Binary files differ.
diff --git a/subprojects/c-ares/test/fuzzinput/00539467ca159b36aea95e61f9729115 b/subprojects/c-ares/test/fuzzinput/00539467ca159b36aea95e61f9729115
Binary files differ.
diff --git a/subprojects/c-ares/test/fuzzinput/00e846db8f43f2f507cd1666ed5a753e b/subprojects/c-ares/test/fuzzinput/00e846db8f43f2f507cd1666ed5a753e
Binary files differ.
diff --git a/subprojects/c-ares/test/fuzzinput/0177b7566f08c013699eaea9a77abeb3 b/subprojects/c-ares/test/fuzzinput/0177b7566f08c013699eaea9a77abeb3
Binary files differ.
diff --git a/subprojects/c-ares/test/fuzzinput/020a4fa317715bfdb236ed13751e6b65 b/subprojects/c-ares/test/fuzzinput/020a4fa317715bfdb236ed13751e6b65
Binary files differ.
diff --git a/subprojects/c-ares/test/fuzzinput/0310f2e81bea31f4fe3f330872a877dd b/subprojects/c-ares/test/fuzzinput/0310f2e81bea31f4fe3f330872a877dd
Binary files differ.
diff --git a/subprojects/c-ares/test/fuzzinput/0449be67df1730b2d0887d412a9b7cc4 b/subprojects/c-ares/test/fuzzinput/0449be67df1730b2d0887d412a9b7cc4
Binary files differ.
diff --git a/subprojects/c-ares/test/fuzzinput/0449dd14f7aa94bf0d716bfe09b287a8 b/subprojects/c-ares/test/fuzzinput/0449dd14f7aa94bf0d716bfe09b287a8
Binary files differ.
diff --git a/subprojects/c-ares/test/fuzzinput/04c93cdf7208979aa4df80a3a0d5a2d8 b/subprojects/c-ares/test/fuzzinput/04c93cdf7208979aa4df80a3a0d5a2d8
Binary files differ.
diff --git a/subprojects/c-ares/test/fuzzinput/0567e7171e08e75f3f91c4ca74c17adc b/subprojects/c-ares/test/fuzzinput/0567e7171e08e75f3f91c4ca74c17adc
Binary files differ.
diff --git a/subprojects/c-ares/test/fuzzinput/05ba948578a397e9cbc6a7b3e78622fa b/subprojects/c-ares/test/fuzzinput/05ba948578a397e9cbc6a7b3e78622fa
Binary files differ.
diff --git a/subprojects/c-ares/test/fuzzinput/060afe5ed25f3e2e86167e545f27edca b/subprojects/c-ares/test/fuzzinput/060afe5ed25f3e2e86167e545f27edca
Binary files differ.
diff --git a/subprojects/c-ares/test/fuzzinput/06d47d3681493f1b1d41236f460d896f b/subprojects/c-ares/test/fuzzinput/06d47d3681493f1b1d41236f460d896f
Binary files differ.
diff --git a/subprojects/c-ares/test/fuzzinput/0724a810b0e131c2fddb6de9003b9064 b/subprojects/c-ares/test/fuzzinput/0724a810b0e131c2fddb6de9003b9064
Binary files differ.
diff --git a/subprojects/c-ares/test/fuzzinput/0b5279148826f5b962bcf1896bdb4ede b/subprojects/c-ares/test/fuzzinput/0b5279148826f5b962bcf1896bdb4ede
Binary files differ.
diff --git a/subprojects/c-ares/test/fuzzinput/114048c0f6b10bdc67ce9166405d195e b/subprojects/c-ares/test/fuzzinput/114048c0f6b10bdc67ce9166405d195e
Binary files differ.
diff --git a/subprojects/c-ares/test/fuzzinput/11b8464a0ef8735d202955c34c36b0c7 b/subprojects/c-ares/test/fuzzinput/11b8464a0ef8735d202955c34c36b0c7
Binary files differ.
diff --git a/subprojects/c-ares/test/fuzzinput/11cb626f1668c7b41954ce7d768fe528 b/subprojects/c-ares/test/fuzzinput/11cb626f1668c7b41954ce7d768fe528
Binary files differ.
diff --git a/subprojects/c-ares/test/fuzzinput/14b133bf18125b75a1976fa63a1df6b7 b/subprojects/c-ares/test/fuzzinput/14b133bf18125b75a1976fa63a1df6b7
Binary files differ.
diff --git a/subprojects/c-ares/test/fuzzinput/153c6b3afa8faa03c8bc28f936a6d4cf b/subprojects/c-ares/test/fuzzinput/153c6b3afa8faa03c8bc28f936a6d4cf
Binary files differ.
diff --git a/subprojects/c-ares/test/fuzzinput/182cad2a342ed7317b7c21a5d17020d1 b/subprojects/c-ares/test/fuzzinput/182cad2a342ed7317b7c21a5d17020d1
Binary files differ.
diff --git a/subprojects/c-ares/test/fuzzinput/1c61a61bb7057b52c5b15188345a5238 b/subprojects/c-ares/test/fuzzinput/1c61a61bb7057b52c5b15188345a5238
Binary files differ.
diff --git a/subprojects/c-ares/test/fuzzinput/1dbe2cf62ed2e4fa1c3cb473f08710b5 b/subprojects/c-ares/test/fuzzinput/1dbe2cf62ed2e4fa1c3cb473f08710b5
Binary files differ.
diff --git a/subprojects/c-ares/test/fuzzinput/21199be504fcfece5c7096ee0dbba507 b/subprojects/c-ares/test/fuzzinput/21199be504fcfece5c7096ee0dbba507
Binary files differ.
diff --git a/subprojects/c-ares/test/fuzzinput/21891480074b5635dbbe7137bdcabccd b/subprojects/c-ares/test/fuzzinput/21891480074b5635dbbe7137bdcabccd
Binary files differ.
diff --git a/subprojects/c-ares/test/fuzzinput/233aea42e15aa73e131eefabf16088c9 b/subprojects/c-ares/test/fuzzinput/233aea42e15aa73e131eefabf16088c9
Binary files differ.
diff --git a/subprojects/c-ares/test/fuzzinput/24660d4e7ac7aa21d600ea7a3d198bbb b/subprojects/c-ares/test/fuzzinput/24660d4e7ac7aa21d600ea7a3d198bbb
Binary files differ.
diff --git a/subprojects/c-ares/test/fuzzinput/25589deb55c08429345f289d1c9b0254 b/subprojects/c-ares/test/fuzzinput/25589deb55c08429345f289d1c9b0254
Binary files differ.
diff --git a/subprojects/c-ares/test/fuzzinput/2573bd823e4da11f727a17f8e1f35c26 b/subprojects/c-ares/test/fuzzinput/2573bd823e4da11f727a17f8e1f35c26
Binary files differ.
diff --git a/subprojects/c-ares/test/fuzzinput/276f12da56866273e76059ad0e7be97e b/subprojects/c-ares/test/fuzzinput/276f12da56866273e76059ad0e7be97e
Binary files differ.
diff --git a/subprojects/c-ares/test/fuzzinput/29198a2e380cb19babec9e02116d213e b/subprojects/c-ares/test/fuzzinput/29198a2e380cb19babec9e02116d213e
Binary files differ.
diff --git a/subprojects/c-ares/test/fuzzinput/2c94ba9434b1a1b9396fc5364f101363 b/subprojects/c-ares/test/fuzzinput/2c94ba9434b1a1b9396fc5364f101363
Binary files differ.
diff --git a/subprojects/c-ares/test/fuzzinput/2d578c357dc2f5e02dc55cddb30641d1 b/subprojects/c-ares/test/fuzzinput/2d578c357dc2f5e02dc55cddb30641d1
Binary files differ.
diff --git a/subprojects/c-ares/test/fuzzinput/2dff6cc5a223e67fde9e5e79af456992 b/subprojects/c-ares/test/fuzzinput/2dff6cc5a223e67fde9e5e79af456992
Binary files differ.
diff --git a/subprojects/c-ares/test/fuzzinput/2f103b1f9477f2d8934bd84328d51c75 b/subprojects/c-ares/test/fuzzinput/2f103b1f9477f2d8934bd84328d51c75
Binary files differ.
diff --git a/subprojects/c-ares/test/fuzzinput/31cd3a8413de13d9624adbb1613784bf b/subprojects/c-ares/test/fuzzinput/31cd3a8413de13d9624adbb1613784bf
Binary files differ.
diff --git a/subprojects/c-ares/test/fuzzinput/36415bdf1d180098fe6234b4186e69f3 b/subprojects/c-ares/test/fuzzinput/36415bdf1d180098fe6234b4186e69f3
Binary files differ.
diff --git a/subprojects/c-ares/test/fuzzinput/3a04a80f0242e8dff0cd732e7c4767da b/subprojects/c-ares/test/fuzzinput/3a04a80f0242e8dff0cd732e7c4767da
Binary files differ.
diff --git a/subprojects/c-ares/test/fuzzinput/44d0f973b7b0fb3e4a07770c943dcd5a b/subprojects/c-ares/test/fuzzinput/44d0f973b7b0fb3e4a07770c943dcd5a
Binary files differ.
diff --git a/subprojects/c-ares/test/fuzzinput/50bc00daa0ddcd6cfb2b5d9f62c81f47 b/subprojects/c-ares/test/fuzzinput/50bc00daa0ddcd6cfb2b5d9f62c81f47
Binary files differ.
diff --git a/subprojects/c-ares/test/fuzzinput/51ed2d1fb77b3078b54e94e85606b7df b/subprojects/c-ares/test/fuzzinput/51ed2d1fb77b3078b54e94e85606b7df
Binary files differ.
diff --git a/subprojects/c-ares/test/fuzzinput/5c5e0e899cf2e7d053a9e45fb76f6e5a b/subprojects/c-ares/test/fuzzinput/5c5e0e899cf2e7d053a9e45fb76f6e5a
Binary files differ.
diff --git a/subprojects/c-ares/test/fuzzinput/70152ed033f139443fbfb1b858bb3b1b b/subprojects/c-ares/test/fuzzinput/70152ed033f139443fbfb1b858bb3b1b
Binary files differ.
diff --git a/subprojects/c-ares/test/fuzzinput/7030ca2b24e5a7f9dd8f62096a48eb33 b/subprojects/c-ares/test/fuzzinput/7030ca2b24e5a7f9dd8f62096a48eb33
Binary files differ.
diff --git a/subprojects/c-ares/test/fuzzinput/71eec1a0ef2d25bb9e2ef17f23be7e9e b/subprojects/c-ares/test/fuzzinput/71eec1a0ef2d25bb9e2ef17f23be7e9e
Binary files differ.
diff --git a/subprojects/c-ares/test/fuzzinput/7a6b0177210ea4ef40b254daf99393c5 b/subprojects/c-ares/test/fuzzinput/7a6b0177210ea4ef40b254daf99393c5
Binary files differ.
diff --git a/subprojects/c-ares/test/fuzzinput/7f1567733711ffb61839621af0cbfa33 b/subprojects/c-ares/test/fuzzinput/7f1567733711ffb61839621af0cbfa33
Binary files differ.
diff --git a/subprojects/c-ares/test/fuzzinput/850c6d57c5bb7be8205fc2438d14d7e5 b/subprojects/c-ares/test/fuzzinput/850c6d57c5bb7be8205fc2438d14d7e5
Binary files differ.
diff --git a/subprojects/c-ares/test/fuzzinput/a5c8cd2784a5792b9e91c2d7895b3b34 b/subprojects/c-ares/test/fuzzinput/a5c8cd2784a5792b9e91c2d7895b3b34
Binary files differ.
diff --git a/subprojects/c-ares/test/fuzzinput/a9135cdc7151d023300ff194bad90af9 b/subprojects/c-ares/test/fuzzinput/a9135cdc7151d023300ff194bad90af9
Binary files differ.
diff --git a/subprojects/c-ares/test/fuzzinput/af2597e8ac7dec1e8b4a47518312912a b/subprojects/c-ares/test/fuzzinput/af2597e8ac7dec1e8b4a47518312912a
Binary files differ.
diff --git a/subprojects/c-ares/test/fuzzinput/answer_a b/subprojects/c-ares/test/fuzzinput/answer_a
Binary files differ.
diff --git a/subprojects/c-ares/test/fuzzinput/answer_aaaa b/subprojects/c-ares/test/fuzzinput/answer_aaaa
Binary files differ.
diff --git a/subprojects/c-ares/test/fuzzinput/b3f53ef826b831bb09dd25c7f5960249 b/subprojects/c-ares/test/fuzzinput/b3f53ef826b831bb09dd25c7f5960249
Binary files differ.
diff --git a/subprojects/c-ares/test/fuzzinput/cda0f8751f5c4993974c2b549d29bcc8 b/subprojects/c-ares/test/fuzzinput/cda0f8751f5c4993974c2b549d29bcc8
Binary files differ.
diff --git a/subprojects/c-ares/test/fuzzinput/ce6c26c0e469339873d0e7f616ab0945 b/subprojects/c-ares/test/fuzzinput/ce6c26c0e469339873d0e7f616ab0945
Binary files differ.
diff --git a/subprojects/c-ares/test/fuzzinput/clusterfuzz-5637790584012800 b/subprojects/c-ares/test/fuzzinput/clusterfuzz-5637790584012800
Binary files differ.
diff --git a/subprojects/c-ares/test/fuzzinput/clusterfuzz-5650695891451904 b/subprojects/c-ares/test/fuzzinput/clusterfuzz-5650695891451904
Binary files differ.
diff --git a/subprojects/c-ares/test/fuzzinput/clusterfuzz-5651369832218624 b/subprojects/c-ares/test/fuzzinput/clusterfuzz-5651369832218624
Binary files differ.
diff --git a/subprojects/c-ares/test/fuzzinput/clusterfuzz-5674462260756480 b/subprojects/c-ares/test/fuzzinput/clusterfuzz-5674462260756480
Binary files differ.
diff --git a/subprojects/c-ares/test/fuzzinput/clusterfuzz-5680630672654336 b/subprojects/c-ares/test/fuzzinput/clusterfuzz-5680630672654336
Binary files differ.
diff --git a/subprojects/c-ares/test/fuzzinput/clusterfuzz-5683497160671232 b/subprojects/c-ares/test/fuzzinput/clusterfuzz-5683497160671232
Binary files differ.
diff --git a/subprojects/c-ares/test/fuzzinput/clusterfuzz-5687310655422464 b/subprojects/c-ares/test/fuzzinput/clusterfuzz-5687310655422464
Binary files differ.
diff --git a/subprojects/c-ares/test/fuzzinput/clusterfuzz-5695341573177344 b/subprojects/c-ares/test/fuzzinput/clusterfuzz-5695341573177344
Binary files differ.
diff --git a/subprojects/c-ares/test/fuzzinput/clusterfuzz-5697835103682560 b/subprojects/c-ares/test/fuzzinput/clusterfuzz-5697835103682560
Binary files differ.
diff --git a/subprojects/c-ares/test/fuzzinput/clusterfuzz-5728518081609728 b/subprojects/c-ares/test/fuzzinput/clusterfuzz-5728518081609728
Binary files differ.
diff --git a/subprojects/c-ares/test/fuzzinput/clusterfuzz-5732960017317888 b/subprojects/c-ares/test/fuzzinput/clusterfuzz-5732960017317888
Binary files differ.
diff --git a/subprojects/c-ares/test/fuzzinput/e4dd7e7c2dd4ed7c2e17a6af5d04f9c9 b/subprojects/c-ares/test/fuzzinput/e4dd7e7c2dd4ed7c2e17a6af5d04f9c9
Binary files differ.
diff --git a/subprojects/c-ares/test/fuzzinput/ed50ed8ee36230a5a69746ad830437e5 b/subprojects/c-ares/test/fuzzinput/ed50ed8ee36230a5a69746ad830437e5
Binary files differ.
diff --git a/subprojects/c-ares/test/fuzzinput/f1b900d50806021953321c3b604ee497 b/subprojects/c-ares/test/fuzzinput/f1b900d50806021953321c3b604ee497
Binary files differ.
diff --git a/subprojects/c-ares/test/fuzzinput/f6606f624be8c628328cea01d2cd07a9 b/subprojects/c-ares/test/fuzzinput/f6606f624be8c628328cea01d2cd07a9
Binary files differ.
diff --git a/subprojects/c-ares/test/fuzzinput/f89f6c8176b564a7dd646f14305573ce b/subprojects/c-ares/test/fuzzinput/f89f6c8176b564a7dd646f14305573ce
Binary files differ.
diff --git a/subprojects/c-ares/test/fuzzinput/f9ad508d2dbd08d3aaaabc7d1174677d b/subprojects/c-ares/test/fuzzinput/f9ad508d2dbd08d3aaaabc7d1174677d
Binary files differ.
diff --git a/subprojects/c-ares/test/fuzzinput/multi-indir b/subprojects/c-ares/test/fuzzinput/multi-indir
Binary files differ.
diff --git a/subprojects/c-ares/test/fuzznames/name01 b/subprojects/c-ares/test/fuzznames/name01
@@ -0,0 +1 @@
+normal.name
+\ No newline at end of file
diff --git a/subprojects/c-ares/test/fuzznames/name02 b/subprojects/c-ares/test/fuzznames/name02
@@ -0,0 +1 @@
+singlelabel
+\ No newline at end of file
diff --git a/subprojects/c-ares/test/fuzznames/name03 b/subprojects/c-ares/test/fuzznames/name03
@@ -0,0 +1 @@
+www.labelismuchtoolong012345678901234567890123456789012345678901234567890123456789.com
diff --git a/subprojects/c-ares/test/fuzznames/name04 b/subprojects/c-ares/test/fuzznames/name04
@@ -0,0 +1 @@
+labelwithescaped\.dot.dot
+\ No newline at end of file
diff --git a/subprojects/c-ares/test/fuzznames/name05 b/subprojects/c-ares/test/fuzznames/name05
@@ -0,0 +1 @@
+escaped.dot.at.end\.
+\ No newline at end of file
diff --git a/subprojects/c-ares/test/fuzznames/name06 b/subprojects/c-ares/test/fuzznames/name06
@@ -0,0 +1 @@
+absolute.name.
+\ No newline at end of file
diff --git a/subprojects/c-ares/test/fuzznames/name07 b/subprojects/c-ares/test/fuzznames/name07
@@ -0,0 +1 @@
+empty..label
+\ No newline at end of file
diff --git a/subprojects/c-ares/test/fuzznames/name08 b/subprojects/c-ares/test/fuzznames/name08
@@ -0,0 +1 @@
+utf8.££.data.com
+\ No newline at end of file
diff --git a/subprojects/c-ares/test/fuzznames/name09 b/subprojects/c-ares/test/fuzznames/name09
@@ -0,0 +1 @@
+astral.plane.utf8.name.𐀀.org
+\ No newline at end of file
