c-ares/1.28.1

A C library for asynchronous DNS requests
Recipe info
2024-03-31

Available packages
Linux
Windows
macOS
macOS Apple Silicon

Install
Add the following line to your conanfile.txt:
[requires]
c-ares/1.28.1

Using c-ares

Note

If you are a new Conan user, we recommend reading the how to consume packages tutorial.

If you need additional assistance, please ask a question in the Conan Center Index repository.

Simplest use case consuming this recipe and assuming CMake as your local build tool:

[requires]
c-ares/1.28.1
[generators]
CMakeDeps
CMakeToolchain
[layout]
cmake_layout
from conan import ConanFile
from conan.tools.cmake import cmake_layout


class ExampleRecipe(ConanFile):
    settings = "os", "compiler", "build_type", "arch"
    generators = "CMakeDeps", "CMakeToolchain"

    def requirements(self):
        self.requires("c-ares/1.28.1")

    def layout(self):
        cmake_layout(self)

Now, you can run this Conan command to locally install (and build if necessary) this recipe and its dependencies (if any):

$ conan install conanfile.txt --build=missing

Useful information to take into account to consume this library:


These are the main declared targets:

  • CMake package name(s): c-ares
  • CMake target name(s): c-ares::cares
  • cares => c-ares::cares
    
  • pkg-config file name(s): libcares.pc
  • cares => libcares.pc
    

A simple use case using the CMake file name and the global target:

# ...
find_package(c-ares REQUIRED)
# ...
target_link_libraries(YOUR_TARGET c-ares::cares)

These are all the available headers. Some of these ones might be non-public; make sure of it by visiting the c-ares homepage listed above:

#include "ares.h"
#include "ares_build.h"
#include "ares_dns.h"
#include "ares_dns_record.h"
#include "ares_nameser.h"
#include "ares_rules.h"
#include "ares_version.h"