NAME

       ares_init - Initialize a resolver channel

SYNOPSIS

       #include <ares.h>

       int ares_init(ares_channel *channelptr)

DESCRIPTION

       The  ares_init(3)  function initializes a communications channel for name service lookups.  If it returns
       successfully, ares_init(3) will set the variable pointed to by channelptr to a handle  used  to  identify
       the  name service channel.  The caller should invoke ares_destroy(3) on the handle when the channel is no
       longer needed.

       The ares_init_options(3) function is provide to offer more init alternatives.

RETURN VALUES

       ares_init(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.

       ARES_ENOTINITIALIZED
                     c-ares library initialization not yet performed.

NOTES

       When initializing from /etc/resolv.conf, ares_init(3) reads the domain and  search  directives  to  allow
       lookups  of  short names relative to the domains specified. The domain and search directives override one
       another. If more that one instance  of  either  domain  or  search  directives  is  specified,  the  last
       occurrence wins. For more information, please see the resolv.conf(5) manual page.

SEE ALSO

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

AUTHOR

       Greg Hudson, MIT Information Systems
       Copyright 1998 by the Massachusetts Institute of Technology.
       Copyright (C) 2004-2010 by Daniel Stenberg.

                                                  5 March 2010                                      ARES_INIT(3)