ares_reinit - Man Page

ReInitialize a resolver channel from system configuration.


#include <ares.h>

int ares_reinit(ares_channel_t *channel)


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:


Initialization succeeded.


A configuration file could not be read.


The process's available memory was exhausted.


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)


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

Referenced By


12 November 2023