libc/private/resolv_iface.h

   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, const 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 /* clear the entire mapping of pids to interfaces. */
  70 extern void _resolv_clear_iface_pid_mapping();
  71
  72 /** Gets the name of the interface to which the pid is attached.
  73  *  On error, -1 is returned.
  74  *  If no interface is found, 0 is returned and buff is set to empty ('\0').
  75  *  If an interface is found, the name is copied to buff and the length of the name is returned.
  76  *  Arguments:   pid The pid to find an interface for
  77  *               buff A buffer to copy the result to
  78  *               buffLen Length of buff. An interface is at most IF_NAMESIZE in length */
  79 extern int _resolv_get_pids_associated_interface(int pid, char* buff, int buffLen);
  80
  81
  82 /** set a uid range to use the name servers of the specified interface
  83  *  If [low,high] overlaps with an already existing rule -1 is returned */
  84 extern int _resolv_set_iface_for_uid_range(const char* ifname, int uid_start, int uid_end);
  85
  86 /* clear a uid range from being associated with an interface
  87  * If the range given is not mapped -1 is returned. */
  88 extern int _resolv_clear_iface_for_uid_range(int uid_start, int uid_end);
  89
  90 /* clear the entire mapping of uid ranges to interfaces. */
  91 extern void _resolv_clear_iface_uid_range_mapping();
  92
  93 /** Gets the name of the interface to which the uid is attached.
  94  *  On error, -1 is returned.
  95  *  If no interface is found, 0 is returned and buff is set to empty ('\0').
  96  *  If an interface is found, the name is copied to buff and the length of the name is returned.
  97  *  Arguments:   uid The uid to find an interface for
  98  *               buff A buffer to copy the result to
  99  *               buffLen Length of buff. An interface is at most IF_NAMESIZE in length */
 100 extern int _resolv_get_uids_associated_interface(int uid, char* buff, int buffLen);
 101
 102 #endif /* _BIONIC_RESOLV_IFACE_FUNCTIONS_DECLARED */
 103
 104 __END_DECLS
 105
 106 #endif /* _RESOLV_IFACE_H */