ARES_THREADSAFETY

Section: C Library Functions (3)
Updated: 26 November 2023
Index Return to Main Contents

---

 

NAME

ares_threadsafety - Query if -ares was built with threa-safety  

SYNOPSIS

#include <ares.h>

ares_bool_t ares_threadsafety(void);

 

DESCRIPTION

The ares_threadsafety(3) function returns if the library was built with thread safety enabled or not.

As of -ares 1.23.0, this simply means that every public function which references an ares_channel_t 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.

As of -ares 1.26.0, this also indicates if ARES_OPT_EVENT_THREAD can be passed to ares_init_options(3).

 

RETURN VALUES

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

ARES_TRUE

Built with thread safety.

ARES_FALSE

Built without thread safety

 

AVAILABILITY

This function was first introduced in -ares version 1.23.0.  

SEE ALSO

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

---

 

Index

NAME

SYNOPSIS

DESCRIPTION

RETURN VALUES

AVAILABILITY

SEE ALSO