NAME

       ares_reinit - ReInitialize a resolver channel from system configuration.

SYNOPSIS

       #include <ares.h>

       int ares_reinit(ares_channel_t *channel)

DESCRIPTION

       The ares_reinit(3) 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
       ares_init_options(3) or ares_set_servers(3).

       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.

RETURN VALUES

       ares_reinit(3) can return any of the following values:

       ARES_SUCCESS  Initialization succeeded.

       ARES_EFILE    A configuration file could not be read.

       ARES_ENOMEM   The process's available memory was exhausted.

AVAILABILITY

       This function was first introduced in c-ares version 1.22.0.

SEE ALSO

       ares_init(3),      ares_init_options(3),      ares_destroy(3),     ares_dup(3),     ares_library_init(3),
       ares_set_servers(3), ares_threadsafety(3)

AUTHOR

       Copyright (C) 2023 The c-ares project and its members.

                                                12 November 2023                                  ARES_REINIT(3)