Home | History | Annotate | Download | only in private
      1 /*
      2  * Copyright (C) 2011 The Android Open Source Project
      3  * All rights reserved.
      4  *
      5  * Redistribution and use in source and binary forms, with or without
      6  * modification, are permitted provided that the following conditions
      7  * are met:
      8  *  * Redistributions of source code must retain the above copyright
      9  *    notice, this list of conditions and the following disclaimer.
     10  *  * Redistributions in binary form must reproduce the above copyright
     11  *    notice, this list of conditions and the following disclaimer in
     12  *    the documentation and/or other materials provided with the
     13  *    distribution.
     14  *
     15  * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
     16  * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
     17  * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS
     18  * FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE
     19  * COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT,
     20  * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING,
     21  * BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS
     22  * OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED
     23  * AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
     24  * OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT
     25  * OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
     26  * SUCH DAMAGE.
     27  */
     28 #ifndef _RESOLV_IFACE_H
     29 #define _RESOLV_IFACE_H
     30 
     31 /* This header contains declarations related to per-interface DNS
     32  * server selection. They are used by system/netd/ and should not be
     33  * exposed by the C library's public NDK headers.
     34  *
     35  * NOTE: <resolv.h> contains the same declarations, this will be removed
     36  *        when we change system/netd to use this header instead.
     37  */
     38 #include <sys/cdefs.h>
     39 #include <netinet/in.h>
     40 
     41 __BEGIN_DECLS
     42 
     43 /* Use a guard macro until we remove the same definitions from <resolv.h> */
     44 #ifndef _BIONIC_RESOLV_IFACE_FUNCTIONS_DECLARED
     45 #define _BIONIC_RESOLV_IFACE_FUNCTIONS_DECLARED
     46 
     47 /* Set name of default interface */
     48 extern void _resolv_set_default_iface(const char* ifname);
     49 
     50 /* set name servers for an interface */
     51 extern void _resolv_set_nameservers_for_iface(const char* ifname, char** servers, int numservers,
     52         const char *domains);
     53 
     54 /* tell resolver of the address of an interface */
     55 extern void _resolv_set_addr_of_iface(const char* ifname, struct in_addr* addr);
     56 
     57 /* flush the cache associated with the default interface */
     58 extern void _resolv_flush_cache_for_default_iface();
     59 
     60 /* flush the cache associated with a certain interface */
     61 extern void _resolv_flush_cache_for_iface(const char* ifname);
     62 
     63 /* set a pid to use the name servers of the specified interface */
     64 extern void _resolv_set_iface_for_pid(const char* ifname, int pid);
     65 
     66 /* clear pid from being associated with an interface */
     67 extern void _resolv_clear_iface_for_pid(int pid);
     68 
     69 /** Gets the name of the interface to which the pid is attached.
     70  *  On error, -1 is returned.
     71  *  If no interface is found, 0 is returned and buff is set to empty ('\0').
     72  *  If an interface is found, the name is copied to buff and the length of the name is returned.
     73  *  Arguments:   pid The pid to find an interface for
     74  *               buff A buffer to copy the result to
     75  *               buffLen Length of buff. An interface is at most IF_NAMESIZE in length */
     76 extern int _resolv_get_pids_associated_interface(int pid, char* buff, int buffLen);
     77 
     78 #endif /* _BIONIC_RESOLV_IFACE_FUNCTIONS_DECLARED */
     79 
     80 __END_DECLS
     81 
     82 #endif /* _RESOLV_IFACE_H */
     83