{"id":13418121,"url":"https://github.com/c-ares/c-ares","last_synced_at":"2025-05-13T17:09:23.762Z","repository":{"id":845650,"uuid":"571708","full_name":"c-ares/c-ares","owner":"c-ares","description":"A C library for asynchronous DNS requests","archived":false,"fork":false,"pushed_at":"2025-05-10T14:17:28.000Z","size":9896,"stargazers_count":1957,"open_issues_count":28,"forks_count":626,"subscribers_count":79,"default_branch":"main","last_synced_at":"2025-05-10T15:27:10.789Z","etag":null,"topics":["async","c","dns","dns-queries","library","resolver"],"latest_commit_sha":null,"homepage":"https://c-ares.org/","language":"C","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/c-ares.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE.md","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":"AUTHORS","dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2010-03-20T19:30:23.000Z","updated_at":"2025-05-10T14:30:00.000Z","dependencies_parsed_at":"2023-07-05T20:02:36.353Z","dependency_job_id":"34cfceaf-5766-4c44-a6e2-45d6675c4859","html_url":"https://github.com/c-ares/c-ares","commit_stats":{"total_commits":2642,"total_committers":166,"mean_commits":15.91566265060241,"dds":0.7059046177138532,"last_synced_commit":"5e1c3a7575e458ae51863da9b8d3d5d3ec6ffab8"},"previous_names":[],"tags_count":98,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/c-ares%2Fc-ares","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/c-ares%2Fc-ares/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/c-ares%2Fc-ares/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/c-ares%2Fc-ares/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/c-ares","download_url":"https://codeload.github.com/c-ares/c-ares/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":253990468,"owners_count":21995774,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["async","c","dns","dns-queries","library","resolver"],"created_at":"2024-07-30T22:00:58.677Z","updated_at":"2025-05-13T17:09:18.733Z","avatar_url":"https://github.com/c-ares.png","language":"C","funding_links":[],"categories":["TODO scan for Android support in followings","Networking","C++","C","TODO","内存分配"],"sub_categories":["网络"],"readme":"# [![c-ares logo](https://c-ares.org/art/c-ares-logo.svg)](https://c-ares.org/)\n\n[![Build Status](https://api.cirrus-ci.com/github/c-ares/c-ares.svg?branch=main)](https://cirrus-ci.com/github/c-ares/c-ares)\n[![Windows Build Status](https://ci.appveyor.com/api/projects/status/aevgc5914tm72pvs/branch/main?svg=true)](https://ci.appveyor.com/project/c-ares/c-ares/branch/main)\n[![Coverage Status](https://coveralls.io/repos/github/c-ares/c-ares/badge.svg?branch=main)](https://coveralls.io/github/c-ares/c-ares?branch=main)\n[![CII Best Practices](https://bestpractices.coreinfrastructure.org/projects/291/badge)](https://bestpractices.coreinfrastructure.org/projects/291)\n[![Fuzzing Status](https://oss-fuzz-build-logs.storage.googleapis.com/badges/c-ares.svg)](https://bugs.chromium.org/p/oss-fuzz/issues/list?sort=-opened\u0026can=1\u0026q=proj:c-ares)\n[![Bugs](https://sonarcloud.io/api/project_badges/measure?project=c-ares_c-ares\u0026metric=bugs)](https://sonarcloud.io/summary/new_code?id=c-ares_c-ares)\n[![Coverity Scan Status](https://scan.coverity.com/projects/c-ares/badge.svg)](https://scan.coverity.com/projects/c-ares)\n\n- [Overview](#overview)\n- [Code](#code)\n- [Communication](#communication)\n- [Release Keys](#release-keys)\n  - [Verifying signatures](#verifying-signatures)\n- [Features](#features)\n  - [RFCs and Proposals](#supported-rfcs-and-proposals)\n\n## Overview\n[c-ares](https://c-ares.org) is a modern DNS (stub) resolver library, written in\nC. It provides interfaces for asynchronous queries while trying to abstract the\nintricacies of the underlying DNS protocol.  It was originally intended for\napplications which need to perform DNS queries without blocking, or need to\nperform multiple DNS queries in parallel.\n\nOne of the goals of c-ares is to be a better DNS resolver than is provided by\nyour system, regardless of which system you use.  We recommend using\nthe c-ares library in all network applications even if the initial goal of\nasynchronous resolution is not necessary to your application.\n\nc-ares will build with any C89 compiler and is [MIT licensed](LICENSE.md),\nwhich makes it suitable for both free and commercial software. c-ares runs on\nLinux, FreeBSD, OpenBSD, MacOS, Solaris, AIX, Windows, Android, iOS and many\nmore operating systems.\n\nc-ares has a strong focus on security, implementing safe parsers and data\nbuilders used throughout the code, thus avoiding many of the common pitfalls\nof other C libraries.  Through automated testing with our extensive testing\nframework, c-ares is constantly validated with a range of static and dynamic\nanalyzers, as well as being constantly fuzzed by [OSS Fuzz](https://github.com/google/oss-fuzz).\n\nWhile c-ares has been around for over 20 years, it has been actively maintained\nboth in regards to the latest DNS RFCs as well as updated to follow the latest\nbest practices in regards to C coding standards.\n\n## Code\n\nThe full source code and revision history is available in our\n[GitHub  repository](https://github.com/c-ares/c-ares).  Our signed releases\nare available in the [release archives](https://c-ares.org/download/).\n\n\nSee the [INSTALL.md](INSTALL.md) file for build information.\n\n## Communication\n\n**Issues** and **Feature Requests** should be reported to our\n[GitHub Issues](https://github.com/c-ares/c-ares/issues) page.\n\n**Discussions** around c-ares and its use, are held on\n[GitHub Discussions](https://github.com/c-ares/c-ares/discussions/categories/q-a)\nor the [Mailing List](https://lists.haxx.se/mailman/listinfo/c-ares).  Mailing\nList archive [here](https://lists.haxx.se/pipermail/c-ares/).\nPlease, do not mail volunteers privately about c-ares.\n\n**Security vulnerabilities** are treated according to our\n[Security Procedure](SECURITY.md), please email c-ares-security at\n haxx.se if you suspect one.\n\n\n## Release keys\n\nPrimary GPG keys for c-ares Releasers (some Releasers sign with subkeys):\n\n* **Daniel Stenberg** \u003c\u003cdaniel@haxx.se\u003e\u003e\n  `27EDEAF22F3ABCEB50DB9A125CC908FDB71E12C2`\n* **Brad House** \u003c\u003cbrad@brad-house.com\u003e\u003e\n  `DA7D64E4C82C6294CB73A20E22E3D13B5411B7CA`\n\nTo import the full set of trusted release keys (including subkeys possibly used\nto sign releases):\n\n```bash\ngpg --keyserver hkps://keyserver.ubuntu.com --recv-keys 27EDEAF22F3ABCEB50DB9A125CC908FDB71E12C2 # Daniel Stenberg\ngpg --keyserver hkps://keyserver.ubuntu.com --recv-keys DA7D64E4C82C6294CB73A20E22E3D13B5411B7CA # Brad House\n```\n\n### Verifying signatures\n\nFor each release `c-ares-X.Y.Z.tar.gz` there is a corresponding\n`c-ares-X.Y.Z.tar.gz.asc` file which contains the detached signature for the\nrelease.\n\nAfter fetching all of the possible valid signing keys and loading into your\nkeychain as per the prior section, you can simply run the command below on\nthe downloaded package and detached signature:\n\n```bash\n% gpg -v --verify c-ares-1.29.0.tar.gz.asc c-ares-1.29.0.tar.gz\ngpg: enabled compatibility flags:\ngpg: Signature made Fri May 24 02:50:38 2024 EDT\ngpg:                using RSA key 27EDEAF22F3ABCEB50DB9A125CC908FDB71E12C2\ngpg: using pgp trust model\ngpg: Good signature from \"Daniel Stenberg \u003cdaniel@haxx.se\u003e\" [unknown]\ngpg: WARNING: This key is not certified with a trusted signature!\ngpg:          There is no indication that the signature belongs to the owner.\nPrimary key fingerprint: 27ED EAF2 2F3A BCEB 50DB  9A12 5CC9 08FD B71E 12C2\ngpg: binary signature, digest algorithm SHA512, key algorithm rsa2048\n```\n\n## SLSA Provenance\nThis project generates [SLSA](https://slsa.dev/) provenance for its releases! This enables you to\nverify the integrity of the downloaded artifacts and ensure that the release was\ngenerated from the intended repository.\n\nTo verify the provenance of the release, please follow the instructions [here](https://github.com/slsa-framework/slsa-github-generator#verify-provenance).\n\nExample:\n```\n$ curl -sO https://github.com/c-ares/c-ares/releases/download/v1.34.3/c-ares-1.34.3.intoto.jsonl\n$ curl -sO https://github.com/c-ares/c-ares/releases/download/v1.34.3/c-ares-1.34.3.tar.gz\n$ slsa-verifier verify-artifact c-ares-1.34.3.tar.gz \\\n    --provenance-path c-ares-1.34.3.intoto.jsonl \\\n    --source-uri github.com/c-ares/c-ares \\\n    --source-tag v1.34.3\nVerified signature against tlog entry index 147812470 at URL: https://rekor.sigstore.dev/api/v1/log/entries/108e9186e8c5677a9bfd5bc5181d05ada688a805f9a59cfd082dec27cb6d6567f85b7382eea39dc5\nVerified build using builder \"https://github.com/slsa-framework/slsa-github-generator/.github/workflows/generator_generic_slsa3.yml@refs/tags/v2.0.0\" at commit c29e75d54c3743783d51a609980495cf553b4bca\nVerifying artifact c-ares-1.34.3.tar.gz: PASSED\n\nPASSED: SLSA verification passed\n```\n\n## Features\n\nSee [Features](FEATURES.md)\n\n### Supported RFCs and Proposals\n- [RFC1035](https://datatracker.ietf.org/doc/html/rfc1035).\n  Initial/Base DNS RFC\n- [RFC2671](https://datatracker.ietf.org/doc/html/rfc2671),\n  [RFC6891](https://datatracker.ietf.org/doc/html/rfc6891).\n  EDNS0 option (meta-RR)\n- [RFC3596](https://datatracker.ietf.org/doc/html/rfc3596).\n  IPv6 Address. `AAAA` Record.\n- [RFC2782](https://datatracker.ietf.org/doc/html/rfc2782).\n  Server Selection. `SRV` Record.\n- [RFC3403](https://datatracker.ietf.org/doc/html/rfc3403).\n  Naming Authority Pointer. `NAPTR` Record.\n- [RFC6698](https://datatracker.ietf.org/doc/html/rfc6698).\n  DNS-Based Authentication of Named Entities (DANE) Transport Layer Security (TLS) Protocol.\n  `TLSA` Record.\n- [RFC9460](https://datatracker.ietf.org/doc/html/rfc9460).\n  General Purpose Service Binding, Service Binding type for use with HTTPS.\n  `SVCB` and `HTTPS` Records.\n- [RFC7553](https://datatracker.ietf.org/doc/html/rfc7553).\n  Uniform Resource Identifier. `URI` Record.\n- [RFC6844](https://datatracker.ietf.org/doc/html/rfc6844).\n  Certification Authority Authorization. `CAA` Record.\n- [RFC2535](https://datatracker.ietf.org/doc/html/rfc2535),\n  [RFC2931](https://datatracker.ietf.org/doc/html/rfc2931).\n  `SIG0` Record. Only basic parser, not full implementation.\n- [RFC7873](https://datatracker.ietf.org/doc/html/rfc7873),\n  [RFC9018](https://datatracker.ietf.org/doc/html/rfc9018).\n  DNS Cookie off-path dns poisoning and amplification mitigation.\n- [draft-vixie-dnsext-dns0x20-00](https://datatracker.ietf.org/doc/html/draft-vixie-dnsext-dns0x20-00).\n  DNS 0x20 query name case randomization to prevent cache poisioning attacks.\n- [RFC7686](https://datatracker.ietf.org/doc/html/rfc7686).\n  Reject queries for `.onion` domain names with `NXDOMAIN`.\n- [RFC2606](https://datatracker.ietf.org/doc/html/rfc2606),\n  [RFC6761](https://datatracker.ietf.org/doc/html/rfc6761).\n  Special case treatment for `localhost`/`.localhost`.\n- [RFC2308](https://datatracker.ietf.org/doc/html/rfc2308),\n  [RFC9520](https://datatracker.ietf.org/doc/html/rfc9520).\n  Negative Caching of DNS Resolution Failures.\n- [RFC6724](https://datatracker.ietf.org/doc/html/rfc6724).\n  IPv6 address sorting as used by `ares_getaddrinfo()`.\n- [RFC7413](https://datatracker.ietf.org/doc/html/rfc7413).\n  TCP FastOpen (TFO) for 0-RTT TCP Connection Resumption.\n- [RFC3986](https://datatracker.ietf.org/doc/html/rfc3986).\n  Uniform Resource Identifier (URI). Used for server configuration.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fc-ares%2Fc-ares","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fc-ares%2Fc-ares","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fc-ares%2Fc-ares/lists"}